Configurar la CLI de gdcloud

En esta página se ofrece una descripción general de la CLI de Distributed Cloud y se explica cómo descargarla y configurarla para usarla con el entorno aislado de GDC.

Información general sobre la CLI de gdcloud

La CLI de gdcloud es un conjunto de herramientas para crear y gestionar recursos air-gapped de Google Distributed Cloud (GDC). Solo está disponible para Linux. Usa estas herramientas para realizar tareas comunes desde la línea de comandos o mediante secuencias de comandos y automatizaciones. La CLI de gdcloud se puede usar para iniciar la infraestructura, gestionar la autenticación y personalizar las configuraciones locales. Ten en cuenta que es diferente de la CLI gcloud que se usa para gestionarGoogle Cloud.

Esta página contiene instrucciones simplificadas específicas del entorno de pruebas de GDC. Para obtener más información sobre la herramienta de línea de comandos gdcloud en general, incluida la configuración, la actualización, la función Autocompletar y la accesibilidad, consulta la documentación de gdcloudGDC air-gapped.

Descargar la CLI de gdcloud

Sigue estas instrucciones si te conectas al sandbox de GDC mediante sshuttle. Si te conectas a la pasarela de tu instancia a través de Escritorio remoto, no es necesario que descargues la herramienta, ya que gdcloud está preinstalada en la máquina de la pasarela en la ruta /usr/share/gdcloud.

  1. Descarga el paquete de la CLI de gdcloud desde la consola de GDC.
    1. Ve a tu consola de GDC tal como se describe en el artículo Conectarse a la instancia.
    2. Ve a la sección Conectar con la CLI.
    3. Haz clic en Descargar paquete de CLI.

  2. En una ventana de terminal, extrae el paquete de la CLI:

    cd ~/Downloads
tar -xf gdcloud_cli.tar.gz

  3. Añade la CLI de gdcloud a tu PATH para no tener que especificar la ubicación con cada comando. En el siguiente comando se da por hecho que el paquete de la CLI se ha descargado y extraído en el directorio Downloads del usuario, y que el perfil de shell del usuario se encuentra en ~/.bashrc.

    echo 'export PATH=$PATH:~/Downloads/google-distributed-cloud-hosted-cli/bin' >> ~/.bashrc
source ~/.bashrc

  4. Abre un nuevo terminal y ejecuta gdcloud version para confirmar que el comando ha funcionado.

  5. Instala el complemento auth. Este complemento es necesario para usar los archivos kubeconfig generados a través de la CLI. 

    gdcloud components install gdcloud-k8s-auth-plugin

Configurar gdcloud

  1. Configura la CLI definiendo la URL de la organización como la URL de la consola de GDC.

    gdcloud config set core/organization_console_url https://console.org-1.zone1.google.gdch.test

Descargar el certificado

gdcloud requiere autenticación para ejecutar comandos. Para usarlo con el entorno aislado de GDC, empieza descargando un certificado de la instancia del entorno aislado de GDC.

  1. Recupera el certificado para autorizar el inicio de sesión. El siguiente comando descarga el certificado en la carpeta /tmp. Puedes descargarlo donde quieras.

    echo -n | \
openssl s_client -showcerts -connect console.org-1.zone1.google.gdch.test:443 | \
sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /tmp/org-1-web-tls-ca.cert

Autenticar con gdcloud

  1. Inicia sesión en la CLI de gdcloud con el certificado descargado. En el siguiente ejemplo se presupone que el certificado se ha descargado en la carpeta /tmp.

    gdcloud auth login --login-config-cert=/tmp/org-1-web-tls-ca.cert

    Este comando abre una ventana del navegador al portal de OIDC. Selecciona Proveedor de OIDC falso y, de nuevo, Administrador de plataforma (o el usuario que quieras usar para el desarrollo). Asegúrate de dar el acceso correcto al rol.

    Repite este paso de autenticación cuando sea necesario, cuando la sesión se agote.