Esta guía explica cómo instalar un tema o componente de tema de Discourse desde un repositorio privado de GitHub.
Nivel de usuario requerido: Administrador
Resumen
Esta documentación cubre el proceso de instalación de un tema o componente de tema de Discourse desde un repositorio privado de GitHub. Incluye pasos para generar y usar claves SSH para un acceso seguro. Deberá tener acceso de administrador tanto a su instancia de Discourse como al repositorio de GitHub que está instalando. Así es como puede usar sus propios temas y componentes de tema privados en su foro.
Prerrequisitos
Antes de comenzar, asegúrese de tener:
- Acceso de administrador a su instancia de Discourse
- Un repositorio Git privado que contenga su tema o componente
- Acceso para agregar claves de implementación a su repositorio Git (nivel de administrador/propietario)
Guía paso a paso
- Vaya a su repositorio privado de GitHub y copie la dirección SSH desde la pestaña Clonar SSH.
2. Navegue a su panel de administración de Discourse.
3. En la barra lateral de administración, vaya a
Apariencia > Temas y componentes, luego seleccione la pestaña Temas o Componentes (dependiendo de cuál esté instalando). 4. Haga clic en
Instalar y luego seleccione Desde un repositorio git.
5. Pegue la dirección SSH que copió del repositorio privado en el paso 1. Debe tener el formato:
git@github.com:USUARIO/NOMBRE-DEL-REPOSITORIO.git.
Asegúrese de usar el enlace clonar con SSH, no el que comienza con
https
6. Una clave SSH se genera automáticamente y se muestra en un nuevo cuadro de texto.
7. Haga clic en el ícono de copiar en la esquina superior derecha de ese cuadro para copiar la nueva clave SSH. No haga clic en instalar ni cierre esta ventana modal todavía.
8. Ahora vaya a la configuración de su repositorio privado de GitHub (por ejemplo, en GitHub, vaya a
Configuración > Claves de implementación)
9. Agregue una nueva clave de implementación. Tendrá que darle un título apropiado. Pegue la clave SSH que copió de Discourse en el campo de clave de implementación.
10. Haga clic en
Agregar clave para guardar la clave de implementación en la configuración de su repositorio Git.
11. Regrese a la ventana modal de instalación del tema de Discourse y haga clic en el botón
Instalar. Ahora debería ver la página de configuración de su nuevo tema o componente.
Mejores prácticas
- Utilice siempre la URL SSH para su repositorio, no la URL HTTPS.
- Mantenga sus claves de implementación seguras y no las comparta públicamente.
- Actualice periódicamente su tema o componentes para asegurarse de tener las últimas funciones y actualizaciones de seguridad.
Preguntas frecuentes
P: ¿Puedo usar este método con proveedores de Git distintos de GitHub?
R: Sí, este método debería funcionar con cualquier proveedor de Git que admita claves de implementación o autenticación SSH.
P: ¿Conservará Discourse la clave SSH para futuras actualizaciones?
R: Sí, Discourse almacenará la clave privada generada y la utilizará para acceder al repositorio Git en el futuro.
P: ¿Puedo cambiar el repositorio privado más tarde?
R: Sí, puede actualizar la URL del repositorio en la configuración del tema si es necesario.
Recursos adicionales
Las claves SSH utilizadas en este tema se generaron solo para esta documentación