Como gerenciar componentes da CLI gcloud

Componentes são as partes instaláveis da Google Cloud CLI. Um componente pode ser uma ferramenta de linha de comando (gcloud, bq e gsutil), um conjunto de comandos da CLI gcloud nos níveis de versão Alfa, Beta ou Prévia ou um pacote que contém dependências usadas por uma ferramenta na CLI gcloud.

Os componentes mais usados são instalados por padrão. Se você executar os comandos gcloud alpha, gcloud beta ou gcloud preview interativamente e os componentes alpha, beta ou preview não estiverem instalados, a CLI gcloud perguntará se você quer instalá-los. Uma resposta afirmativa instala o componente e, em seguida, executa o comando. Outros componentes são instalados sob demanda pela CLI gcloud quando você executa os comandos que necessitam deles.

Componentes padrão

Ao instalar a CLI gcloud, os seguintes componentes são instalados por padrão:

ID Nome Descrição
gcloud Comandos padrão da CLI gcloud Ferramenta para interagir com o Google Cloud Cloud de Confiance. Somente os comandos no nível de versão de disponibilidade geral estão instalados com este componente. Você precisa instalar separadamente os componentes de comandos gcloud alpha Comandos, gcloud beta Comandos e/ou gcloud preview Comandos se quiser usar comandos em outros níveis de versão.
bq Ferramenta de linha de comando do BigQuery Ferramenta para trabalhar com dados no BigQuery
gsutil Ferramenta legada para executar tarefas do Cloud Storage. Use os comandos gcloud storage em vez disso.
core Bibliotecas principais da CLI gcloud Bibliotecas usadas internamente pelas ferramentas da CLI gcloud.

Componentes Alfa, Beta e Prévia

A CLI gcloud oferece componentes que contêm comandos Alfa, Beta e Prévia da CLI gcloud. Esses componentes não são instalados por padrão, mas podem ser instalados manualmente a qualquer momento após a instalação inicial da CLI gcloud. Esses componentes são:

ID Nome Descrição
alpha Comandos Alfa da CLI gcloud Comandos da CLI gcloud no nível de versão Alfa.
beta Comandos Beta da CLI gcloud Comandos da CLI gcloud no nível de versão Beta.
preview Comandos de prévia da CLI gcloud Comandos da CLI gcloud no nível de versão de prévia.

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

Uma lista de todos os outros componentes adicionais e gerenciadores de pacotes externos disponíveis, mas não instalados por padrão, aparece abaixo.

Como gerenciar componentes da CLI gcloud

É possível listar, instalar, atualizar e remover componentes da CLI gcloud de acordo com as suas necessidades.

Como listar componentes

Para ver uma lista de componentes que estão disponíveis e atualmente instalados, execute o comando gcloud components list:

gcloud components list

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

Status Nome do componente ID Tamanho
Instalado Extensões Go do App Engine app-engine-go 97,7 MiB
Instalado Ferramenta de linha de comando do Cloud Bigtable cbt 4,0 MiB
Instalado Emulador do Cloud Bigtable bigtable 3,8 MiB
Instalado Emulador do Cloud Datastore cloud-datastore-emulator 17,8 MiB
Não instalado Emulador do Cloud Firestore cloud-firestore-emulator 60,4 MiB
Instalado Emulador do Cloud Pub/Sub pubsub-emulator 33,2 MiB
Instalado Cloud SQL Proxy cloud_sql_proxy 7,6 MiB
Instalado Emulador do Cloud Spanner cloud-spanner-emulator 21,8 MiB
Instalado Construtor local do Google Cloud Build cloud-build-local 4,4 MiB
Instalado Extensões Java do aplicativo da gcloud app-engine-java 118,9 MiB
Instalado Extensões PHP do aplicativo da gcloud app-engine-php 21,9 MiB
Instalado Extensões Python do aplicativo da gcloud (bibliotecas extras) app-engine-python-extras 27,8 MiB
Instalado kubectl kubectl 12,2 MiB
Instalado Ferramenta de linha de comando do Cloud BigQuery bq < 1 MiB
Instalado Bibliotecas principais do SDK Cloud core 7,2 MiB
Instalado Ferramenta de linha de comando do Cloud Storage gsutil 3,3 MiB
Instalado Comandos gcloud alpha Alfa < 1 MiB
Instalado Comandos beta do gcloud beta < 1 MiB
Não instalado Comandos de prévia da gcloud visualização < 1 MiB
Instalado Extensões Python do aplicativo da gcloud app-engine-python 6,1 MiB

Instalar componentes

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

gcloud components install [COMPONENT-ID]

A CLI gcloud instala o componente especificado.

Por exemplo, se você quiser instalar o comando kubectl:

gcloud components install kubectl

Como atualizar componentes

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

gcloud components update

Se você tiver uma versão mais antiga da CLI gcloud instalada, a CLI gcloud atualizará todos os componentes instalados.

Se você precisar reverter para uma versão válida anterior e instalou a CLI gcloud diretamente, ou seja, fora de um gerenciador de pacotes, incluindo por meio do instalador interativo, versões estáticas, instalador do Windows ou Homebrew, use gcloud components update para reverter para a versão especificada:

gcloud components update --version VERSION

Remover componentes

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

gcloud components remove [COMPONENT-ID]

É possível reinstalar um componente usando o comando gcloud components install a qualquer momento.

Componentes adicionais

Outros componentes que contêm dependências para comandos da CLI gcloud também estão disponíveis na CLI gcloud, mas não são instalados por padrão. Para uma lista completa de componentes, execute gcloud components list. Os componentes extras que podem ser instalados são marcados com o status Not Installed.