Folha de dicas do gcloud CLI

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

(Também incluído: introdução , compreensão de comandos e um PDF para impressão .)

Folha de dicas

Começando

Comece com o gcloud CLI.

Ajuda

O gcloud CLI ficará feliz em ajudar.

  • gcloud help : pesquise termos específicos nos documentos de referência da CLI do gcloud.
  • gcloud feedback : Forneça feedback à equipe do gcloud CLI.
  • gcloud topic : Material de ajuda suplementar para tópicos não relacionados a comandos, como acessibilidade, filtragem e formatação.

Personalização

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

Autorização e Credenciais

Conceda e revogue autorização para o gcloud CLI e gerencie credenciais.

Projetos

Gerenciar políticas de acesso ao projeto.

EU SOU

Configurando preferências e contas de serviço do Identity and Access Management (IAM).

Docker e Google Kubernetes Engine (GKE)

Gerencie aplicativos em contêineres no Kubernetes.

Máquinas Virtuais e Mecanismo de Computação

Crie, execute e gerencie VMs em Google Cloud infraestrutura.

Sem servidor e App Engine

Crie aplicativos altamente escaláveis ​​em uma plataforma sem servidor totalmente gerenciada

Variado

Comandos que podem ser úteis

Introdução

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

Instalando o Google Cloud CLI

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

Bandeiras, argumentos e outras adições maravilhosas

Os argumentos podem ser argumentos posicionais ou sinalizadores:

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

  • Sinalizadores: definidos após argumentos posicionais; a ordem dos sinalizadores não importa.

    Uma bandeira pode ser:

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

    Além disso, as bandeiras podem ser:

    • Obrigatório
    • Opcional: Se um sinalizador opcional não for definido, o valor padrão será usado

Bandeiras globais

Alguns sinalizadores estão disponíveis em toda a experiência do gcloud CLI, como:

  • --help : Em caso de dúvida; exibe ajuda detalhada para um comando.
  • --project : Se estiver usando um projeto diferente do atual.
  • --quiet : desabilitando o prompt interativo (e aplicando valores padrão para entradas).
  • --verbosity : pode definir níveis de verbosidade em debug , info , warning , error , critical e none .
  • --version : Exibe informações da versão gcloud .
  • --format : define o formato de saída como config , csv , default , diff , disable , flattened , get , json , list , multi , none , object , table , text , value ou yaml .

Resultados de limpeza

Aproveite ao máximo sua saída com os sinalizadores filter , format , limit e sort-by .

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

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

Para uma lista de projetos criados em ou após 15 de janeiro de 2018, classificados do mais antigo para o mais novo, apresentados como uma tabela com colunas de número do projeto, ID do projeto e hora de criação com datas e horários 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 obter uma lista de dez instâncias do Compute Engine com um rótulo my-label (de qualquer valor):

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

Compreendendo comandos

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

Encontrando comandos CLI do gcloud

A CLI do gcloud é uma árvore; nós não-folha são grupos de comandos e nós-folha são comandos. (Além disso, a conclusão por tabulação 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 liberação

Nível de liberação refere-se ao status de liberação do comando.

Exemplo: alpha para comandos alfa, beta para comandos beta, nenhum nível de versão necessário para comandos GA.

Componente

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

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

Entidade

Entidade refere-se ao plural de um elemento ou coleção de elementos sob um componente.

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

Operação

Operação refere-se ao modo verbal imperativo da operação a ser executada na entidade.

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

Argumentos posicionais

Argumentos posicionais referem-se aos argumentos específicos da ordem necessária para executar o comando.

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

Bandeiras

Os sinalizadores referem-se aos argumentos adicionais, --flag-name(=value) , passados ​​ao comando após os argumentos posicionais.

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