À propos du mode de maintenance
Certains types d’opérations vous imposent de mettre your GitHub Enterprise Server instance 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.
Activation immédiate du mode maintenance ou planification d’une fenêtre de maintenance ultérieure
-
À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur dans le coin supérieur droit de n’importe quelle page.
-
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 gauche, cliquez sur Management Console .
-
Dans la partie supérieure de la Management Console, cliquez sur Maintenance.
-
Sous « Activer et planifier », 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, utilisez le menu déroulant, puis cliquez sur maintenant.
- Pour planifier une fenêtre de maintenance à un moment ultérieur, utilisez le menu déroulant et cliquez sur une heure de début.
- Pour une activation immédiate du mode maintenance, utilisez le menu déroulant, puis cliquez sur maintenant.
-
Sélectionnez Activer le mode maintenance.
1. Sous la barre latérale gauche, 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.
-
Attendez la fin de l’exécution de la configuration.
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 « Console de gestion ».
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