Algumas ou todas as informações nesta página podem não se aplicar à Trusted Cloud by S3NS. Consulte o artigo Diferenças em relação ao Google Cloud para mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

gcloud compute

A CLI do Google Cloud permite-lhe gerir os recursos do Compute Engine através do grupo de comandos gcloud compute. gcloud compute é uma alternativa à utilização da API Compute Engine.

A CLI gcloud faz parte da CLI Google Cloud e é uma ferramenta de linha de comando unificada que inclui funcionalidades como o preenchimento automático de declarações, a atualização no local, a ajuda da linha de comando, formatos de saída legíveis e analisáveis por máquina, e a integração com a CLI Google Cloud.

Se nunca usou o Compute Engine, comece com o guia de início rápido do Linux ou o guia de início rápido do Windows.

Antes de começar

Se quiser executar o comando gcloud compute numa linha de comandos, instale, atualize e inicialize a CLI Google Cloud.
Se não tiver uma linha de comandos disponível, experimente usar o comando gcloud compute no Cloud Shell. O Cloud Shell é instalado, atualizado e inicializado automaticamente com a versão mais recente da CLI Google Cloud.

Propriedades predefinidas

Quando cria uma instância de máquina virtual, o Compute Engine configura uma VM com as propriedades predefinidas do servidor de metadados. Pode verificar as propriedades predefinidas da VM executando o seguinte comando:

gcloud compute project-info describe --project PROJECT_ID

Substitua PROJECT_ID pelo ID do seu projeto.

Projeto predefinido

Se definir um projeto predefinido quando configurar e inicializar a CLI do Google Cloud, todos os comandos gcloud compute usam esse ID do projeto por predefinição.

Pode substituir o ID do projeto predefinido através de um dos seguintes métodos:

Execute cada comando gcloud compute com a flag --project
Defina a variável de ambiente CLOUDSDK_CORE_PROJECT
Linux e macOS
Use o comando export para definir a variável do ambiente do projeto.
```
export CLOUDSDK_CORE_PROJECT=PROJECT_ID
```
Substitua PROJECT_ID pelo ID do projeto que quer usar como predefinição.

Anular a definição das variáveis de ambiente do projeto

Se precisar de anular a definição das variáveis do ambiente do projeto, use os seguintes comandos unset:
```
unset CLOUDSDK_CORE_PROJECT
```
Windows
Use o comando set para definir a variável do ambiente do projeto.
```
set CLOUDSDK_CORE_PROJECT=PROJECT_ID
```
Substitua PROJECT_ID pelo ID do projeto que quer usar como predefinição.

Anular a definição das variáveis de ambiente do projeto

Se precisar de anular a definição das variáveis de ambiente do projeto, use o seguinte comando:
```
set CLOUDSDK_CORE_PROJECT=
```

Se não definir um projeto predefinido ou uma variável de ambiente, tem de incluir uma flag --projectgcloud compute em cada comando gcloud compute que executar.

Região e zona predefinidas

Alguns comandos gcloud compute requerem as flags --region ou --zone. Em vez de especificar estas flags sempre que executar comandos, pode definir uma região e uma zona predefinidas para o seu projeto. Se não definir uma região ou uma zona predefinida e executar um comando dependente da região ou da zona, a CLI Google Cloud pode pedir-lhe que forneça uma flag --region ou --zone, ou devolver um erro.

Pode definir a região e a zona predefinidas de três formas:

No servidor de metadados. A região e a zona predefinidas definidas no servidor de metadados são aplicadas ao seu cliente local quando executa gcloud init.
No seu cliente local. A região e a zona predefinidas definidas no cliente local substituem a região e a zona predefinidas definidas no servidor de metadados.
Nas variáveis de ambiente. A região e a zona predefinidas definidas nas variáveis de ambiente substituem a região e a zona predefinidas definidas no cliente local e no servidor de metadados.

Pode substituir a região e a zona predefinidas no servidor de metadados, no cliente local ou nas variáveis de ambiente, fornecendo as flags --region e --zone quando executa comandos.

Veja a região e a zona predefinidas

Para ver a sua região e zona predefinidas, execute os seguintes comandos:

gcloud config get-value compute/region

gcloud config get-value compute/zone

Se o resultado for (unset), não é definida nenhuma região nem zona predefinida.

