Skip to main content

Habilitar y programar el modo de mantenimiento

Algunos procedimientos de mantenimiento estándar, como actualizar your GitHub Enterprise Server instance o restaurar copias de seguridad, requieren que la instancia se desconecte para que se pueda usar normalmente.

Acerca del modo de mantenimiento

Para algunos tipos de operaciones es necesario desconectar your GitHub Enterprise Server instance y ponerlo 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 GitHub Enterprise Server Backup Utilities
  • 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. En configuraciones de alta disponibilidad, la replicación de Git se pausará. 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 realizar la validación inicial de la operación de mantenimiento configurando una lista de excepciones IP para permitir el acceso a your GitHub Enterprise Server instance solo desde las direcciones IP y los intervalos proporcionados. Los intentos de acceder a your GitHub Enterprise Server instance desde direcciones IP no especificadas en la lista de excepciones IP recibirán una respuesta coherente con las 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 todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

    Captura de pantalla del vínculo "Administrador del sitio" 1. En la barra lateral de la izquierda, haga clic en Consola de administración . Pestaña Consola de administración en la barra lateral de la izquierda

  3. En la parte superior de Consola de administración, haga clic en Mantenimiento. Pestaña Mantenimiento

  4. 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, use el menú desplegable y haga clic en ahora. Menú desplegable con la opción para habilitar el modo de mantenimiento ahora seleccionada
    • 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 en dos horas seleccionada
  5. Seleccione Habilitar modo de mantenimiento. Casilla para habilitar o programar el modo de mantenimiento 1. En la barra lateral de la izquierda, haga clic en Guardar configuración.

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

    Nota: Al guardar la configuración en la Consola de administración se restablecen los servicios de sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

  6. Espera que se complete la fase de configuración.

    Configurar tu instancia

Validación de cambios en modo de mantenimiento mediante la lista de excepciones IP

La lista de excepciones IP proporciona acceso controlado y restringido a your GitHub Enterprise Server instance, lo que es ideal para la validación inicial del estado del servidor después de una operación de mantenimiento. Una vez habilitado, your GitHub Enterprise Server instance se quitará del modo de mantenimiento y solo estará disponible para las direcciones IP configuradas. La casilla del modo de mantenimiento se actualizará para reflejar el cambio en el estado.

Si vuelves a habilitar el modo de mantenimiento, la lista de excepciones IP se deshabilitará y your GitHub Enterprise Server instance volverá al modo de mantenimiento. Si solo deshabilitas la lista de excepciones IP, your GitHub Enterprise Server instance volverá a la operación normal.

También puedes usar una utilidad de línea de comandos para configurar la lista de excepciones de IP. Para más información, vea "Utilidades de línea de comandos" y "Acceso 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 todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

    Captura de pantalla del vínculo "Administrador del sitio" 1. En la barra lateral de la izquierda, haga clic en Consola de administración . Pestaña Consola de administración en la barra lateral de la izquierda

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

  4. Selecciona Habilitar lista de excepciones IP. Casilla para habilitar la lista de excepciones IP

  5. En el cuadro de texto, escribe una lista válida de direcciones IP o bloques CIDR separados por espacios a los que se debe permitir el acceso a your GitHub Enterprise Server instance. campo completado para direcciones IP

  6. Haga clic en Save(Guardar). después de que se haya guardado la lista de excepciones de IP

Programar el modo de mantenimiento con the GitHub Enterprise Server APIs

Puedes programar el mantenimiento para horarios o días diferentes con the GitHub Enterprise Server APIs. Para más información, vea "Consola de administración".

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

Con la utilidad ghe-cluster-maintenance, puede establecer o anular el modo de mantenimiento para cada nodo de un clúster.

$ ghe-cluster-maintenance -h
# Shows options
$ ghe-cluster-maintenance -q
# Queries the current mode
$ ghe-cluster-maintenance -s
# Sets maintenance mode
$ ghe-cluster-maintenance -u
# Unsets maintenance mode