Activation et planification du mode de maintenance

À propos du mode de maintenance

Certains types d’opérations vous imposent de mettre votre instance GitHub Enterprise Server en mode hors connexion et de le basculer en mode maintenance :

• Mise à niveau vers une nouvelle version de GitHub Enterprise Server
• Accroissement des ressources de processeur, de mémoire ou de stockage allouées à la machine virtuelle
• Migration de données d’une machine virtuelle vers une autre
• Restauration de données à partir d’un instantané GitHub Enterprise Server Backup Utilities
• Résolution de certains types de problèmes d’application critiques

Nous vous recommandons dans l’avenir de planifier une fenêtre de maintenance d’au moins 30 minutes pour laisser le temps aux utilisateurs de se préparer. Quand une fenêtre de maintenance est planifiée, tous les utilisateurs voient une bannière au moment d’accéder au site.

Quand l’instance est en mode maintenance, tous les accès HTTP et Git normaux sont refusés. Les opérations Git de récupération (fetch), de clonage et d’envoi (push) sont également rejetées avec un message d’erreur indiquant que le site est temporairement indisponible. Dans les configurations à haute disponibilité, la réplication Git est suspendue. Les travaux GitHub Actions ne sont pas exécutés. La visite du site dans un navigateur entraîne l’affichage d’une page de maintenance.

Vous pouvez effectuer la validation initiale de votre opération de maintenance en configurant une liste d’exceptions IP pour autoriser l’accès à votre instance GitHub Enterprise Server uniquement à partir des adresses IP et des plages fournies. Les tentatives d’accès à votre instance GitHub Enterprise Server à partir d’adresses IP non spécifiées dans la liste d’exceptions IP reçoivent une réponse cohérente avec celles envoyées lorsque l’instance est en mode maintenance.

Activation immédiate du mode maintenance ou planification d’une fenêtre de maintenance ultérieure

1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.

2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site. 1. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

3. Dans la barre de navigation supérieure, cliquez sur Maintenance.

   

4. Sous « Activer et planifier », sélectionnez Activer le mode maintenance, puis choisissez entre une activation immédiate du mode maintenance ou la planification d’une fenêtre de maintenance ultérieure.

   • Pour une activation immédiate du mode maintenance, sélectionnez le menu déroulant, puis cliquez sur maintenant.
   • Pour planifier une fenêtre de maintenance à un moment ultérieur, sélectionnez le menu déroulant et cliquez sur une heure de début.

5. Sous la barre latérale « Paramètres », cliquez sur Enregistrer les paramètres.

   Remarque : l’enregistrement des paramètres dans la Management Console redémarre les services système, ce qui peut entraîner un temps d’arrêt visible pour l’utilisateur.

6. Attendez la fin de l’exécution de la configuration.

Validation des modifications en mode maintenance à l’aide de la liste d’exceptions IP

La liste des exceptions IP fournit un accès contrôlé et restreint à votre instance GitHub Enterprise Server, ce qui est idéal pour la validation initiale de l’intégrité du serveur après une opération de maintenance. Une fois activé,votre instance GitHub Enterprise Server sera supprimé du mode maintenance et disponible uniquement pour les adresses IP configurées. La case à cocher du mode de maintenance est mise à jour pour refléter le changement d’état.

Si vous réactivez le mode maintenance, la liste des exceptions IP est désactivée et votre instance GitHub Enterprise Server retourne en mode maintenance. Si vous désactivez simplement la liste d’exceptions IP, votre instance GitHub Enterprise Server retrouve son fonctionnement normal.

Vous pouvez également utiliser un utilitaire en ligne de commande pour configurer la liste d’exceptions IP. Pour plus d’informations, consultez « Utilitaires de ligne de commande » et « Accès à l’interpréteur de commandes d’administration (SSH) ».

1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.

2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site. 1. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

3. Dans la barre de navigation supérieure, cliquez sur Maintenance, puis vérifiez que le mode de maintenance est déjà activé.

   

4. Sous « Activer et configurer la liste d’exceptions IP », sélectionnez Activer la liste d’exceptions IP.

5. À droite de la case à cocher permettant d’activer la liste, entrez une liste valide d’adresses IP séparées par un espace ou de blocs CIDR qui doivent être autorisés à accéder à votre instance GitHub Enterprise Server.

6. Cliquez sur Enregistrer.

Planification du mode maintenance avec les GitHub Enterprise Server APIs

Vous pouvez planifier la maintenance pour différentes heures ou dates avec les GitHub Enterprise Server APIs. Pour plus d’informations, consultez « Administration de GitHub Enterprise ».

Activation ou désactivation du mode de maintenance pour tous les nœuds d’un cluster

Avec l’utilitaire ghe-cluster-maintenance, vous pouvez définir ou annuler le mode maintenance pour chaque nœud d’un cluster.

$ 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