Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.

Использование расширений GitHub CLI

Узнайте, как использовать пользовательские расширения, написанные другими пользователями GitHub CLI.

Сведения о расширениях GitHub CLI

Примечание. Расширения за пределами GitHub Enterprise Server и GitHub CLI не сертифицированы GitHub Enterprise Server и регулируются отдельными условиями предоставления услуг, политикой конфиденциальности и документацией по поддержке. Чтобы снизить риск при использовании сторонних расширений, выполните аудит исходного кода расширения перед установкой или обновлением расширения.

Расширения GitHub CLI — это пользовательские команды GitHub CLI, которые может создавать и применять любой пользователь. Дополнительные сведения о создании расширений GitHub CLI см. в статье Создание расширений GitHub CLI.

Расширения устанавливаются локально и ограничены пользователем. Таким образом, если вы обращаетесь к GitHub CLI с другого компьютера или другой пользователь обращается к GitHub CLI с того же компьютера, расширение будет недоступно.

Поиск расширений

Расширения можно найти, просмотрев репозитории с темой gh-extension.

Установка расширений

Чтобы установить расширение, используйте подкоманду extensions install. Замените параметр repo на репозиторий расширения. Можно использовать полный URL-адрес, например https://github.com/octocat/gh-whoami, или только владельца и репозитория, например octocat/gh-whoami.

Если используется владелец и репозиторий, ghустановит расширение с использованием имени узла, к которому gh в настоящее время выполняет проверку подлинности. Формат полного URL-адреса полезен при установке расширений с другого узла. Например, пользователи на GitHub Enterprise Server должны использовать полный URL-адрес репозитория, чтобы установить расширения с GitHub.com или любого другого узла.

Чтобы установить расширение в разработке из текущего каталога, используйте . в качестве значения для параметра repo.

gh extension install REPO

Если у вас уже установлено расширение с тем же именем, команда завершится ошибкой. Например, если вы уже установили octocat/gh-whoami, то необходимо его удалить перед установкой hubot/gh-whoami.

Отображение установленных расширений

Чтобы просмотреть все установленные расширения, используйте подкоманду extensions list. В выходных данных также будет указано, для каких расширений доступны обновления.

gh extension list

Обновление расширений

Чтобы обновить расширение, используйте подкоманду extensions upgrade. Замените параметр extension на имя расширения.

gh extension upgrade EXTENSION

Чтобы обновить все установленные расширения, используйте флаг --all.

gh extension upgrade --all

Удаление расширений

Чтобы удалить расширение, используйте подкоманду extensions remove. Замените параметр extension на имя расширения.

gh extension remove EXTENSION