Use a CLI gcloud

A CLI gdcloud é um conjunto de ferramentas para criar e gerir recursos isolados do Google Distributed Cloud (GDC). Use estas ferramentas para realizar tarefas comuns a partir da linha de comandos ou através de scripts e automatização. A CLI gdcloud permite-lhe iniciar a infraestrutura, gerir a autenticação e personalizar as configurações locais.

Este documento destina-se a todos os grupos de públicos-alvo que precisam de configurar a CLI dedicada do GDC para gerir os respetivos fluxos de trabalho de hardware e software isolados. Para mais informações, consulte a documentação sobre públicos-alvo para GDC com isolamento de ar.

Antes de começar

  • Confirme que tem acesso à consola GDC e tome nota do URL da sua organização. Para mais informações, consulte o artigo Acesso à consola do GDC.

  • Confirme que tem um certificado da autoridade de certificação (AC) instalado na loja de certificados fidedignos do seu sistema. Para mais informações, consulte o artigo Obtenha pacotes de fidedignidade do GDC.

  • Verifique se tem uma política de rede da organização que permita o tráfego de um CIDR específico fora da sua organização para o registo de artefactos. Por exemplo, configure o nome do serviço all no recurso OrganizationNetworkPolicy. Para mais informações, consulte o artigo Crie políticas de rede da organização.

  • Confirme que tem um navegador instalado no dispositivo.

Configure a CLI gcloud

Para configurar a CLI gcloud, conclua o seguinte:

  1. Abra a consola GDC introduzindo o URL global ou zonal da sua organização no navegador.

  2. Na página inicial, selecione Transferir pacote da CLI.

  3. Selecione a plataforma Linux e a versão do pacote da CLI gdcloud que corresponde ao seu ambiente GDC.

    Quando escolhe plataformas que não sejam Linux, os passos de configuração podem variar ligeiramente. Tenha também em atenção que alguns pacotes da CLI gdcloud não pertencentes ao Linux só fornecem um subconjunto de comandos gdcloud. Para mais informações, consulte Pacotes da CLI gdcloud disponíveis.

  4. Clique em Transferir.

  5. No dispositivo, navegue para a pasta Downloads:

    cd ~/Downloads

  6. Extraia o conteúdo do pacote da CLI gcloud:

    tar -xf ./gdcloud_cli.tar.gz

  7. Adicione o pacote da CLI gcloud ao seu caminho:

    eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc
echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

  8. Confirme se a CLI gcloud está instalada corretamente:

    gdcloud version

    O resultado é semelhante ao seguinte:

    gdcloud version: 1.15.0-gdch.380608

  9. Inicialize a CLI gcloud:

    gdcloud init

  10. Indique as duas propriedades pedidas para concluir a inicialização:

    • organization_console_url: o URL da consola da sua organização do GDC atual. Este URL pode ser global ou zonal. Por exemplo, https://console.org-1.google.gdch.test/.

    • project: o nome do seu projeto do GDC. Caso não tenha um projeto existente, use default.

    Para atualizar as configurações da CLI gcloud após a inicialização, consulte o artigo Gerir configurações da CLI gcloud.

  11. Instale o componente gdcloud-k8s-auth-plugin:

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Autentique com a CLI gcloud para iniciar sessão:

    gdcloud auth login

    É feito o redirecionamento para o navegador para escolher a sua identidade e iniciar sessão.

  13. Confirme se a configuração da CLI gdcloud está ligada ao seu ambiente GDC:

    gdcloud compute images list

    O resultado é semelhante ao seguinte:

    METADATA.NAME               METADATA.NAMESPACE SPEC.OPERATINGSYSTEM.NAME SPEC.MINIMUMDISKSIZE
rocky-8-v20250809-gdch      vm-system          rocky-linux-8             12G
ubuntu-20.04-v20250809-gdch vm-system          ubuntu-2004               12G
ubuntu-22.04-v20250809-gdch vm-system          ubuntu-2204               12G
ubuntu-24.04-v20250809-gdch vm-system          ubuntu-2404               12G

O que se segue?