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:
| ID | Nome | Descrição |
|---|---|---|
gcloud |
Comandos predefinidos da CLI gcloud | Ferramenta para interagir com o Trusted Cloud. Apenas os comandos
nos níveis de lançamento de disponibilidade geral e pré-visualização são instalados com
este componente. Tem de instalar separadamente os componentes gcloud alpha
Commands e/ou gcloud beta Commands se quiser
usar comandos noutros níveis de lançamento. |
bq
| Ferramenta de linhas de comando do BigQuery | Ferramenta para trabalhar com dados no BigQuery |
gsutil |
Ferramenta antiga para realizar tarefas do Cloud Storage. Em alternativa, use os
gcloud storage comandos. |
|
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. 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:
| ID | Nome | Descrição |
|---|---|---|
alpha |
Comandos alfa da CLI gcloud | Comandos da CLI gcloud ao nível da versão alfa. |
beta |
Comandos beta da CLI gcloud | Comandos da CLI gcloud ao nível do lançamento beta. |
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.
| Estado | Nome do componente | ID | Tamanho |
|---|---|---|---|
| Instalado | Extensões Go do App Engine | app-engine-go | 97,7 MiB |
| Instalado | Ferramenta de linha de comandos 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 | Proxy do Cloud SQL | cloud_sql_proxy | 7,6 MiB |
| Instalado | Emulador do Cloud Spanner | cloud-spanner-emulator | 21,8 MiB |
| Instalado | Google Cloud Build Local Builder | cloud-build-local | 4,4 MiB |
| Instalado | Extensões Java da gcloud app | app-engine-java | 118,9 MiB |
| Instalado | gcloud app PHP Extensions | app-engine-php | 21,9 MiB |
| Instalado | Extensões Python da app gcloud (bibliotecas adicionais) | app-engine-python-extras | 27,8 MiB |
| Instalado | kubectl | kubectl | 12,2 MiB |
| Instalado | Ferramenta de linha de comandos do Google Cloud BigQuery | bq | < 1 MiB |
| Instalado | Bibliotecas principais do SDK Cloud | core | 7,2 MiB |
| Instalado | Ferramenta de linha de comandos do Cloud Storage | gsutil | 3,3 MiB |
| Instalado | Comandos alfa gcloud | alfa | < 1 MiB |
| Instalado | Comandos gcloud Beta | beta | < 1 MiB |
| Instalado | Extensões Python da gcloud app | app-engine-python | 6,1 MiB |
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.