Comandos gcloud compute comuns

Este documento apresenta alguns dos comandos gcloud compute mais usados.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Trusted Cloud by S3NS serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

    1. Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init
    2. Set a default region and zone.

Descrever projetos

Execute o seguinte comando para consultar informações sobre o seu projeto do Compute Engine, como metadados do projeto, chaves SSH e métricas de quota:

 gcloud compute project-info describe

Para mais informações sobre como descrever o seu projeto, consulte a gcloud compute project-info describe documentação de referência.

Trabalhar com VMs

Os exemplos seguintes mostram tarefas comuns quando trabalha com instâncias de máquinas virtuais (VM). Para mais informações sobre instâncias de máquinas virtuais (VMs), consulte o artigo Instâncias de máquinas virtuais.

Criar VMs

Execute o seguinte comando para criar uma VM:

gcloud compute instances create VM_NAME \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    --image-project IMAGE_PROJECT

Substitua o seguinte:

  • VM_NAME: o nome da nova VM.
  • IMAGE ou IMAGE_FAMILY: Especifique uma das seguintes opções:
    • IMAGE: versão necessária de uma imagem pública. Por exemplo, --image debian-10-buster-v20200309.
    • IMAGE_FAMILY: uma família de imagens. Isto cria a VM a partir da imagem do SO mais recente e não descontinuada. Por exemplo, se especificar --image-family debian-10, o Compute Engine cria uma VM a partir da versão mais recente da imagem do SO na família de imagens Debian 10.
  • IMAGE_PROJECT: o projeto que contém a imagem.

Para mais informações sobre como criar VMs, consulte o artigo Criar e iniciar uma instância de VM e a gcloud compute instances create documentação de referência.

Listar VMs

Execute o seguinte comando para apresentar todas as VMs num projeto:

gcloud compute instances list

Para mais informações sobre como listar VMs, consulte a gcloud compute instances list documentação de referência.

Listar VMs com GPUs

Execute o seguinte comando para apresentar todas as VMs com GPUs num projeto:

gcloud compute instances list --filter="guestAccelerators.acceleratorCount>0" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Indicar VMs com SSDs locais

Execute o seguinte comando para apresentar todas as VMs com SSDs locais num projeto:

gcloud compute instances list  --filter="disks.type='SCRATCH'"  --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Descrever VMs

Execute o seguinte comando para apresentar todos os dados associados a uma VM:

gcloud compute instances describe VM_NAME

Substitua VM_NAME pelo nome da VM.

Para mais informações sobre a descrição de VMs, consulte a gcloud compute instances describe documentação de referência.

A iniciar VMs

Execute o seguinte comando para iniciar uma VM parada:

gcloud compute instances start VM_NAME

Substitua VM_NAME pelo nome da VM.

Para mais informações sobre como iniciar VMs, consulte os artigos Iniciar e parar uma instância e a gcloud compute instances start documentação de referência.

Parar VMs

Execute o seguinte comando para parar uma VM:

gcloud compute instances stop VM_NAME

Substitua VM_NAME pelo nome da VM.

Para mais informações sobre como parar VMs, consulte os artigos Iniciar e parar uma instância e a gcloud compute instances stop documentação de referência.

Adicionar etiquetas a VMs

Execute o seguinte comando para adicionar etiquetas a VMs:

gcloud compute instances add-labels VM_NAME \
    --labels=KEY=VALUE

Substitua o seguinte:

  • VM_NAME: o nome da VM.
  • KEY=VALUE: o par de chave-valor da etiqueta.

Para mais informações sobre a etiquetagem de VMs, consulte o artigo Etiquetar recursos e a gcloud compute instances add-labels documentação de referência.

Estabelecer ligação a VMs

Usar SSH para estabelecer ligação a instâncias

Execute o seguinte comando para se ligar a uma VM através de SSH:

gcloud compute ssh VM_NAME

Substitua VM_NAME pelo nome da VM.

Para mais informações sobre a ligação a VMs através do SSH, consulte o artigo Estabelecer ligação a VMs do Linux e a documentação de referência gcloud compute ssh.

Usar o SCP para transferir ficheiros para instâncias

Execute o seguinte comando para copiar ficheiros para uma VM:

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

Execute o seguinte comando para copiar ficheiros de uma VM:

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

Substitua o seguinte:

  • LOCAL_FILE_PATH: O caminho para o ficheiro na sua estação de trabalho.
  • VM_NAME: o nome da sua VM.
  • REMOTE_DIRECTORY: o caminho para o diretório na sua VM.

Para mais informações sobre a transferência de ficheiros para e a partir de VMs através do SCP, consulte o artigo Transferir ficheiros através da CLI Google Cloud e a documentação de referência gcloud compute scp.

Trabalhar com discos

O exemplo seguinte mostra uma tarefa comum quando trabalha com discos. Para mais informações sobre discos, consulte as opções de armazenamento.

Apresentar discos

Execute o seguinte comando para apresentar todos os discos num projeto:

gcloud compute disks list

Para mais informações sobre como listar discos, consulte a gcloud compute disks list documentação de referência.

Trabalhar com instantâneos

Os exemplos seguintes mostram tarefas comuns quando trabalha com instantâneos. Para mais informações sobre instantâneos, consulte o artigo Instantâneos do Persistent Disk.

Resumos de fichas

Execute o seguinte comando para apresentar todas as capturas de ecrã num projeto:

gcloud compute snapshots list

Para mais informações sobre a descrição de imagens instantâneas, consulte a gcloud compute snapshots list documentação de referência.

Descrever instantâneos

Execute o seguinte comando para apresentar todos os dados associados a uma captura de ecrã:

