Usar la CLI gdcloud

La CLI gdcloud es un conjunto de herramientas para crear y gestionar recursos air-gapped de Google Distributed Cloud (GDC). Usa estas herramientas para realizar tareas comunes desde la línea de comandos o mediante secuencias de comandos y automatizaciones. La CLI de gdcloud te permite inicializar 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 específica de GDC para gestionar sus flujos de trabajo de hardware y software aislados. Para obtener más información, consulta Audiencias de la documentación aislada de GDC.

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 (CA) 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 del servicio all en el recurso OrganizationNetworkPolicy. Para obtener más información, consulta el artículo Crear políticas de red de la organización.

  • Confirma que tienes un navegador instalado en tu dispositivo.

Configurar la CLI gdcloud

Para configurar la CLI de gdcloud, haz lo siguiente:

  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 Descargar paquete de CLI.

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

    Si eliges plataformas que no sean Linux, los pasos de configuración pueden variar ligeramente. 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 de 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 de 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 piden 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 gdcloud después de la inicialización, consulta Gestionar las configuraciones de la CLI 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 la 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