À 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 ».
- À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
- Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
- Dans la barre latérale « Administrateur de site », cliquez sur Management Console .
- 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.