Gerenciar componentes do Cloud SDK

Os componentes são as partes instaláveis do SDK do Cloud. Um componente pode ser uma ferramenta de linha de comando (gcloud, bq e gsutil), um conjunto de comandos da ferramenta gcloud na versão Alfa ou Beta níveis de lançamento ou um pacote que contenha dependências usadas por uma ferramenta no SDK do Cloud.

Os componentes mais usados são instalados por padrão. Se você executar um comando gcloud alpha ou gcloud beta interativamente e o componente alpha ou beta não estiver instalado, a ferramenta gcloud perguntará se você quiser instalá-lo. Uma resposta afirmativa da instalação do componente e da execução do comando. Outros componentes são instalados sob demanda pela ferramenta gcloud quando você executa comandos que os exigem.

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 ganham US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Comece a usar gratuitamente

Componentes padrão

Ao instalar o SDK do Cloud, os seguintes componentes são instalados por padrão:

ID Nome Descrição
gcloud Comandos padrão da ferramenta 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 do SDK do Cloud Bibliotecas usadas internamente pelas ferramentas do SDK do Cloud.

Componentes Alfa e Beta

O SDK do Cloud fornece dois componentes que contêm comandos Alfa e Beta da ferramenta 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 do SDK do Cloud. Esses componentes são:

ID Nome Descrição
alpha Comandos Alfa da ferramenta gcloud Comandos da ferramenta gcloud no nível de versão Alfa.
beta Comandos Beta da ferramenta gcloud Comandos da ferramenta gcloud no nível da versão Beta.

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

Veja a seguir uma lista com todos os outros componentes e gerenciadores de pacotes externos disponíveis, mas não instalados por padrão.

Gerenciar componentes do Cloud SDK

É possível listar, instalar, atualizar e remover componentes do SDK do Cloud para atender às 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 do SDK do Cloud e execute gcloud components list.


┌────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                         │
├───────────────┬─────────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status   │                         Name                   │            ID           │    Size   │
├───────────────┼─────────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Not Installed │ AppCtl                                        │ appctl                   │  21.0 MiB │
│ Installed     │ Cloud Bigtable Command Line Tool              │ cbt                      │   4.0 MiB │
│ Installed     │ Cloud Bigtable Emulator                       │ bigtable                 │   3.8 MiB │
│ Installed     │ Cloud Datalab Command Line Tool               │ datalab                  │   < 1 MiB │
│ Installed     │ Cloud Datastore Emulator                      │ cloud-datastore-emulator │  17.8 MiB │
| Not Installed | Cloud Datastore Emulator                      | cloud-firestore-emulator | 60.4 MiB  |
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Cloud SQL Proxy                               │ cloud-sql-proxy          │   7.6 MiB │
│ Installed     │ Cloud Spanner Emulator                        │ cloud-spanner-emulator   │  21.8 MiB │
│ Installed     │ Emulator Reverse Proxy                        │ emulator-reverse-proxy   │  14.5 MiB │
│ Installed     │ Google Cloud Build Local Builder              │ cloud-build-local        │   4.4 MiB │
│ Installed     │ gcloud app Java Extensions                    │ app-engine-java          │ 118.9 MiB │
│ Installed     │ gcloud app PHP Extensions                     │ app-engine-php           │  21.9 MiB │
│ Installed     │ gcloud app Python Extensions (Extra Libraries)│ app-engine-python-extras │  27.8 MiB │
│ Installed     │ kubectl                                       │ kubectl                  │  12.2 MiB │
│ Installed     │ Cloud BigQuery Command Line Tool              │ bq                       │   < 1 MiB │
│ Installed     │ Cloud SDK Core Libraries                      │ core                     │   7.2 MiB │
│ Installed     │ Cloud Storage Command Line Tool               │ gsutil                   │   3.3 MiB │
│ Installed     │ gcloud Alpha Commands                         │ alpha                    │   < 1 MiB │
│ Installed     │ gcloud Beta Commands                          │ beta                     │   < 1 MiB │
│ Installed     │ gcloud app Python Extensions                  │ app-engine-python        │   6.1 MiB │
└────────────────┴────────────────────────────────────────────────┴───────────────────────────┴───────────┘

Instalar componentes

Para instalar um componente na versão atual do SDK do Cloud, execute gcloud components install:

gcloud components install [COMPONENT-ID]

A ferramenta gcloud instala o componente especificado.

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

gcloud components install kubectl

Atualizar componentes

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

gcloud components update

Se você tiver uma versão mais antiga do SDK do Cloud instalada, a ferramenta gcloud atualizará todos os componentes instalados.

Se você precisar reverter para uma versão válida conhecida anteriormente e tiver instalado o SDK do Cloud diretamente (fora de um gerenciador de pacotes, incluindo o uso do instalador interativo, das versões estáticas, do instalador do Windows ou do Homebrew), pode usar gcloud components update para reverter para a versão especificada:

gcloud components update --version VERSION

Para fazer downgrade das versões do SDK do Cloud instaladas usando um gerenciador de pacotes, consulte estas instruções para especificar versões ao fazer o download usando:apt-get ou osyum de dados.

Remover componentes

Use o comando 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

Os outros componentes que contêm dependências para comandos da ferramenta gcloud também estão disponíveis no SDK do Cloud, 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.

Gerenciadores de pacotes externos

Se você instalou o SDK do Cloud por meio dos gerenciadores de pacotes apt ou yum, também é possível instalar componentes complementares do SDK do Cloud 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 do Cloud SDK Pacote APT Pacote YUM
app-engine-go google-cloud-sdk-app-engine-go google-cloud-sdk-app-engine-go
app-engine-java google-cloud-sdk-app-engine-java google-cloud-sdk-app-engine-java
app-engine-python google-cloud-sdk-app-engine-python google-cloud-sdk-app-engine-python
bigtable google-cloud-sdk-bigtable-emulator google-cloud-sdk-bigtable-emulator
cbt google-cloud-sdk-cbt google-cloud-sdk-cbt
cloud-build-local google-cloud-sdk-cloud-build-local google-cloud-sdk-cloud-build-local
datalab google-cloud-sdk-datalab google-cloud-sdk-datalab
docker-credential-gcr Não disponível ainda. Não disponível ainda.
gcd-emulator google-cloud-sdk-datastore-emulator google-cloud-sdk-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-sdk-pubsub-emulator google-cloud-sdk-pubsub-emulator