Como gerenciar componentes do SDK

O que são componentes?

Componentes são as partes instaláveis do SDK, como uma ferramenta de linha de comando (gcloud, bq e gsutil), um conjunto de comandos da CLI da gcloud em níveis de versão Alfa ou Beta ou um pacote com dependências usadas por uma ferramenta no SDK.

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 da 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 da gcloud quando você executa os comandos relacionados.

Componentes padrão

Quando você instala o SDK, os seguintes componentes são instalados por padrão:

Código Nome Descrição
gcloud Comandos padrão da CLI da gcloud Ferramenta para interagir com o Google Cloud Platform. 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 comandos gcloud alpha e/ou os comandos gcloud beta para poder usar os comandos em outros níveis de versão.
bq Ferramenta de linha de comando do BigQuery Ferramenta para trabalhar com dados no Google BigQuery
gsutil Ferramenta de linha de comando do Google Cloud Storage Ferramenta para executar tarefas relacionadas ao Google Cloud Storage.
core Bibliotecas principais de Cloud SDK Bibliotecas usadas internamente pelas ferramentas SDK.

Componentes Alfa e Beta

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

Código Nome Descrição
alpha Comandos Alfa da CLI da gcloud Comandos da CLI da gcloud no nível de versão Alfa.
beta Comandos Beta da CLI da gcloud Comandos da CLI da gcloud no nível de versão Beta.

Os comandos da CLI da gcloud nos níveis de versão de disponibilidade geral e pré-visualização fazem parte do componente da CLI da gcloud e são instalados automaticamente quando você instala o SDK.

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

Como gerenciar componentes do Cloud SDK

É possível listar, instalar, atualizar e remover componentes do SDK do Google Cloud de acordo com as suas necessidades.

Como listar componentes

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

gcloud components list
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                          │
├───────────────┬───────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status    │                         Name                  │            ID            │    Size   │
├───────────────┼───────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 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 │
│ Installed     │ Cloud Datastore Emulator (Legacy)             │ gcd-emulator             │  38.1 MiB │
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 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     │ 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 │
└───────────────┴───────────────────────────────────────────────┴──────────────────────────┴───────────┘

Observe que a saída exibida acima não é uma lista 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.

Como instalar componentes

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

gcloud components install [COMPONENT-ID]

A CLI da gcloud instala o componente especificado.

Por exemplo, caso você queira 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 do SDK do Cloud:

gcloud components update

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

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

gcloud components update --version VERSION

Para fazer downgrade de versões do SDK do Cloud instaladas por meio de um gerenciador de pacotes, consulte estas instruções para especificar versões ao fazer o download via apt-get ou yum.

Como remover componentes

Use o comando gcloud components remove para remover um determinado componente pelo código correspondente:

gcloud components remove [COMPONENT-ID]

Você pode reinstalar um componente usando o comando gcloud components install a qualquer momento.

Componentes complementares

Componentes complementares que contêm dependências para vários comandos da CLI da gcloud também estão disponíveis no SDK, mas não são instalados por padrão. Veja abaixo alguns desses componentes (execute $ gcloud components list para ver a lista completa):

Código Nome Descrição
app-engine-python Extensões App Python da gcloud Pacotes de SDK do Google App Engine para Python. Instalado quando você usa o comando gcloud app deploy para implantar um aplicativo Python no App Engine.
app-engine-java Extensões Java do aplicativo da gcloud Pacotes de SDK do Google App Engine para Java. Instalado quando você usa o comando gcloud app deploy para implantar um aplicativo Java no App Engine.
app-engine-go Extensões Go do aplicativo da gcloud Pacotes de SDK do Google App Engine para Go. Instalado quando você usa o comando gcloud app deploy para implantar um aplicativo Go no App Engine.
gcd-emulator Emulador do Cloud Datastore Emulador para o Google Cloud Datastore. Instalado quando você usa comandos no grupo de comandos gcloud beta emulators datastore.
pubsub-emulator Emulador do Cloud Pub/Sub Emulador para o Google Cloud Pub/Sub. Instalado quando você usa comandos no grupo de comandos gcloud beta emulators pubsub.
cbt CLI do Cloud Bigtable Ferramenta de linha de comando do Google Cloud Bigtable
cloud-build-local Construtor local do Cloud Build Construtor local do Google Cloud Build
bigtable Emulador do Cloud Bigtable Emulador para o Google Cloud Bigtable. Instalado quando você usa comandos no grupo de comandos gcloud beta emulators bigtable.
kubectl kubectl Ferramenta de linha de comando de Kubernetes. Quando você executa comandos no grupo de comandos gcloud container, você é solicitado a instalar este componente. O kubectl não é necessário para criar clusters de contêiner, mas sim para executá-los.
docker-credential-gcr docker-credential-gcr Auxiliar de credenciais do Docker para o Google Container Registry. Após a instalação, habilite o auxiliar de credenciais executando docker-credential-gcr configure-docker. Para mais informações, consulte o projeto no GitHub.
datalab datalab Ferramenta de linha de comando Cloud Datalab.
cloud-build-local Google Cloud Build Local Construtor local do Cloud Build. Após a instalação, você poderá executar compilações na sua máquina local. Para mais informações, consulte Como criar e depurar localmente.

Gerenciadores de pacotes externos

Se você instalou o SDK do Cloud com um gerenciador de pacotes externo, como APT (por meio do formato deb) ou YUM, siga a tabela abaixo para instalar os outros componentes.

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
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud SDK