Exécuter des exemples C++ dans Cloud Shell

Découvrez comment compiler et exécuter les exemples de clients C++ dans Cloud Shell à l'aide de micromamba et de Conda.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

  2. Installez la Google Cloud CLI.

  3. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  4. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

  5. Créez ou sélectionnez un projet Google Cloud .

    Rôles requis pour sélectionner ou créer un projet

    • Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
    • Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

    • Créez un projet Google Cloud  :

      gcloud projects create PROJECT_ID

      Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

    • Sélectionnez le projet Google Cloud que vous avez créé :

      gcloud config set project PROJECT_ID

      Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

  6. Vérifiez que la facturation est activée pour votre projet Google Cloud .

  7. Activez l'API Cloud Storage :

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles. 

    gcloud services enable storage.googleapis.com

  8. Installez la Google Cloud CLI.

  9. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  10. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

  11. Créez ou sélectionnez un projet Google Cloud .

    Rôles requis pour sélectionner ou créer un projet

    • Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
    • Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

    • Créez un projet Google Cloud  :

      gcloud projects create PROJECT_ID

      Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

    • Sélectionnez le projet Google Cloud que vous avez créé :

      gcloud config set project PROJECT_ID

      Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

  12. Vérifiez que la facturation est activée pour votre projet Google Cloud .

  13. Activez l'API Cloud Storage :

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles. 

    gcloud services enable storage.googleapis.com
    14.

  14. Créez un bucket Cloud Storage pour exécuter les exemples :

    1. Assurez-vous de disposer du rôle Administrateur de l'espace de stockage (roles/storage.admin) sur le projet. Découvrez comment attribuer des rôles.
    2. Créez un bucket Cloud Storage : 
      gcloud storage buckets create gs://BUCKET_NAME
       Remplacez BUCKET_NAME par un nom qui répond aux conditions requises pour le nom des buckets.
  15. Assurez-vous que les outils suivants sont installés :

Installer les bibliothèques clientes C++ précompilées dans Cloud Shell

  1. Dans Cloud Shell, installez micromamba :

    curl -fsSL https://micro.mamba.pm/api/micromamba/linux-64/latest | sudo tar -C /usr -xj bin/micromamba

  2. Ajoutez des hooks micromamba au shell actuel :

    eval "$(/usr/bin/micromamba shell hook -s posix)"

  3. Utilisez micromamba pour créer un environnement Conda avec les outils et bibliothèques de développement nécessaires :

    micromamba create -y -n base -c conda-forge cmake ninja cxx-compiler google-cloud-cpp libgoogle-cloud

  4. Activez le nouvel environnement conda :

    micromamba activate

Extraire et compiler l'exemple "Storage Quickstart"

  1. Consultez le code source de la bibliothèque cliente C++, y compris les exemples de démarrage rapide pour tous les services :

    git clone --depth 1 https://github.com/googleapis/google-cloud-cpp

  2. Configurez CMake pour compiler l'exemple "Storage Quickstart" :

    cmake -S google-cloud-cpp/google/cloud/storage/quickstart -B .build

  3. Compilez l'exemple :

    cmake --build .build

  4. Exécutez l'exemple :

    .build/quickstart BUCKET_NAME

  5. Après avoir exécuté cet exemple, un message semblable à Successfully created object ... s'affiche, suivi de données spécifiques à votre objet et se terminant par une ligne indiquant Hello World!.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , supprimez le projet Google Cloud qui les contient.

  1. Supprimez l'objet créé par l'exemple :

    gcloud storage rm gs://BUCKET_NAME/quickstart.txt

  2. Supprimez le bucket :

    gcloud storage buckets delete gs://BUCKET_NAME

Étapes suivantes