A referência rápida da CLI gcloud

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

(Também incluído: introdução básica, compreender os comandos e um PDF imprimível.)

Referência rápida

Começar

Comece a usar a CLI gcloud.

Ajuda

A CLI gcloud tem todo o gosto em ajudar.

  • gcloud help: pesquise os documentos de referência da CLI gcloud para encontrar termos específicos.
  • gcloud feedback: envie feedback à equipa da CLI gcloud.
  • gcloud topic: material de ajuda suplementar para tópicos que não envolvem comandos, como acessibilidade, filtragem e formatação.

Personalização

Personalize a CLI gcloud; personalize a sua configuração com propriedades.

Autorização e credenciais

Conceder e revogar a autorização da CLI gcloud e gerir credenciais.

Projetos

Faça a gestão das políticas de acesso ao projeto.

IAM

Configurar as preferências e as contas de serviço da gestão de identidade e de acesso (IAM).

Docker e Google Kubernetes Engine (GKE)

Faça a gestão de aplicações contentorizadas no Kubernetes.

Máquinas virtuais e Compute Engine

Crie, execute e faça a gestão de VMs na Google Cloud infraestrutura.

Sem servidor e App Engine

Crie aplicações altamente escaláveis numa plataforma sem servidor totalmente gerida

Diversos

Comandos que podem ser úteis

Guia introdutório

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

Instalar a CLI do Google Cloud

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

Flags, argumentos e outras adições maravilhosas

Os argumentos podem ser argumentos posicionais ou flags:

  • Argumentos posicionais: definidos após o nome do comando; têm de respeitar a ordem dos argumentos posicionais.

  • Flags: definidas após os argumentos posicionais; a ordem das flags não é importante.

    Uma denúncia pode ser:

    • Par nome-valor (--foo=bar) ou
    • Booleano (--force/no-force).

    Além disso, as denúncias podem ser:

    • Obrigatório
    • Opcional: se um sinalizador opcional não estiver definido, é usado o valor predefinido

Sinalizações globais

Algumas flags estão disponíveis em toda a experiência da CLI gcloud, como:

  • --help: para quando tiver dúvidas; apresenta ajuda detalhada para um comando.
  • --project: se estiver a usar um projeto que não seja o atual.
  • --quiet: desativar os pedidos interativos (e aplicar valores predefinidos para as entradas).
  • --verbosity: Pode definir níveis de detalhe em debug, info, warning, error, critical e none.
  • --version: Apresenta informações da versão do gcloud.
  • --format: defina o formato de saída como config, csv, default, diff, disable, flattened, get, json, list, multi, none, object, table, text, value, ou yaml.

Limpar resultados

Tire o máximo partido da saída com as flags filter, format, limit e sort-by.

Para instâncias do Compute Engine com o prefixo us e não o tipo de máquinaf1-micro:

gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"

Para uma lista de projetos criados a 15 de janeiro de 2018 ou após essa data, ordenados do mais antigo para o mais recente, apresentada como uma tabela com o número do projeto, o ID do projeto e as colunas de hora de criação com datas e horas no fuso horário local:

gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime

Para uma lista de dez instâncias do Compute Engine com uma etiqueta my-label (de qualquer valor):

gcloud compute instances list --filter="labels.my-label:*" --limit=10

Compreender os comandos

Os padrões subjacentes para comandos da CLI gcloud; para ajudar na autodescoberta de comandos.

Encontrar comandos da CLI gcloud

A CLI gcloud é uma árvore. Os nós não terminais são grupos de comandos e os nós terminais são comandos. (Além disso, a conclusão automática com a tecla Tab funciona para comandos e recursos!)

A maioria dos comandos gcloud segue o seguinte formato:

gcloud + release level (optional) + component + entity + operation + positional args + flags

Por exemplo: gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a

Nível de lançamento

O nível de lançamento refere-se ao estado de lançamento do comando.

Exemplo: alpha para comandos alfa, beta para comandos beta e nenhum nível de lançamento necessário para comandos DG.

Componente

Componente refere-se aos diferentes Google Cloud serviços.

Exemplo: compute para o Compute Engine, app para o App Engine, etc.

Entidade

Entidade refere-se à forma plural de um elemento ou uma coleção de elementos num componente.

Exemplo: disks, firewalls, images, instances, regions, zones para computação

Operação

Operação refere-se à forma verbal imperativa da operação a ser realizada na entidade.

Exemplo: as operações comuns são describe, list, create/update, delete/clear, import, export, copy, remove, add, reset, restart, restore, run e deploy.

Positional args

Os argumentos posicionais referem-se aos argumentos necessários e específicos da ordem necessários para executar o comando.

Exemplo: <INSTANCE_NAMES> é o argumento posicional obrigatório para gcloud compute instances create.

Bandeiras

As flags referem-se aos argumentos adicionais, --flag-name(=value), transmitidos ao comando após os argumentos posicionais.

Exemplo: --machine-type=<MACHINE_TYPE> e --preemptible são flags opcionais para gcloud compute instances create.