Os 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 nas versões Alfa ou Beta
níveis de versão 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 uma
os comandos gcloud alpha
ou gcloud beta
de maneira interativa e alpha
ou beta
componente não está instalado, a CLI gcloud perguntará se você
quiser instalá-lo. Uma resposta afirmativa instala o componente e, em seguida, executa
o comando. Outros componentes são instalados sob demanda pelo
CLI gcloud ao executar os comandos que precisam deles.
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 gratuitamenteComponentes padrão
Quando você instala a CLI gcloud, os seguintes componentes são instalado 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 legada para executar tarefas do Cloud Storage. Usar
Comandos gcloud storage
como alternativa. |
|
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 você pode instalá-los manualmente a qualquer momento após o 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. |
Os comandos da CLI gcloud no nível de versão de disponibilidade geral são do componente CLI gcloud e são instalados automaticamente ao instalar a CLI gcloud.
Uma lista de todos os componentes adicionais disponíveis e gerenciadores de pacotes externos, que não estão instalados por padrão, aparece abaixo.
Como gerenciar componentes da CLI gcloud
É possível listar, instalar, atualizar e remover componentes da CLI gcloud para 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
consultar as ofertas mais recentes de componentes, atualizar a CLI gcloud
e execute
gcloud components list
Status | Nome do componente | ID | Tamanho |
---|---|---|---|
Instalado | Extensões do App Engine para Go | App Engine | 97,7 MiB |
Não instalado | AppCtl | appctl | 21,0 MiB |
Instalado | Ferramenta de linha de comando do Cloud Bigtable | cbt | 4 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 app gcloud | app-engine-java | 118,9 MiB |
Instalado | Extensões PHP de app do gcloud | app-engine-php | 21,9 MiB |
Instalado | Extensões Python do gcloud app (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 app gcloud | app-engine-python | 6,1 MiB |
Instalar componentes
Instalar um componente na versão atual da CLI gcloud
instalação, executar
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
Atualizar componentes
Usar o gcloud components update
para atualizar todos os componentes instalados para a versão mais recente disponível do
CLI gcloud:
gcloud components update
Se você tiver uma versão mais antiga da CLI gcloud instalada, CLI gcloud atualiza todos os componentes instalados.
Se você precisar reverter para uma versão válida conhecida anteriormente e instalar o
CLI gcloud diretamente (fora de um gerenciador de pacotes, incluindo o uso de
o instalador interativo, as versões estáticas, o instalador do Windows ou o Homebrew),
Use gcloud components update
para reverter para a versão especificada:
gcloud components update --version VERSION
Para fazer downgrade de versões da CLI gcloud instalada usando um pacote
de acesso, consulte essas instruções para especificar versões ao fazer o download
usando apt-get
ou yum
.
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 da CLI gcloud
também estão disponíveis na CLI gcloud, mas não são instalados pelo
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 a CLI gcloud pelo apt
ou gerenciadores de pacotes yum
, também é possível instalar
componentes adicionais 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 |
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 |