Usar a CLI gdcloud

A CLI gdcloud é um conjunto de ferramentas para criar e gerenciar recursos com isolamento físico do Google Distributed Cloud (GDC). Use essas ferramentas para realizar tarefas comuns pela linha de comando ou por scripts e automação. A CLI gdcloud permite inicializar a infraestrutura, gerenciar a autenticação e personalizar as configurações locais.

Este documento é destinado a todos os grupos de público-alvo que precisam configurar a CLI dedicada do GDC para gerenciar os fluxos de trabalho de hardware e software com isolamento físico. Para mais informações, consulte Públicos-alvo da documentação do GDC com isolamento físico.

Antes de começar

  • Confirme que você tem acesso ao console do GDC e anote o URL da sua organização. Para mais informações, consulte Acesso ao console do GDC.

  • Confirme se você tem um certificado de autoridade certificadora (CA) instalado no repositório de certificados confiáveis do sistema. Para mais informações, consulte Buscar pacotes de confiança do GDC.

  • Verifique se você tem uma política de rede da organização que permite o tráfego de um CIDR específico fora da organização para o Artifact Registry. Por exemplo, configure o nome do serviço all no recurso OrganizationNetworkPolicy. Para mais informações, consulte Criar políticas de rede da organização.

  • Confirme se você tem um navegador instalado no dispositivo.

Configurar a CLI gdcloud

Para configurar a CLI gdcloud, faça o seguinte:

  1. Abra o console do GDC inserindo o URL global ou zonal da sua organização no navegador.

  2. Na página inicial, selecione Fazer o download do pacote da CLI.

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

    Ao escolher plataformas que não são Linux, as etapas de configuração podem variar um pouco. Além disso, alguns pacotes da CLI gdcloud que não são do Linux fornecem apenas um subconjunto de comandos. Para mais informações, consulte Pacotes disponíveis da CLI gdcloud.

  4. Clique em Fazer download.

  5. No seu dispositivo, navegue até a pasta Downloads:

    cd ~/Downloads

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

    tar -xf ./gdcloud_cli.tar.gz

  7. Adicione o pacote da CLI gdcloud ao 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 gdcloud está instalada corretamente:

    gdcloud version

    O resultado será o seguinte:

    gdcloud version: 1.15.0-gdch.380608

  9. Inicialize a CLI gdcloud:

    gdcloud init

  10. Forneça as duas propriedades solicitadas para concluir a inicialização:

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

    • project: o nome do projeto do GDC. Se você não tiver um projeto, use default.

    Para atualizar as configurações da CLI gdcloud após a inicialização, consulte Gerenciar configurações da CLI gdcloud.

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

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Faça a autenticação com a CLI gdcloud para fazer login:

    gdcloud auth login

    Você será redirecionado ao navegador para escolher sua identidade e fazer login.

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

    gdcloud compute images list

    O resultado será o 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

A seguir