Esta versão do GitHub Enterprise foi descontinuada em 2021-09-23. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Usando as extensões de CLI do GitHub

Aprenda a usar extensões personalizadas escritas por outros usuários de GitHub CLI.

Sobre extensões de GitHub CLI

Observação: As extensões fora de GitHub Enterprise Server e GitHub CLI não são certificadas por GitHub Enterprise Server e são regidas por termos de serviço separados, política de privacidade e documentação de suporte. Para mitigar o risco ao usar extensões de terceiros, faça a auditoria do código-fonte da extensão antes de instalá-la ou atualizá-la.

GitHub CLI extensions are custom GitHub CLI commands that anyone can create and use. Para obter mais informações sobre como criar extensões de GitHub CLI, consulte "Criando extensões de GitHub CLI".

As extensões são instaladas localmente e têm seu escopo definido para o usuário. Portanto, se você acessar GitHub CLI de uma máquina diferente ou outro usuário acessar GitHub CLI da mesma máquina, a extensão não estará disponível.

Localizando extensões

Você pode encontrar extensões acessando repositórios com o tópico de gh-extension.

Instalando as extensões

Para instalar uma extensão, use o subcomando extensions install. Substitua o parâmetro repo pelo repositório da extensão. Você pode usar a URL completa, como https://github.com/octocat/gh-whoami ou apenas o proprietário e o repositório, como octocat/gh-whoami.

Se o proprietário e repositório forem usados, gh irá instalar a extensão usando o nome de host com o qual gh está atualmente autenticado. O formato completo da URL é útil ao instalar extensões de um host diferente. Por exemplo, os usuários em GitHub Enterprise Server devem usar a URL completa do repositório para instalar extensões de GitHub.com ou de qualquer outro host.

Para instalar uma extensão em desenvolvimento a partir do diretório atual, use . como o valor para o parâmetro repo.

gh extension install repo

Se você já tem uma extensão com o mesmo nome instalado, o comando irá falhar. Por exemplo, se você instalou octocat/gh-whoami, você deverá desinstalá-lo antes de instalar hubot/gh-whoami.

Visualizando extensões instaladas

Para ver todas as extensões instaladas, use o subcomando lista de extensões. A saída também informará quais extensões possuem atualizações disponíveis.

gh extension list

Atualizando extensões

Para atualizar uma extensão, use o subcomando extensions upgrade. Substitua o parâmetro extensão pelo nome da extensão.

gh extension upgrade extension

Para atualizar todas as extensões instaladas, use o sinalizador --all.

gh extension upgrade --all

Desinstalando extensões

Para desinstalar uma extensão, use o subcomando extensions remove. Substitua o parâmetro extensão pelo nome da extensão.

gh extension remove extension