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) isolées. Utilisez ces outils pour effectuer des tâches courantes à partir de la ligne de commande ou à l'aide de scripts et de l'automatisation. La CLI gdcloud vous permet d'amorcer 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 l'CLI dédiée de GDC pour gérer leurs workflows matériels et logiciels isolés. Pour en savoir plus, consultez Audiences pour la documentation 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 Accès à la console GDC.

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

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

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

Configurer la CLI gdcloud

Pour configurer la gdcloud CLI, 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 de CLI#39;interface de ligne de commande gdcloud correspondant à votre environnement GDC.

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

  4. Cliquez sur Télécharger.

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

    cd ~/Downloads

  6. Extrayez le contenu du bundle gdcloud CLI :

    tar -xf ./gdcloud_cli.tar.gz

  7. Ajoutez le bundle gdcloud CLI à 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 gdcloud CLI :

    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 gdcloud CLI après l'initialisation, consultez Gérer les configurations gdcloud CLI.

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

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Authentifiez-vous avec la gcloud CLI 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 gdcloud CLI 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

Étapes suivantes