Skip to main content
Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Habilitar y programar el modo de mantenimiento

Algunos procedimientos de mantenimiento estándar, como la actualización tu instancia de GitHub Enterprise Server o la restauración de copias de seguridad, exigen que la instancia esté sin conexión para el uso normal.

Acerca del modo de mantenimiento

Algunos tipos de operaciones exigen que desconectes tu tu instancia de GitHub Enterprise Server y la pongas en modo de mantenimiento:

  • Actualizar a una versión nueva de tu GitHub Enterprise Server
  • Aumentar los recursos de CPU, memoria o almacenamiento asignados a la máquina virtual
  • Migrar datos desde una máquina virtual a otra
  • Restaurar datos desde una instantánea de Utilidades de respaldo del servidor de GitHub Enterprise
  • Solucionar ciertos tipos de problemas críticos de solicitud

Recomendamos que programe una ventana de mantenimiento para, al menos, los siguientes 30 minutos para darle a los usuarios tiempo para prepararse. Cuando está programada una ventana de mantenimiento, todos los usuarios verán un mensaje emergente al acceder al sitio.

Mensaje emergente para el usuario final acerca del mantenimiento programado

Cuando la instancia está en modo de mantenimiento, se rechazan todos los accesos HTTP y Git. Las operaciones de extracción, clonación y subida de Git también se rechazan con un mensaje de error que indica que temporalmente el sitio no se encuentra disponible. Se pausará la replicación de git en las configuraciones de disponibilidad alta. No se ejecutarán los jobs de las Github Actions. Al visitar el sitio desde un navegador aparece una página de mantenimiento.

La pantalla de presentación del modo de mantenimiento

Puedes llevar a cabo una validación inicial de tu operación de mantenimiento si configuras una lista de IP de excepción para permitir el acceso a tu instancia de GitHub Enterprise Server solo desde las direcciones IP y rangos de ellas que proporcionaste. Los intentos para acceder a tu instancia de GitHub Enterprise Server desde las direcciones IP que no se especifican en la lista de excepciones IP recibirán una respuesta consistente con aquellas enviadas cuando la instancia esté en modo de mantenimiento.

Habilitar el modo de mantenimiento de inmediato o programar una ventana de mantenimiento para más tarde

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

    Captura de pantalla del icono de cohete para acceder a los ajustes administrativos

  2. Si aún no estás en la página de "Administrador de sitio", en la esquina inferior izquierda, haz clic en Administrador de sitio.

    Captura de pantalla del enlace de "Administrador de sitio"

  3. En la barra lateral izquierda, haz clic en Consola de administración. pestaña Consola de administración en la barra lateral izquierda

  4. En la parte superior de la Consola de administración, haz clic en Mantenimiento. Pestaña de mantenimiento

  5. En "Habilitar y Programar", decide si habilitas el modo de mantenimiento de inmediato o programas una ventana de mantenimiento para otro momento.

    • Para habilitar el modo de mantenimiento de inmediato, usa el menú desplegable y haz clic en now (ahora). Menú desplegable con la opción para habilitar el modo de mantenimiento ahora seleccionado
    • Para programar una ventana de mantenimiento para otro momento, usa el menú desplegable y haz clic en un horario de inicio. Menú desplegable con la opción para programar una ventana de mantenimiento
  6. Selecciona Habilitar el modo de mantenimiento. Casilla de verificación para habilitar o programar el modo de mantenimiento

  7. Debajo de la barra lateral izquierda, da clic en Guardar configuración.

    Captura de pantalla del botón para guardar los ajustes en la Consola de administración

    Nota: El guardar los ajustes en la Consola de administración restablece los servicios de sistema, lo cual podría dar como resultado un tiempo de inactividad visible.

  8. Espera a que la configuración se ejecute por completo.

    Configurar tu instancia

Validar los cambios en el modo de mantenimiento utilizando la lista de excepciones de IP

La lista de excepciones de IP proporciona un acceso restringido y controlado a tu instancia de GitHub Enterprise Server, el cual es ideal para una validación inicial de la salud del servidor después de una operación de mantenimiento. Una vez que se habilita, tu instancia de GitHub Enterprise Server saldrá del modo de mantenimiento y estará disponible únicamente para las direcciones IP configuradas. La casilla de modo de mantenimiento se actualizará para reflejar el cambio en el estado.

Si vuelves a habilitar el modo de mantenimiento, se inhabilitará la lista de excepción de IP se y tu instancia de GitHub Enterprise Server regresará al modo de mantenimiento. Si simplemente inhabilitas la lista de excepción de IP, tu instancia de GitHub Enterprise Server regresará a su operación normal.

También puedes utilizar una utilidad de línea de comandos para configurar la lista de excepción de IP. Para obtener más información, consulta las secciones "Utilidades de línea de comandos" y "Acceder al shell administrativo (SSH)".

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

    Captura de pantalla del icono de cohete para acceder a los ajustes administrativos

  2. Si aún no estás en la página de "Administrador de sitio", en la esquina inferior izquierda, haz clic en Administrador de sitio.

    Captura de pantalla del enlace de "Administrador de sitio"

  3. En la barra lateral izquierda, haz clic en Consola de administración. pestaña Consola de administración en la barra lateral izquierda

  4. En la parte superior de la Consola de administración, haz clic en Mantenimiento y confirma que el modo de mantenimiento ya esté habilitado. Pestaña de mantenimiento

  5. Selecciona Habilitar la lista de excepción de IP. Casilla de verificación para habilitar la lista de excepción de IP

  6. En la caja de texto, teclea una lista válida de direcciones IP separadas por espacios o bloques de CDIR a los que se les debería permitir el acceso a tu instancia de GitHub Enterprise Server. campo completado para las direcciones IP

  7. Haz clic en Save (guardar). después de que se guarda la lista de excepción de IP

Programar el modo de mantenimiento con las API de GitHub Enterprise Server

Puedes programar el mantenimiento para horarios o días diferentes con las API de GitHub Enterprise Server. Para obtener más información, consulta la sección "Consola de Administración".

Habilitar o inhabilitar el modo de mantenimientos para todos los nodos de una agrupación

Con la herramienta ghe-cluster-maintenance, puedes configurar o anular la configuración del modo de mantenimiento para cada nodo de una agrupación.

$ ghe-cluster-maintenance -h
# Muestra opciones
$ ghe-cluster-maintenance -q
# Consulta el modo actual
$ ghe-cluster-maintenance -s
# Configura el modo de mantenimiento
$ ghe-cluster-maintenance -u
# Anula la configuración del modo de mantenimiento