Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

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 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. 1. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

  3. Sous « Accès SSH », collez votre clé dans la zone de texte « Ajouter une nouvelle clé SSH », puis cliquez sur Ajouter une clé.

  4. Sous la barre latérale « Paramètres », 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.

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

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 le Support GitHub Enterprise.