Utilisation de l’interface CLI GitHub sur les plateformes GitHub

Découvrez comment exécuter des commandes lorsque vous êtes authentifié auprès de comptes sur différentes plateformes GitHub.

Dans cet article

Si vous avez des comptes sur plusieurs plateformes GitHub, par exemple un compte personnel sur GitHub.com et un compte d’utilisateur managé sur GHE.com, vous pouvez vous authentifier avec gh auth login chaque compte.

Vous devrez vous authentifier pour exécuter _ des _ commandes dans un environnement donné. Par exemple, même si vous exécutez une commande qui ne nécessite qu'un accès en lecture à un référentiel public sur GitHub.com, vous ne pourrez pas utiliser cette commande si vous n'êtes authentifié que sur un compte sur GHE.com. Vous devez donc vous authentifier sur tous les comptes que vous souhaitez utiliser avec le GitHub CLI.

Comment exécuter des commandes pour chaque compte ?

Une fois que vous vous êtes authentifié avec plusieurs comptes, lorsque vous exécutez une commande, le GitHub CLI peut parfois détecter automatiquement la plate-forme à laquelle vous essayez d'accéder. Dans d'autres cas, vous devrez fournir plus d'informations dans votre commande.

Le GitHub CLI détecte automatiquementvotre compte lorsque vous êtes dans le contexte d'un référentiel spécifique. Par exemple, si vous cd dans votre répertoire my-repo et que vous exécutez gh repo view, la commande cible la plateforme appropriée pour ce référentiel.

Le GitHub CLI ne peut pas détecter automatiquement votre compte cible s'il ne dispose pas de ce contexte. Par exemple, si vous exécutez gh repo list pour répertorier les référentiels de votre compte, les données GitHub CLI ne savent pas quel compte vous souhaitez accéder. Ainsi, dans ce genre de cas :

  • Le GitHub CLI sera par défaut GitHub.com.
  • Vous pouvez définir la variable d’environnement GH_HOST pour modifier la cible par défaut pour ces types de requêtes. Voir l'environnement gh dans le manuel GitHub CLI.
  • Certaines commandes vous permettent de spécifier votre environnement cible avec l’option --hostname , par gh apiexemple, ou de passer l’URL complète d’un référentiel, par gh pr viewexemple .

Puis-je utiliser plusieurs comptes sur la même plateforme ?

Vous pouvez également vous authentifier avec plusieurs comptes sur la même plateforme. Pour passer d'un compte à l'autre, vous pouvez utiliser la commande gh auth switch suivante. Voir le commutateur gh auth dans le manuel GitHub CLI.