Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

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.

Accès à l’interpréteur de commandes d’administration (SSH)

L’accès SSH vous permet d’exécuter les utilitaires en ligne de commande GitHub Enterprise Server pour résoudre les problèmes, exécuter des sauvegardes et configurer la réplication.

À propos de l’accès à l’interpréteur de commandes

Si vous disposez d’un accès SSH à l’interpréteur de commandes d’administration, vous pouvez exécuter les utilitaires en ligne de commande de GitHub Enterprise Server. L’accès SSH s’avère aussi utile pour la résolution des problèmes, l’exécution de sauvegardes et la configuration de la réplication. L’accès SSH administratif est géré séparément de l’accès SSH Git et est accessible uniquement via le port 122.

Activation de l’accès à l’interpréteur de commandes d’administration via SSH

Pour activer l’accès SSH administratif, vous devez ajouter votre clé publique SSH à la liste des clés autorisées de votre instance. Pour plus d’informations, consultez « Génération d’une nouvelle clé SSH et ajout de celle-ci à ssh-agent ».

Conseil : Les modifications apportées aux clés SSH autorisées prennent effet immédiatement.

  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. Sous « Accès SSH », collez votre clé dans la zone de texte, puis cliquez sur Ajouter une clé. Zone de texte et bouton permettant d’ajouter une clé SSH 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.

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

    Configuration de votre instance

Connexion à l’interpréteur de commandes d’administration via SSH

Après avoir ajouté votre clé SSH à la liste, connectez-vous à l’instance via SSH en tant qu’utilisateur admin sur le port 122.

$ ssh -p 122 admin@github.example.com
Last login: Sun Nov 9 07:53:29 2014 from 169.254.1.1
admin@github-example-com:~$ █

Résolution des problèmes de connexion SSH

Si vous rencontrez l’erreur Permission denied (publickey) lors d’une tentative de connexion à your GitHub Enterprise Server instance via SSH, vérifiez que vous vous connectez via le port 122. Vous devrez peut-être indiquer explicitement quelle clé SSH privée utiliser.

Pour spécifier une clé SSH privée en utilisant la ligne de commande, exécutez ssh avec l’argument -i.

ssh -i /path/to/ghe_private_key -p 122 admin@HOSTNAME

Vous pouvez aussi spécifier une clé SSH privée en utilisant le fichier de configuration SSH (~/.ssh/config).

Host HOSTNAME
  IdentityFile /path/to/ghe_private_key
  User admin
  Port 122

Accès à l’interpréteur de commandes d’administration à l’aide de la console locale

Dans une situation d’urgence, par exemple si SSH n’est pas disponible, vous pouvez accéder à l’interpréteur de commandes d’administration localement. Connectez-vous en tant qu’utilisateur admin et utilisez le mot de passe établi pendant la configuration initiale de GitHub Enterprise Server.

Limitations d’accès pour l’interpréteur de commandes d’administration

L’accès à l’interpréteur de commandes d’administration est réservé à la résolution de problèmes et à l’exécution des procédures relatives aux opérations documentées. La modification de fichiers système et d’application, l’exécution de programmes ou l’installation de packages logiciels non pris en charge peuvent annuler votre contrat de support. Si vous avez une question sur les activités autorisées dans le cadre de votre contrat de support, contactez le GitHub Enterprise Support.