Usa la CLI de gcloud

La CLI de gdcloud es un conjunto de herramientas para crear y administrar recursos aislados de Google Distributed Cloud (GDC). Usa estas herramientas para realizar tareas comunes desde la línea de comandos o a través de secuencias de comandos y automatización. La CLI de gdcloud te permite iniciar la infraestructura, administrar la autenticación y personalizar las configuraciones locales.

Este documento está destinado a todos los grupos de público que necesitan configurar la CLI dedicada de GDC para administrar sus flujos de trabajo de hardware y software aislados. Para obtener más información, consulta Públicos de la documentación de Google Distributed Cloud aislado.

Antes de comenzar

  • Confirma que tienes acceso a la consola de GDC y anota la URL de tu organización. Para obtener más información, consulta Acceso a la consola de GDC.

  • Confirma que tienes un certificado de la Autoridad certificadora (AC) instalado en el almacén de certificados de confianza de tu sistema. Para obtener más información, consulta Recupera paquetes de confianza de GDC.

  • Verifica que tengas una política de red de la organización que permita el tráfico desde un CIDR específico fuera de tu organización al registro de artefactos. Por ejemplo, configura el nombre del servicio all en el recurso OrganizationNetworkPolicy. Para obtener más información, consulta Crea políticas de red de la organización.

  • Confirma que tienes un navegador instalado en tu dispositivo.

Configura la CLI de gdcloud

Para configurar la CLI de gdcloud, completa los siguientes pasos:

  1. Para abrir la consola de GDC, ingresa la URL global o zonal de tu organización en el navegador.

  2. En la página principal, selecciona Download CLI Bundle.

  3. Selecciona la plataforma de Linux y la versión del paquete de la CLI de gdcloud que corresponde a tu entorno de GDC.

    Cuando elijas plataformas que no sean de Linux, los pasos de configuración pueden variar ligeramente. También ten en cuenta que algunos paquetes de la CLI de gdcloud que no son de Linux solo proporcionan un subconjunto de comandos de gdcloud. Para obtener más información, consulta Paquetes disponibles de la CLI de gdcloud.

  4. Haz clic en Descargar.

  5. En tu dispositivo, navega a la carpeta Downloads:

    cd ~/Downloads

  6. Extrae el contenido del paquete de la CLI de gdcloud:

    tar -xf ./gdcloud_cli.tar.gz

  7. Agrega el paquete de la CLI de gdcloud a tu ruta:

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

  8. Confirma que la CLI de gdcloud esté instalada correctamente:

    gdcloud version

    El resultado es similar a este:

    gdcloud version: 1.15.0-gdch.380608

  9. Inicializa la CLI de gdcloud:

    gdcloud init

  10. Proporciona las dos propiedades solicitadas para completar la inicialización:

    • organization_console_url: Es la URL de la consola de tu organización actual de GDC. Esta URL puede ser global o zonal. Por ejemplo, https://console.org-1.google.gdch.test/.

    • project: Es el nombre de tu proyecto de GDC. Si no tienes un proyecto existente, usa default.

    Para actualizar las configuraciones de la CLI de gdcloud después de la inicialización, consulta Administra las configuraciones de la CLI de gdcloud.

  11. Instala el componente gdcloud-k8s-auth-plugin:

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Autentica con la CLI de gdcloud para acceder:

    gdcloud auth login

    Se te redireccionará al navegador para que elijas tu identidad y accedas.

  13. Confirma que la configuración de la CLI de gdcloud esté conectada a tu entorno de GDC:

    gdcloud compute images list

    El resultado es similar a este:

    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

¿Qué sigue?