Configurar una instancia de preparación

Acerca de las instancias de ensayo

GitHub recomienda configurar un entorno independiente para probar copias de seguridad, actualizaciones o cambios en la configuración de tu instancia de GitHub Enterprise Server. Este entorno, que debes aislar de los sistemas de producción, se llama entorno de ensayo.

Por ejemplo, para protegerte contra la pérdida de datos, puedes validar periódicamente la copia de seguridad de la instancia de producción. Puede restaurar periódicamente una copia de seguridad de sus datos de producción en una instancia independiente GitHub Enterprise Server en un entorno de preproducción. En esta instancia de ensayo, también puede probar la actualización a la versión de características más reciente de GitHub Enterprise Server.

Consideraciones para un entorno de pruebas

Para probar y volver a crear GitHub Enterprise Server un entorno tan similar al entorno de producción como sea posible, tenga en cuenta los sistemas externos que interactúan con la instancia. Por ejemplo, puedes probar lo siguiente en el entorno de ensayo.

• Autenticación, especialmente si usas un proveedor de autenticación externo como SAML
• La integración con un sistema externo de gestión de tickets
• La integración con un servidor de integración continua
• Scripts externos o software que utilizan GitHub Enterprise Server APIs
• El servidor externo SMTP para notificaciones por correo electrónico

Configurar una instancia de preparación

Puedes preparar una instancia de almacenamiento provisional desde cero y configurarla instancia como quieras. Para más información, consulta Configuración de una instancia de GitHub Enterprise Server y Configuración de GitHub Enterprise.

Como alternativa, puedes crear una instancia de almacenamiento provisional que refleje la configuración de producción, restaurando ara ello una copia de seguridad de la instancia de producción en la instancia de pruebas.

1. Hacer una copia de seguridad de la instancia de producción
2. Configurar una instancia de almacenamiento provisional
3. Configurar GitHub Actions.
4. Configurar GitHub Packages.
5. Restaurar la copia de seguridad de producción
6. Revisar la configuración de la instancia
7. Aplicar la configuración de la instancia

1. Hacer una copia de seguridad de la instancia de producción

Si desea probar los cambios en una instancia que contenga los mismos datos y configuración que la instancia de producción, realice una copia de seguridad de los datos y la configuración de la instancia de producción mediante GitHub Enterprise Server Backup Utilities. Para más información, consulta Configuración de copias de seguridad en la instancia con utilidades de copia de seguridad.

2. Configurar una instancia de almacenamiento provisional

Configura una nueva instancia para que actúe como tu entorno de preparación. Al seguir el proceso de instalación, asegúrate de seleccionar la opción Nueva instalación. Esto garantizará que el entorno de ensayo se inicialice correctamente y esté listo para restaurar una copia de seguridad si es necesario.

Puedes utilizar las mismas guías para aprovisionar e instalar tu instancia de preparación como hiciste para tu instancia de producción. Para más información, consulta Configuración de una instancia de GitHub Enterprise Server.

Si tienes previsto restaurar una copia de seguridad de la instancia de producción, avanza al siguiente paso. También puedes configurar la instancia manualmente y omitir los pasos siguientes.

3. Configurar GitHub Actions

Opcionalmente, si usa GitHub Actions en la instancia de producción, configure la característica en la instancia de ensayo antes de restaurar la copia de seguridad de producción. Si no usa GitHub Actions, vaya a Configurar GitHub Packages.

Para configurar GitHub Actions en su instancia de ensayo, utilice Consola de administración.

El Consola de administración proporciona una interfaz segura basada en navegador para la configuración de bajo nivel de su instancia de GitHub Enterprise Server, incluida GitHub Actions. Todos los cambios de configuración se auditan y el acceso se protege mediante credenciales dedicadas y controles de red.

1. Acceda a Consola de administración. Consulta Acceso a la Consola de administración.

2. En la barra lateral, abre la pestaña Acciones.

3. Habilite GitHub Actions marcando Habilitar GitHub Actions.

4. Selecciona el proveedor de almacenamiento externo para el almacenamiento de artefactos y registros.

5. Escribe los detalles de autenticación y almacenamiento necesarios para el proveedor elegido.

6. Para probar la configuración, haz clic en Probar configuración de almacenamiento y, a continuación, haz clic en Guardar configuración.

Una vez que haya configurado y habilitado GitHub Actions, continúe con el paso siguiente.

4. Configure GitHub Packages

Opcionalmente, si usa GitHub Packages en la instancia de producción, configure la característica en la instancia de ensayo antes de restaurar la copia de seguridad de producción. Si no usa GitHub Packages, vaya a Restaurar su copia de seguridad de producción.

Para configurar GitHub Packages para la instancia de ensayo:

1. Acceda al Consola de administración. Consulta Obtener acceso a la consola de administración.
2. En la barra lateral, abre la pestaña Paquetes.
3. Para habilitar paquetes de GitHub, active la casilla Enable GitHub Packages.
4. En Configuración de almacenamiento de paquetes, selecciona el proveedor de almacenamiento externo.
5. Para probar la configuración de almacenamiento, haz clic en Probar configuración de almacenamiento.
6. Haz clic en Guardar configuración para aplicar la configuración.

5. Restaurar la copia de seguridad de producción

Usa el comando ghe-restore para restaurar el resto de los datos de la copia de seguridad. Para más información, consulta Configuración de copias de seguridad en la instancia con utilidades de copia de seguridad.

Si la instancia de almacenamiento provisional ya está configurada y quieres sobrescribir la configuración, el certificado y los datos de licencia, agrega la opción -c al comando. Para obtener más información sobre la opción, consulte Uso de los comandos de copia de seguridad y restauración en la GitHub Enterprise Server Backup Utilities documentación.

6. Revisar la configuración de la instancia

Para acceder a la instancia de ensayo con el mismo nombre de host, actualice el archivo de hosts local para resolver el nombre de host de la instancia de almacenamiento provisional por dirección IP editando el archivo /etc/hosts en macOS o Linux, o el archivo C:\Windows\system32\drivers\etc en Windows.

A continuación, revise la configuración de la instancia de ensayo en el Consola de administración. Para más información, consulta Administrar la instancia desde la interfaz del usuario web.

7. Aplicar la configuración de la instancia

Para aplicar la configuración desde Consola de administración, haga clic en Guardar configuración.

Reconexión de una instancia de almacenamiento provisional

Es posible que quiera apagar una instancia de almacenamiento provisional para ahorrar costes y volver a encenderla cuando sea necesario.

Una instancia puede permanecer sin conexión durante 60 días.

Si vuelve a poner la instancia en línea dentro del tiempo de inactividad permitido, GitHub Enterprise Server se instancia correctamente. Si la instancia permanece sin conexión durante más tiempo que el período permitido, GitHub Enterprise Server no puede crear instancias correctamente y puede aparecer un mensaje de error con el texto server has been offline for more than the configured server_rejoin_age_max en los registros del sistema. Consulta Acerca de los registros del sistema.

Si la instancia está bloqueada en estado de error, puede ejecutar estos comandos para recuperarse.

sudo mv /data/user/consul/server_metadata.json /data/user/consul/server_metadata.json.bak
ghe-config-apply

Información adicional

• Acerca de las actualizaciones en los nuevos lanzamientos