Como gerenciar componentes da CLI gcloud

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Os componentes são as partes instaláveis da CLI do Google Cloud. Um componente pode ser uma ferramenta de linha de comando (gcloud, bq e gsutil), um conjunto de comandos da CLI do gcloud nos níveis de versão 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 padrão. Se você executar um comando gcloud alpha ou gcloud beta de forma interativa e o componente alpha ou beta não estiver instalado, a CLI do gcloud perguntará se você quer instalá-lo. 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 comandos que exigem esses componentes.

Faça um teste

Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Comece a usar gratuitamente

Componentes padrão

Quando você instala 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. Somente os comandos nos níveis de versão de disponibilidade geral e de visualização são instalados com este componente. Você precisa instalar separadamente os componentes de comando gcloud alpha e/ou gcloud beta 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 de linha de comando do Cloud Storage Ferramenta para executar tarefas relacionadas ao Cloud Storage.
core Bibliotecas principais da CLI gcloud Bibliotecas usadas internamente pelas ferramentas da CLI gcloud.

Componentes Alfa e Beta

A CLI gcloud fornece dois componentes que contêm comandos Alfa e Beta da CLI gcloud. Esses componentes não são instalados por padrão, mas é possível instalá-los 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 da versão alfa.
beta Comandos Beta da CLI gcloud Comandos da CLI gcloud no nível da versão Beta.

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

Veja abaixo uma lista de todos os componentes adicionais disponíveis e gerenciadores de pacotes externos que não estão instalados por padrão.

Como gerenciar componentes da CLI gcloud

Você pode listar, instalar, atualizar e remover componentes da CLI do gcloud de acordo com 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 mais recentes dos componentes, atualize a instalação da CLI da gcloud e execute gcloud components list.

Status Nome do componente Código Tamanho
Instalado Extensões Go do App Engine app-engine-go 97,7 MiB
Não instalado Apptl Appctl 21,0 MiB
Instalado Ferramenta de linha de comando do Cloud Bigtable cbt 4,0 MiB
Instalado Emulador do Cloud Bigtable bigtable 3,8 MiB
Instalado Ferramenta de linha de comando do Cloud Datalab datalab < 1 MiB
Instalado Emulador do Cloud Datastore cloud-datastore-emulator 17,8 MiB
Não instalado Emulador do Cloud Datastore cloud-firestore-emulador 60,4 MiB
Instalado Emulador do Cloud Pub/Sub pubsub-Emulator 33,2 MiB
Instalado Cloud SQL Proxy cloud-sql-proxy (em inglês) 7,6 MiB
Instalado Emulador do Cloud Spanner emulador de nuvem-spanner 21,8 MiB
Instalado Construtor local do Google Cloud Build cloud-build-local 4,4 MiB
Instalado Extensões Java do aplicativo gcloud app-engine-java 118,9 MiB
Instalado Extensões PHP de app da gcloud app-engine-php 21,9 MiB
Instalado Extensões do app gcloud em Python (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 de Cloud SDK 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
Instalado Extensões Python do aplicativo gcloud app-engine-python 6,1 MiB

Como instalar componentes

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

gcloud components install [COMPONENT-ID]

A CLI da gcloud instala o componente especificado.

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

gcloud components install kubectl

Como 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 você tiver uma versão mais antiga da CLI da gcloud instalada, a CLI da gcloud atualizará todos os componentes instalados.

Se você precisar reverter para uma versão válida conhecida e instalou a CLI gcloud diretamente (fora de um gerenciador de pacotes, incluindo o uso 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

Para fazer o downgrade de versões da CLI gcloud instalada usando um gerenciador de pacotes, consulte estas instruções para especificar versões ao fazer o download usando apt-get ou yum.

Como 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 complementares

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

Gerenciadores de pacotes externos

Se você instalou a CLI gcloud usando os gerenciadores de pacotes apt ou yum, também pode instalar outros componentes da CLI gcloud usando esses mesmos gerenciadores de pacotes. Se não encontrar os pacotes por meio do gerenciador de pacotes, leia os guias instalação com apt ou instalação com yum para saber como configurar https://packages.cloud.google.com/ como uma origem de pacote.

Componente da CLI gcloud Pacote APT Pacote YUM
app-engine-go google-cloud-cli-app-engine-go google-cloud-cli-app-engine-go
app-engine-java google-cloud-cli-app-engine-java google-cloud-cli-app-engine-java
app-engine-python google-cloud-cli-app-engine-python google-cloud-cli-app-engine-python
bigtable google-cloud-cli-bigtable-emulator google-cloud-cli-bigtable-emulator
cbt google-cloud-cli-cbt google-cloud-cli-cbt
cloud-build-local google-cloud-cli-cloud-build-local google-cloud-cli-cloud-build-local
datalab google-cloud-cli-datalab google-cloud-cli-datalab
docker-credential-gcr Não disponível ainda. Não disponível ainda.
gcd-emulator google-cloud-cli-datastore-emulator google-cloud-cli-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-cli-pubsub-emulator google-cloud-cli-pubsub-emulator