Skip to main content

Activation et planification du mode de maintenance

Certaines procédures de maintenance standard, par exemple la mise à niveau de your GitHub Enterprise Server instance ou la restauration de sauvegardes, nécessitent la mise hors connexion de l’instance pour fonctionner normalement.

À 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.

Bannière d’utilisateur final sur la maintenance planifiée

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.

Écran de démarrage du mode 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 à your GitHub Enterprise Server instance uniquement à partir des adresses IP et des plages fournies. Les tentatives d’accès à your GitHub Enterprise Server instance à 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 dans le coin supérieur droit de n’importe quelle page.

    Capture d’écran de l’icône représentant une fusée qui donne accès aux paramètres d’administration du site

  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.

    Capture d’écran du lien « Administrateur du site » 1. Dans la barre latérale gauche, cliquez sur Management Console . Onglet Management Console dans la barre latérale gauche

  3. Dans la partie supérieure de la Management Console, cliquez sur Maintenance. Onglet Maintenance

  4. 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. Menu déroulant avec l’option permettant d’activer le mode maintenance maintenant sélectionnée
    • Pour planifier une fenêtre de maintenance à un moment ultérieur, utilisez le menu déroulant et cliquez sur une heure de début. Menu déroulant avec l’option permettant de planifier une fenêtre de maintenance dans deux heures sélectionnée
  5. Sélectionnez Activer le mode maintenance. Case à cocher permettant d’activer ou de planifier le mode maintenance 1. Sous la barre latérale gauche, cliquez sur Enregistrer les paramètres.

    Capture d’écran du bouton Enregistrer les paramètres de la Management Console

    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.

    Configuration de votre instance

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 à your GitHub Enterprise Server instance, 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é,your GitHub Enterprise Server instance 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 your GitHub Enterprise Server instance retourne en mode maintenance. Si vous désactivez simplement la liste d’exceptions IP, your GitHub Enterprise Server instance 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 en ligne de commande » et « Accès à l’interpréteur de commandes (SSH) ».

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur dans le coin supérieur droit de n’importe quelle page.

    Capture d’écran de l’icône représentant une fusée qui donne accès aux paramètres d’administration du site

  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.

    Capture d’écran du lien « Administrateur du site » 1. Dans la barre latérale gauche, cliquez sur Management Console . Onglet Management Console dans la barre latérale gauche

  3. En haut de Management Console, cliquez sur Maintenance, puis vérifiez que le mode de maintenance est déjà activé. Onglet Maintenance

  4. Sélectionnez Activer la liste des exceptions IP. Case à cocher pour activer la liste des exceptions IP

  5. Dans la zone de texte, entrez une liste valide d’adresses IP séparées par un espace ou de blocs CIDR qui doivent être autorisés à accéder à your GitHub Enterprise Server instance. champ rempli pour les adresses IP

  6. Cliquez sur Enregistrer. après enregistrement de la liste des exceptions IP

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