computação gcloud

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A CLI do Google Cloud permite gerenciar os recursos do Compute Engine usando o grupo de comandos gcloud compute . gcloud compute é uma alternativa ao uso da API Compute Engine.

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

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

Antes de começar

• Se você quiser executar gcloud compute em um prompt de comando, instale, atualize e inicialize a CLI do Google Cloud .
• Se você não tiver um prompt de comando disponível, tente usar gcloud compute no Cloud Shell . O Cloud Shell é instalado, atualizado e inicializado automaticamente com a Google Cloud CLI mais recente.

Propriedades padrão

Quando você cria uma instância de máquina virtual, o Compute Engine configura uma VM usando propriedades padrão do servidor de metadados . Você pode verificar as propriedades padrão da sua VM executando o seguinte comando:

gcloud compute project-info describe --project PROJECT_ID

Substitua PROJECT_ID pelo ID do seu projeto.

Projeto padrão

Se você definir um projeto padrão ao configurar e inicializar a CLI do Google Cloud, todos os comandos gcloud compute usarão esse ID do projeto por padrão.

Você pode substituir o ID do projeto padrão usando um dos seguintes métodos:

• Execute cada comando gcloud compute com a sinalização --project

• Defina a variável de ambiente CLOUDSDK_CORE_PROJECT

  Linux e macOS

  Use o comando export para definir a variável de ambiente do projeto.

  export CLOUDSDK_CORE_PROJECT=PROJECT_ID
  

  Substitua PROJECT_ID pelo ID do projeto que você deseja usar como padrão.

  Desativando variáveis ​​de ambiente do projeto

  Se você precisar remover a configuração das variáveis ​​de ambiente do seu projeto, use os seguintes comandos unset :

  unset CLOUDSDK_CORE_PROJECT
  

  Windows

  Use o comando set para definir a variável de ambiente do projeto.

  set CLOUDSDK_CORE_PROJECT=PROJECT_ID
  

  Substitua PROJECT_ID pelo ID do projeto que você deseja usar como padrão.

  Desativando variáveis ​​de ambiente do projeto

  Se você precisar remover a configuração das variáveis ​​de ambiente do seu projeto, use o seguinte comando:

  set CLOUDSDK_CORE_PROJECT=
  

Se você não definir um projeto padrão ou uma variável de ambiente, deverá incluir uma sinalização --project em cada comando gcloud compute executado.

Região e zona padrão

Alguns comandos gcloud compute exigem sinalizadores --region ou --zone . Em vez de especificar esses sinalizadores sempre que executar comandos, você pode definir uma região e zona padrão para seu projeto. Se você não definir uma região ou zona padrão e executar um comando dependente de região ou zona, a CLI do Google Cloud poderá solicitar que você forneça uma sinalização --region ou --zone ou retornar um erro.

Você pode definir a região e zona padrão de três maneiras:

• No servidor de metadados . A região e a zona padrão definidas no servidor de metadados são aplicadas ao cliente local quando você executa gcloud init .
• No seu cliente local . A região e a zona padrão definidas no cliente local substituem a região e a zona padrão definidas no servidor de metadados.
• Em variáveis ​​de ambiente . A região e a zona padrão definidas nas variáveis ​​de ambiente substituem a região e a zona padrão definidas no cliente local e no servidor de metadados.

Você pode substituir a região e a zona padrão no servidor de metadados, no cliente local ou em variáveis ​​de ambiente, fornecendo sinalizadores --region e --zone ao executar comandos.

Ver região e zona padrão

Para visualizar sua região e zona padrão, execute os seguintes comandos:

gcloud config get-value compute/region

gcloud config get-value compute/zone

Se a saída for (unset) , nenhuma região ou zona padrão será definida.

Ver regiões e zonas disponíveis

Você pode visualizar uma lista de regiões e zonas executando os seguintes comandos:

gcloud compute regions list

gcloud compute zones list

Definir região e zona padrão no servidor de metadados

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

1. Defina a região e zona padrão:

   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
   

2. Inicialize a mudança em seu cliente local:

   gcloud init

Você pode substituir a região e a zona padrão definidas no servidor de metadados definindo a região e a zona padrão em seu cliente local, definindo a região e a zona padrão em variáveis ​​de ambiente ou incluindo o sinalizador --zone ou --region em seus comandos.

Remover região e zona padrão no servidor de metadados

Para cancelar a configuração da região e zona padrão no servidor de metadados, faça o seguinte:

1. Metadados não definidos:

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

2. Inicialize a mudança em seu cliente local:

   gcloud init

Defina região e zona padrão em seu cliente local

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

Para definir a região e zona padrão em seu cliente local, execute os seguintes comandos:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Desconfigurar região e zona padrão em seu cliente local

Para cancelar a configuração da região ou zona padrão em seu cliente local, execute os seguintes comandos:

gcloud config unset compute/zone

gcloud config unset compute/region

Você pode substituir a região e a zona padrão definidas em seu cliente local definindo a região e a zona padrão em variáveis ​​de ambiente ou incluindo o sinalizador --zone ou --region em seus comandos.

Definir região e zona padrão em variáveis ​​de ambiente

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

export CLOUDSDK_COMPUTE_REGION=REGION

export CLOUDSDK_COMPUTE_ZONE=ZONE

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

Você pode substituir variáveis ​​de ambiente incluindo o sinalizador --zone ou --region em seus comandos.

Remover região e zona padrão em variáveis ​​de ambiente

Use os comandos a seguir para remover a configuração da região e zona padrão nas variáveis ​​de ambiente.

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

Substituir zona padrão por sinalizadores

Use o sinalizador --zone para substituir a zona padrão 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 um recurso avançado que você pode usar para influenciar o comportamento da CLI gcloud. Para a maioria dos usuários, usar configurações padrão é suficiente.

As configurações podem ser úteis para usuários que:

• Trabalhe com vários projetos. Você pode criar uma configuração separada para cada projeto.
• Use várias contas. Por exemplo, uma conta de usuário e uma conta de serviço.
• Execute diversas tarefas independentes (trabalhe em um aplicativo do App Engine em um projeto, administre um cluster do Compute Engine na zona us-central-1a, gerencie as configurações de rede da região asia-east-1 etc.).

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

gcloud config configurations activate CONFIGURATION_NAME

Para obter mais informações sobre como gerenciar configurações, consulte gcloud config configurations .

O que vem a seguir?

• Siga o guia de início rápido da CLI do Google Cloud.
• Revise as dicas de uso gcloud compute .
• Descubra comandos comuns gcloud compute .