Utiliser la CLI gdcloud

La CLI gdcloud est un ensemble d'outils permettant de créer et de gérer des ressources Google Distributed Cloud (GDC) sous air gap. Utilisez ces outils pour effectuer des tâches courantes à partir de la ligne de commande ou via des scripts et l'automatisation. La CLI gdcloud vous permet de démarrer l'infrastructure, de gérer l'authentification et de personnaliser les configurations locales.

Ce document s'adresse à tous les groupes d'audience qui doivent configurer la CLI dédiée de GDC pour gérer leurs workflows matériels et logiciels sous air gap. Pour en savoir plus, consultez la documentation sur les audiences pour GDC sous air gap.

Avant de commencer

  • Vérifiez que vous avez accès à la console GDC et notez l'URL de votre organisation. Pour en savoir plus, consultez la page Accès à la console GDC.

  • Vérifiez que vous disposez d'un certificat d'autorité de certification (CA) installé dans le magasin de certificats approuvés de votre système. Pour en savoir plus, consultez la page Récupérer les groupes de confiance GDC.

  • Vérifiez que vous disposez d'une règle de réseau d'organisation qui autorise le trafic d'un CIDR spécifique en dehors de votre organisation vers l'artifact registry. Par exemple, configurez le nom de service all dans la ressource OrganizationNetworkPolicy. Pour en savoir plus, consultez la page Créer des stratégies réseau d'organisation.

  • Vérifiez qu'un navigateur est installé sur votre appareil.

Configurer la CLI gdcloud

Pour configurer la CLI gdcloud, procédez comme suit :

  1. Ouvrez la console GDC en saisissant l'URL globale ou zonale de votre organisation dans votre navigateur.

  2. Sur la page d'accueil, sélectionnez Download CLI Bundle (Télécharger le bundle CLI).

  3. Sélectionnez la plate-forme Linux et la version du bundle CLI gdcloud correspondant à votre environnement GDC.

    Lorsque vous choisissez des plates-formes non Linux, les étapes de configuration peuvent varier légèrement. Sachez également que certains bundles CLI gdcloud non Linux ne fournissent qu'un sous-ensemble de commandes gdcloud. Pour en savoir plus, consultez la page Bundles CLI gdcloud disponibles.

  4. Cliquez sur Télécharger.

  5. Sur votre appareil, accédez au dossier Downloads :

    cd ~/Downloads

  6. Extrayez le contenu du bundle CLI gdcloud :

    tar -xf ./gdcloud_cli.tar.gz

  7. Ajoutez le bundle CLI gdcloud à votre chemin d'accès :

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

  8. Vérifiez que la CLI gdcloud est correctement installée :

    gdcloud version

    Le résultat ressemble à ce qui suit :

    gdcloud version: 1.15.0-gdch.380608

  9. Initialisez la CLI gdcloud :

    gdcloud init

  10. Fournissez les deux propriétés demandées pour terminer l'initialisation :

    • organization_console_url: URL de la console de votre organisation GDC actuelle. Cette URL peut être globale ou zonale. Exemple : https://console.org-1.google.gdch.test/.

    • project : nom de votre projet GDC. Si vous n'avez pas de projet existant, utilisez default.

    Pour mettre à jour vos configurations de CLI gdcloud après l'initialisation, consultez la page Gérer les configurations de CLI gdcloud.

  11. Installez le composant gdcloud-k8s-auth-plugin :

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Authentifiez-vous avec la CLI gdcloud pour vous connecter :

    gdcloud auth login

    Vous êtes redirigé vers le navigateur pour choisir votre identité et vous connecter.

  13. Vérifiez que votre configuration de CLI gdcloud est connectée à votre environnement GDC :

    gdcloud compute images list

    Le résultat ressemble à ce qui suit :

    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

Étape suivante