Использование CLI GitHub на всех платформах GitHub

Узнайте, как запускать команды при аутентификации на аккаунтах на различных платформах GitHub.

В этой статье

Если у вас есть аккаунты на нескольких платформах GitHub, например, личный аккаунт на GitHub.com и управляемая учетная запись пользователя на GHE.com, вы можете аутентифицироваться с помощью gh auth login для каждой учётной записи.

Для выполнения любых команд в данной среде необходимо выполнить проверку подлинности. Например, даже если вы выполняете команду, требующую только чтения access в публичный репозиторий GitHub.com, вы не сможете использовать эту команду, если аутентифицированы только в учетной записи GHE.com. Поэтому необходимо пройти проверку подлинности для всех учетных записей, которые вы хотите использовать с GitHub CLI.

How do I запускать команды для каждого аккаунта?

После аутентификации с несколькими аккаунтами, при запуске команды GitHub CLI иногда автоматически определяет, на какой платформе вы пытаетесь access. В других случаях вам потребуется предоставить дополнительные сведения в команде.

GitHub CLI автоматически обнаруживает учетную запись, когда вы находитесь в контексте определенного репозитория. Например, если вы cd в my-repo каталоге и выполните команду gh repo view, команда будет нацелена на правильную платформу для этого репозитория.

GitHub CLI не может автоматически обнаруживать учетную запись, если у нее нет этого контекста. Например, если вы запустите gh repo list для перечисления репозиториев для вашего аккаунта, GitHub CLI не будет знать, какой аккаунт вы хотите access. В таких случаях:

  • Значение GitHub CLI по умолчанию — GitHub.com.
  • Вы можете задать переменную среды, чтобы изменить целевой GH_HOST объект по умолчанию для таких запросов. См. gh environment в руководстве GitHub CLI.
  • Некоторые команды позволяют указать целевую среду с --hostname помощью опции, например gh api, или передать полный URL репозитория, например gh pr view.

Можно ли использовать несколько учетных записей на одной платформе?

Вы также можете пройти проверку подлинности с несколькими учетными записями на одной платформе. Для переключения между этими учетными записями можно использовать gh auth switch команду. См. gh аутентификационный переключатель в руководстве GitHub CLI.