Veja as regiões e as zonas disponíveis

Pode ver uma lista de regiões e zonas executando os seguintes comandos:

gcloud compute regions list

gcloud compute zones list

Defina a região e a zona predefinidas no servidor de metadados

A região e a zona predefinidas no servidor de metadados aplicam-se a todas as configurações no seu projeto. Para definir a região e a zona predefinidas no servidor de metadados, faça o seguinte:

Defina a região e a zona predefinidas:

gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=REGION,google-compute-default-zone=ZONE

Por exemplo:

gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b

Inicialize a alteração no seu cliente local:
```
gcloud init
```

Pode substituir a região e a zona predefinidas definidas no servidor de metadados definindo a região e a zona predefinidas no seu cliente local, definindo a região e a zona predefinidas nas variáveis de ambiente ou incluindo a flag --zone ou --region nos seus comandos.

Anule a definição da região e da zona predefinidas no servidor de metadados

Para anular a definição da região e da zona predefinidas no servidor de metadados, faça o seguinte:

Metadados não definidos:

gcloud compute project-info remove-metadata \
   --keys=google-compute-default-region,google-compute-default-zone

Inicialize a alteração no seu cliente local:
```
gcloud init
```

Defina a região e a zona predefinidas no cliente local

A região e a zona predefinidas definidas no cliente local substituem a região e a zona predefinidas definidas no servidor de metadados.

Para definir a região e a zona predefinidas no cliente local, execute os seguintes comandos:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Anule a definição da região e da zona predefinidas no cliente local

Para anular a definição da região ou da zona predefinida no seu cliente local, execute os seguintes comandos:

gcloud config unset compute/zone

gcloud config unset compute/region

Pode substituir a região e a zona predefinidas definidas no seu cliente local definindo a região e a zona predefinidas nas variáveis de ambiente ou incluindo a flag --zone ou --region nos seus comandos.

Defina a região e a zona predefinidas nas variáveis de ambiente

A região e a zona predefinidas definidas nas variáveis de ambiente substituem a região e a zona predefinidas definidas no cliente local e no servidor de metadados.

Linux e macOS

Use o comando export para definir as variáveis de região e zona.

export CLOUDSDK_COMPUTE_REGION=REGION

export CLOUDSDK_COMPUTE_ZONE=ZONE

Para tornar estas variáveis de ambiente permanentes, inclua estes comandos no ficheiro ~/.bashrc e reinicie o terminal.

Windows

Use o comando set para definir as variáveis de região e zona.

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

Pode substituir as variáveis de ambiente incluindo a flag --zone ou --region nos seus comandos.

Anule a definição da região e da zona predefinidas nas variáveis de ambiente

Use os seguintes comandos para anular a definição da região e da zona predefinidas nas variáveis de ambiente.

Linux e macOS

Para anular a definição das variáveis de ambiente de região e zona, use os seguintes unset comandos:

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

Para anular a definição das variáveis de ambiente da região e da zona, use os seguintes comandos:

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

Substitua a zona predefinida por flags

Use a flag --zone para substituir a zona predefinida definida no servidor de metadados, no cliente local e nas variáveis de ambiente.

Por exemplo:

gcloud compute instances create example-instance \
    --zone=ZONE

Configurações

gcloud topic configurations são uma funcionalidade avançada que pode usar para influenciar o comportamento da CLI gcloud. Para a maioria dos utilizadores, a utilização das configurações predefinidas é suficiente.

As configurações podem ser úteis para os utilizadores que:

Trabalhe com vários projetos. Pode criar uma configuração separada para cada projeto.
Use várias contas. Por exemplo, uma conta de utilizador e uma conta de serviço.
Realizar várias tarefas independentes (trabalhar numa app do App Engine num projeto, administrar um cluster do Compute Engine na zona us-central-1a, gerir as configurações de rede para a região asia-east-1, etc.)

Para alternar entre configurações, execute o seguinte comando:

gcloud config configurations activate CONFIGURATION_NAME

Para mais informações sobre a gestão de configurações, consulte gcloud config configurations.

O que se segue?

Siga o guia de início rápido para a CLI Google Cloud.
Reveja as sugestões de utilização de gcloud compute.
Descubra os comandos gcloud computecomuns.