Gerir componentes da CLI gcloud

Os componentes são as partes instaláveis da CLI gcloud. Um componente pode ser uma ferramenta de linhas de comando (gcloud, bq e gsutil), um conjunto de comandos da CLI gcloud nos níveis de lançamento alfa ou beta, ou um pacote que contém dependências usadas por uma ferramenta na CLI gcloud.

Os componentes mais usados são instalados por predefinição. Se executar um comando gcloud alpha ou gcloud beta interativamente e o componente alpha ou beta não estiver instalado, a CLI gcloud pergunta se quer instalá-lo. Uma resposta afirmativa instala o componente e, em seguida, executa o comando. Outros componentes são instalados a pedido pela CLI gcloud quando executa comandos que os requerem.

Componentes predefinidos

Quando instala a CLI gcloud, os seguintes componentes são instalados por predefinição:

Componentes alfa e beta

A CLI gcloud fornece dois componentes que contêm comandos alfa e beta da CLI gcloud. Estes componentes não são instalados por predefinição, mas pode instalá-los manualmente em qualquer altura após a instalação inicial da CLI gcloud. Estes componentes são:

Os comandos da CLI gcloud ao nível da versão de disponibilidade geral fazem parte do componente da CLI gcloud e são instalados automaticamente quando instala a CLI gcloud.

Aparece abaixo uma lista de todos os componentes adicionais e gestores de pacotes externos disponíveis, que não são instalados por predefinição.

Gerir componentes da CLI gcloud

Pode listar, instalar, atualizar e remover componentes da CLI gcloud para satisfazer as suas necessidades.

Componentes de fichas

Para ver uma lista dos componentes disponíveis e atualmente instalados, execute gcloud components list:

gcloud components list

O exemplo seguinte não é uma lista completa de todos os componentes disponíveis. Para ver as ofertas de componentes mais recentes, atualize a instalação da CLI gcloud e, em seguida, execute gcloud components list.

Instalação de componentes

Para instalar um componente na versão atual da instalação da CLI gcloud, execute o seguinte comando: gcloud components install:

gcloud components install [COMPONENT-ID]

A CLI gcloud instala o componente especificado.

Por exemplo, se quiser instalar o comando kubectl:

gcloud components install kubectl

A atualizar componentes

Use o comando gcloud components update para atualizar todos os componentes instalados para a versão mais recente disponível da CLI gcloud:

gcloud components update

Se tiver uma versão mais antiga da CLI gcloud instalada, a CLI gcloud atualiza todos os componentes instalados.

Se precisar de reverter para uma versão válida identificada anteriormente e tiver instalado a CLI gcloud diretamente (fora de um gestor de pacotes, incluindo através do instalador interativo, das versões estáticas, do instalador do Windows ou do Homebrew), use gcloud components update para reverter para a versão especificada:

gcloud components update --version VERSION

Remover componentes

Use o comando gcloud components remove para remover um componente especificado pelo respetivo ID:

gcloud components remove [COMPONENT-ID]

Pode reinstalar um componente através do comando gcloud components install em qualquer altura.

Componentes adicionais

Os componentes adicionais que contêm dependências para os comandos da CLI gcloud também estão disponíveis na CLI gcloud, mas não são instalados por predefinição. Para ver uma lista exaustiva de componentes, execute o comando gcloud components list. Os componentes adicionais que podem ser instalados estão marcados com o estado Not Installed.

Gestores de pacotes externos

Se instalou a gcloud CLI através dos gestores de pacotes apt ou yum, também pode instalar componentes adicionais da gcloud CLI através desses mesmos gestores de pacotes. Se o seu gestor de pacotes não conseguir encontrar estes pacotes, leia os guias de instalação com apt ou instalação com yum para saber como configurar o https://packages.cloud.google.com/ como origem de pacotes.