Usar la CLI gdcloud

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

Este documento está dirigido a todos los grupos de audiencia que necesiten configurar la CLI dedicada de GDC para gestionar sus flujos de trabajo de hardware y software aislados. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Antes de empezar

  • 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 autoridad de certificación (AC) instalado en el almacén de certificados de confianza de tu sistema. Para obtener más información, consulta Obtener paquetes de confianza de GDC.

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

  • Confirma que tienes un navegador instalado en tu dispositivo.

Configurar la CLI gdcloud

Para configurar la CLI gdcloud, sigue estos pasos:

  1. Abre la consola de GDC introduciendo la URL global o de zona de tu organización en el navegador.

  2. En la página principal, selecciona Download CLI Bundle (Descargar paquete de la CLI).

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

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

  4. Haz clic en Descargar.

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

    cd ~/Downloads
    
  6. Extrae el contenido del paquete de la CLI gdcloud:

    tar -xf ./gdcloud_cli.tar.gz
    
  7. Añade el paquete de la CLI 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 gdcloud se ha instalado correctamente:

    gdcloud version
    

    El resultado debería ser similar al siguiente:

    gdcloud version: 1.15.0-gdch.380608
    
  9. Inicializa la CLI gdcloud:

    gdcloud init
    
  10. Proporciona las dos propiedades que se te solicitan para completar la inicialización:

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

    • project: el nombre de tu proyecto de GDC. Si no tienes ningún proyecto, usa default.

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

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

    gdcloud components install gdcloud-k8s-auth-plugin
    
  12. Autentícate con la CLI gdcloud para iniciar sesión:

    gdcloud auth login
    

    Se te redirigirá al navegador para que elijas tu identidad e inicies sesión.

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

    gdcloud compute images list
    

    El resultado debería ser similar al siguiente:

    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
    

Siguientes pasos