Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2024-07-09. 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.

Dans cet article

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

  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.
  3. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .
  4. Sous « Accès SSH », collez votre clé dans la zone de texte « Ajouter une nouvelle clé SSH », puis cliquez sur Ajouter une clé. La modification prend effet immédiatement, donc vous n’avez pas besoin de cliquer sur Enregistrer les paramètres.

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 à votre instance GitHub Enterprise Server 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 Support GitHub Enterprise.