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. Puedes restaurar periódicamente la copia de seguridad de los datos de producción en una instancia independiente de GitHub Enterprise Server en un entorno de ensayo. En esta instancia de ensayo también puedes probar la versión de actualización de características más reciente de GitHub Enterprise Server.

Consideraciones para un entorno de ensayo

Para probar exhaustivamente GitHub Enterprise Server y volver a crear un entorno que sea lo más parecido posible al entorno de producción, ten 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 vales
• La integración con un servidor de integración continua
• Los scripts externos o el software que usan 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 Configurar una instancia del servidor de GitHub Enterprise y Configurar 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 quieres probar los cambios en una instancia que contiene los mismos datos y configuración que la instancia de producción, haz 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 mediante 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 Configurar una instancia del servidor de GitHub Enterprise.

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 usas GitHub Actions en la instancia de producción, configura la característica en la instancia de almacenamiento provisional antes de restaurar la copia de seguridad de producción. Si no usas GitHub Actions, pasa a 1. Configurar GitHub Packages.

Para configurarGitHub Actions en la instancia de almacenamiento provisional, usa Consola de administración.

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

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

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

3. Habilita GitHub Actions activando 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 hayas configurado y habilitado GitHub Actions, continúa con el paso siguiente.

4. Configurar GitHub Packages

Opcionalmente, si usas GitHub Packages en la instancia de producción, configura la característica en la instancia de almacenamiento provisional antes de restaurar la copia de seguridad de producción. Si no usas GitHub Packages, pasa a 1. Restaurar la copia de seguridad de producción.

Para configurar GitHub Packages para la instancia de almacenamiento provisional:

1. Accede a Consola de administración. Consulta Obtener acceso a la consola de administración.
2. En la barra lateral, abre la pestaña Paquetes.
3. Habilita paquetes de GitHub activando el cuadro Habilitar paquetes de GitHub.
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 mediante 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 esta opción, consulta Uso de los comandos de copia de seguridad y restauración en la documentación de GitHub Enterprise Server Backup Utilities.

6. Revisar la configuración de la instancia

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

Tras ello, revisa la configuración de la instancia de almacenamiento provisional en la 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 la Consola de administración, haz 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 vuelves a poner la instancia en línea dentro del periodo de tiempo sin conexión permitido, GitHub Enterprise Server crea instancias correctamente. Si la instancia permanece sin conexión durante más tiempo que el periodo permitido, GitHub Enterprise Server no crea 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 mejoras a los nuevos lanzamientos