gcloud compute snapshots describe SNAPSHOT_NAME

Substitua SNAPSHOT_NAME pelo nome do instantâneo.

Para mais informações sobre a descrição de imagens instantâneas, consulte a gcloud compute snapshots describe documentação de referência.

Eliminar instantâneos

Execute o seguinte comando para eliminar uma captura de ecrã:

gcloud compute snapshots delete SNAPSHOT_NAME

Substitua SNAPSHOT_NAME pelo nome do instantâneo.

Para mais informações sobre a eliminação de capturas instantâneas, consulte o artigo Eliminar uma captura instantânea e a gcloud compute snapshots delete documentação de referência.

Trabalhar com regras de firewall

Os exemplos seguintes mostram tarefas comuns quando trabalha com regras de firewall. Para mais informações sobre as regras de firewall, consulte o artigo Vista geral das regras de firewall da VPC.

Descrever regras de firewall

Execute o seguinte comando para apresentar todos os dados associados a uma regra de firewall:

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

Substitua FIREWALL_RULE_NAME pelo nome da regra de firewall.

Para mais informações sobre a descrição das regras de firewall, consulte a gcloud compute firewall-rules describe documentação de referência.

Criar regras de firewall

Execute o seguinte comando para criar uma regra de firewall:

gcloud compute firewall-rules create FIREWALL_RULE_NAME \
    [--allow=PROTOCOL:PORT | --action=ACTION --rules=PROTOCOL:PORT]

Especifique --allow ou --action e --rules, e substitua o seguinte:

  • FIREWALL_RULE_NAME: o nome da regra de firewall.
  • ACTION: a ação na correspondência. allow ou deny.
  • PROTOCOL:PORT: o protocolo e a porta cujo tráfego será afetado pela regra de firewall.

Para mais informações sobre a criação de regras de firewall, consulte os artigos Criar regras de firewall e a gcloud compute firewall-rules create documentação de referência.

Trabalhar com grupos de instâncias geridas (MIGs)

Os exemplos seguintes mostram tarefas comuns quando trabalha com MIGs. Para mais informações sobre os GIGs, consulte o artigo Grupos de instâncias geridas (GIGs).

Criar grupos de instâncias geridas

Execute o seguinte comando para criar um MIG:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_URL

Substitua o seguinte:

  • INSTANCE_GROUP_NAME: o nome deste grupo de instâncias
  • SIZE: o tamanho do grupo de instâncias
  • INSTANCE_TEMPLATE_URL: o URL do modelo de instância que quer usar para criar VMs no MIG. O URL pode conter o ID ou o nome do modelo de instância. Especifique um dos seguintes valores:
    • Para um modelo de instância regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Para um modelo de instância global: INSTANCE_TEMPLATE_ID

Para mais informações sobre como criar MIGs, consulte os cenários básicos para criar um MIG e a gcloud compute instance-groups managed create documentação de referência.

Definir a escala automática

Execute o seguinte comando para definir a criação de uma escala automática numa GIG com base na utilização da CPU:

gcloud compute instance-groups managed set-autoscaling INSTANCE_GROUP_NAME \
    --max-num-replicas=MAX_NUM_REPLICAS \
    --target-cpu-utilization=TARGET_CPU_UTILIZATION

Substitua o seguinte:

  • INSTANCE_GROUP_NAME: o nome de um MIG
  • MAX_NUM_REPLICAS: o número máximo de réplicas que o escalador automático pode criar
  • TARGET_CPU_UTILIZATION: o nível da CPU que o escalador automático deve manter, entre 0.0 e 1.0

Para mais informações sobre como definir o dimensionamento automático, consulte o artigo Grupos de dimensionamento automático de instâncias e a documentação de referência gcloud compute instance-groups managed set-autoscaling.

Trabalhar com metadados

O exemplo seguinte mostra uma tarefa comum quando trabalha com metadados. Para mais informações sobre metadados, consulte Armazenar e obter metadados.

Adicionar metadados ao nível do projeto

Execute o seguinte comando para adicionar metadados ao seu projeto:

gcloud compute project-info add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Substitua o seguinte:

  • VM_NAME: o nome da VM
  • KEY=VALUE: o par de chave-valor de metadados

Para mais informações sobre como adicionar metadados a VMs, consulte os artigos Definir metadados personalizados ao nível do projeto e a documentação de referência gcloud compute project-info add-metadata.

Adicionar metadados ao nível da instância

Execute o seguinte comando para adicionar metadados a uma VM:

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Substitua o seguinte:

  • VM_NAME: o nome da VM
  • KEY=VALUE: o par de chave-valor de metadados

Para mais informações sobre como adicionar metadados a VMs, consulte os artigos Definir metadados de instâncias e a gcloud compute instances add-metadata documentação de referência.

Páginas de ajuda

Os comandos seguintes mostram como aceder a diferentes tipos de ajuda, desde ajuda geral sobre o comando gcloud compute até ajuda específica sobre um grupo de recursos (instances) ou um comando (create). A ajuda abrangente para todos os recursos e comandos segue este padrão:

gcloud compute --help
 
gcloud compute instances --help
 
gcloud compute instances create --help

Pode obter ajuda rápida usando a flag -h em vez da flag --help. Também pode rever toda a ajuda abrangente na referência da CLI do Google Cloud.

Para obter ajuda abrangente com comandos especificamente para configurar a CLI gcloud, execute:

gcloud topic TOPIC

Substitua TOPIC pelo tópico para o qual quer receber ajuda. Para ver uma lista de tópicos para os quais pode receber ajuda, consulte a documentação de referência gcloud topic.

O que se segue?