Skip to main content

Cette version de GitHub Enterprise a été abandonnée le 2023-01-18. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

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

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

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