Utilisation de l’interface CLI GitHub sur plusieurs plateformes GitHub

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

Dans cet article

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

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

Comment puis-je exécuter des commandes pour chaque compte ?

Une fois que vous vous êtes authentifié(e)(s) avec plusieurs comptes, lorsque vous lancez une commande, le/la/les GitHub CLI peut/pouvent parfois détecter automatiquement la plateforme que 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 dépôts de votre compte, le GitHub CLI ne saura pas à quel compte vous souhaitez accéder. Ainsi, dans ce genre de cas :

  • Le GitHub CLI sera défini par défaut comme 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. Consultez gh environment 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. Consultez gh auth switch dans le manuel GitHub CLI.