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 gcloud te permite iniciar la infraestructura, administrar la autenticación y personalizar las configuraciones locales.

Este documento está dirigido 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 autoridad certificadora (CA) instalado en el almacén de certificados de confianza de tu sistema. Para obtener más información, consulta Cómo recuperar 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 gcloud

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

  1. Abre la consola de GDC ingresando 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 Linux y la versión del paquete de CLI de gdcloud que corresponda a tu entorno de GDC.

    Cuando elijas plataformas que no sean 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 gdcloud CLI.

  4. Haz clic en Descargar.

  5. Desde 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 lo siguiente:

    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: 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 la configuración de la gdcloud CLI después de la inicialización, consulta Administra la configuración de la gdcloud CLI.

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

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Autentícate 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 tu gdcloud CLI esté conectada a tu entorno de GDC:

    gdcloud compute images list

    El resultado es similar a lo 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

¿Qué sigue?