Folha de referência da CLI gcloud

Uma lista de comandos para a CLI do Google Cloud, a principal ferramenta de linha de comando para Google Cloud.

Também estão incluídos: introdução primer, como entender os comandos e um PDF para impressão.

Folha de referências

Primeiros passos

Comece a usar a CLI gcloud.

• gcloud init: inicialize, autorize e configure a CLI gcloud.
• gcloud version: exiba a versão e os componentes instalados.
• gcloud components install: instale componentes específicos.
• gcloud components update: atualize a CLI gcloud para a versão mais recente.
• gcloud config set project: defina um projeto Google Cloud padrão para trabalhar.
• gcloud info: mostra os detalhes atuais do ambiente da CLI gcloud.

Ajuda

A CLI gcloud está aqui para ajudar.

• gcloud help: pesquise documentos de referência da CLI da gcloud em termos específicos.
• gcloud feedback: envie feedback para a equipe da CLI gcloud.
• gcloud topic: material de ajuda complementar para tópicos que não são de comando, como acessibilidade, filtragem e formatação.

Personalização

Personalize sua configuração com propriedades.

• gcloud config set: defina uma propriedade (como computação/zona) para a configuração atual.
• gcloud config get: extrai o valor de uma propriedade da CLI do gcloud.
• gcloud config list: exiba todas as propriedades da configuração atual.
• gcloud config configurations create: crie uma nova configuração nomeada.
• gcloud config configurations list: exiba uma lista de todas as configurações disponíveis.
• gcloud config configurations activate: alterne para uma configuração nomeada existente.

Autorização e credenciais

Conceder e revogar a autorização para a CLI gcloud e gerenciar as credenciais.

• gcloud auth login: autorize o acessoGoogle Cloud à CLI gcloud com credenciais de usuárioGoogle Cloud e defina a conta atual como ativa.
• gcloud auth activate-service-account: autorize o acesso Google Cloud semelhante a gcloud auth login, mas com credenciais da conta de serviço.
• gcloud auth application-default: gerencie as credenciais padrão do aplicativo (ADC) para as bibliotecas de cliente do Cloud.
• gcloud auth list: liste todas as contas credenciadas.
• gcloud auth print-access-token: exiba o token de acesso da conta atual.
• gcloud auth revoke: remova as credenciais de acesso de uma conta.

Projetos

Gerenciar políticas de acesso ao projeto.

• gcloud projects describe: exiba metadados de um projeto (incluindo o ID dele).
• gcloud projects add-iam-policy-binding: adicione uma vinculação de política de IAM a um projeto especificado.

IAM

Configurar preferências e contas de serviço do gerenciamento de identidade e acesso (IAM).

• gcloud iam list-grantable-roles: liste os papéis atribuíveis do IAM a um recurso.
• gcloud iam roles create: crie um papel personalizado para um projeto ou organização.
• gcloud iam service-accounts create: crie uma conta de serviço para um projeto.
• gcloud iam service-accounts add-iam-policy-binding: adicione uma vinculação de política do IAM a uma conta de serviço.
• gcloud iam service-accounts set-iam-policy-binding: substitua a vinculação da política do IAM atual.
• gcloud iam service-accounts keys list: liste as chaves de uma conta de serviço.

Docker e Google Kubernetes Engine (GKE)

Gerencie aplicativos conteinerizados no Kubernetes.

• gcloud auth configure-docker: registre a CLI gcloud como um auxiliar de credenciais do Docker.
• gcloud container clusters create: crie um cluster para executar contêineres do GKE.
• gcloud container clusters list: liste clusters para executar contêineres do GKE.
• gcloud container clusters get-credentials: atualize kubeconfig para receber kubectl para usar um cluster do GKE.
• gcloud container images list-tags: liste de metadados de resumo e tag de lista para uma imagem de contêiner.

Máquinas virtuais e Compute Engine

Crie, execute e gerencie VMs na infraestrutura do Google Cloud .

• gcloud compute zones list: liste zonas do Compute Engine.
• gcloud compute instances create: crie uma instância de VM.
• gcloud compute instances describe: exiba os detalhes de uma instância de VM.
• gcloud compute instances list: liste todas as instâncias da VM em um projeto.
• gcloud compute disks snapshot: crie um snapshot de discos permanentes.
• gcloud compute snapshots describe: exiba os detalhes de um snapshot.
• gcloud compute snapshots delete: exclua um snapshot.
• gcloud compute ssh: conecte-se a uma instância de VM usando SSH.

Sem servidor e App Engine

Crie aplicativos altamente escalonáveis em uma plataforma totalmente gerenciada e sem servidor

• gcloud app deploy: implante o código e a configuração do aplicativo no servidor do App Engine.
• gcloud app versions list: liste todas as versões de todos os serviços implantados no servidor do App Engine.
• gcloud app browse: abra o app atual em um navegador da Web.
• gcloud app create: crie um aplicativo do App Engine no projeto atual.
• gcloud app logs read: exiba os registros de aplicativos mais recentes do App Engine.

Diversos

Comandos que podem ser úteis

• gcloud kms decrypt: descriptografar texto criptografado (para um arquivo de texto simples) usando uma chave do Cloud Key Management Service.
• gcloud logging logs list: liste os registros do projeto.
• gcloud sql backups describe: exiba informações sobre um backup de instância do Cloud SQL.
• gcloud sql export sql: exporte dados de uma instância do Cloud SQL para um arquivo SQL.

Primer de introdução

Uma rápida introdução para começar a usar a CLI gcloud.

Como instalar a Google Cloud CLI

Instale a Google Cloud CLI seguindo estas instruções de instalação.

Sinalizações, argumentos e outras adições incríveis

Os argumentos podem ser posicionais ou flags:

• Argumentos posicionais: definidos após o nome do comando. Precisam respeitar a ordem dos argumentos posicionais.

• Sinalizações: definidas após argumentos posicionais. A ordem das sinalizações não importa.

  Uma sinalização pode ser:

  • Par de nome-valor (--foo=bar) ou