Concevoir et déployer une application à l'aide de la CLI Gemini

Utilisez les serveurs MCP (Model Context Protocol) de Gemini Cloud Assist et d'App Design Center pour concevoir, déployer et résoudre les problèmes d'infrastructureGoogle Cloud directement dans Gemini CLI.

Objectifs

Ce tutoriel vous aide à effectuer les opérations suivantes :

  • Configurez Gemini CLI pour utiliser les serveurs MCP Gemini Cloud Assist et App Design Center.
  • Concevez et déployez une infrastructure Google Cloud optimisée pour exécuter le code de votre application existante.
  • Analyser et résoudre les problèmes techniques.

Coûts

Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :

  • App Design Center.
  • Google Cloud resources that you create as part of your application infrastructure.

Pour obtenir une estimation des coûts en fonction de votre utilisation prévue, utilisez le simulateur de coût.

Les nouveaux utilisateurs de Google Cloud peuvent bénéficier d'un essai sans frais.

Une fois que vous avez terminé les tâches décrites dans ce document, supprimez les ressources que vous avez créées pour éviter que des frais vous soient facturés. Pour en savoir plus, consultez la section Effectuer un nettoyage.

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. Installez la Google Cloud CLI.

  8. 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.

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

    gcloud init

  10. 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 .

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

  12. Pour accéder à Gemini Cloud Assist via MCP, vous devez participer au programme Testeur de confiance. Contactez l'équipe chargée de votre compte pour demander l'accès.
  13. Installez Gemini CLI.
  14. Pour déployer et exécuter des commandes Gemini CLI, demandez à votre administrateur de vous accorder les rôles nécessaires dans les limites de votre projet, comme indiqué dans le tableau suivant :
    Tâche Rôles requis
    Configurer App Design Center dans votre projet Administrateur App Design Center (roles/designcenter.admin)
    Accéder à Gemini Cloud Assist et l'appeler via MCP Administrateur Gemini Cloud Assist (roles/geminicloudassist.admin), ou
    Éditeur Gemini Cloud Assist (roles/geminicloudassist.editor), ou
    Utilisateur Gemini Cloud Assist (roles/geminicloudassist.user)

Préparer l'environnement

Pour préparer votre environnement, authentifiez-vous auprès de Google Cloud et activez les services requis.

S'authentifier auprès de Google Cloud

Authentifiez-vous auprès de Google Cloud en exécutant la commande suivante dans votre terminal :

  1. Configurez les Identifiants par défaut de l'application pour permettre aux serveurs MCP d'effectuer des appels d'API.

     gcloud auth application-default login

Activer les API

Activez les services Gemini Cloud Assist et Application Design Center dans votre projet.

  1. Activez le service Gemini Cloud Assist dans votre projet :

     gcloud services enable geminicloudassist.googleapis.com

  2. Activez le service App Design Center dans votre projet :

     gcloud services enable designcenter.googleapis.com

Configurer les serveurs MCP

Les serveurs MCP Gemini Cloud Assist et App Design Center vous aident à concevoir, évaluer, déployer et dépanner l'infrastructure Google Cloudà l'aide de requêtes en langage naturel. Pour vous connecter aux serveurs MCP, configurez vos paramètres Gemini CLI.

Pour configurer Gemini CLI afin qu'il utilise des serveurs MCP, procédez comme suit :

  1. Ouvrez votre fichier de configuration Gemini CLI à l'un des emplacements suivants :

    • Champ d'application utilisateur : pour appliquer les paramètres à tous vos projets Gemini CLI, ouvrez ~/.gemini/settings.json.
    • Champ d'application de l'espace de travail : pour appliquer des paramètres à un projet Gemini CLI spécifique, ouvrez .gemini/settings.json.

    Si votre fichier de configuration n'existe pas, créez-en un.

  2. Dans settings.json, ajoutez ou fusionnez le bloc de configuration suivant sous la clé mcpServers.

      {
    "mcpServers": {
      "gemini-cloud-assist": {
        "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials",
        "oauth": {
          "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
        },
        "timeout": 600000
      },
      "application-design-center": {
        "httpUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials",
        "oauth": {
          "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
        },
        "timeout": 600000
      }
    }
  }

    Cette configuration utilise automatiquement vos Identifiants par défaut de l'application.

  3. Enregistrez et fermez votre fichier de configuration.

  4. Démarrez Gemini CLI.

    gemini

  5. Vérifiez que les serveurs MCP sont connectés.

    /mcp list

Installer des fichiers SKILL.md

Les fichiers SKILL.md fournissent les instructions et les workflows des serveurs MCP App Design Center et Gemini Cloud Assist pour la conception, le déploiement et le dépannage de l'infrastructure.

Pour ajouter des fichiers SKILL.md à Gemini CLI, procédez comme suit.

  1. Créez un répertoire skills/design-and-deploy dans l'un des emplacements suivants :

    • Champ d'application utilisateur : pour appliquer des paramètres à tous vos projets Gemini CLI, créez ~/.gemini/skills/design-and-deploy/.
    • Champ d'application de l'espace de travail : pour appliquer des paramètres à un projet Gemini CLI spécifique, créez .gemini/skills/design-and-deploy/.

  2. Dans le répertoire skills/design-and-deploy/, créez un fichier SKILL.md en utilisant le contenu de designing-and-deploying-infrastructure.

  3. Créez un répertoire skills/google-gemini-cloud-assist dans l'un des emplacements suivants :

    • Champ d'application utilisateur : pour appliquer des paramètres à tous vos projets Gemini CLI, créez ~/.gemini/skills/google-gemini-cloud-assist/.
    • Champ d'application de l'espace de travail : pour appliquer des paramètres à un projet Gemini CLI spécifique, créez .gemini/skills/google-gemini-cloud-assist/.

  4. Dans le répertoire skills/google-gemini-cloud-assist/, créez un fichier SKILL.md à l'aide du contenu de operating-google-cloud.

  5. Quittez et redémarrez Gemini CLI.

    /quit

    Lorsque vous redémarrez Gemini CLI, il détecte automatiquement votre fichier de compétence.

  6. Vérifiez que le fichier de compétence a été détecté automatiquement.

    /skills list

Vous avez configuré Gemini CLI pour qu'il se connecte aux serveurs App Design Center et Gemini Cloud Assist MCP, et vous avez créé des fichiers de compétences.

Concevez votre infrastructure Google Cloud

Concevez une infrastructure adaptée au stockage et à l'exécution du code de votre application.

  1. Définissez le projet que vous souhaitez utiliser :

    gcloud config set project PROJECT_ID

  2. Demandez la conception de l'infrastructure Google Cloud .

     My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.

    L'agent vous demande d'activer les compétences que vous avez configurées. L'agent crée un plan de conception de l'infrastructure et vous demande votre approbation.

  3. Approuvez le plan.

    Continue with the plan.

    L'agent identifie les outils à utiliser pour créer l'infrastructure. Il demande à utiliser l'outil setup_adc, qui configure App Design Center dans votre projet.

  4. Autorisez Gemini Cloud Assist à utiliser les outils proposés.

    L'agent propose une conception et vous demande si vous êtes prêt à déployer.

  5. Itérer sur la conception proposée.

    The infrastructure looks good, but I want to add a cache for frequently accessed data.

    L'agent met à jour la conception pour intégrer votre exigence. L'agent vous demande si vous souhaitez obtenir une explication des modifications ou les tester.

Vous avez créé votre conception d'infrastructure initiale et l'avez améliorée.

Évaluer la conformité aux normes de sécurité

Les administrateurs de votre organisation ont probablement configuré des frameworks de sécurité spécifiques qui orientent la conception et le déploiement de l'infrastructure. Dans cette section, vérifiez que votre conception est conforme aux normes de sécurité configurées.

  1. Assurez-vous que la conception de l'infrastructure est conforme aux normes de sécurité de votre organisation.

    I want to make sure that infrastructure design is compliant with my organization's security standards.

    L'agent analyse la conception de l'infrastructure en fonction des frameworks de sécurité que l'administrateur de votre organisation a spécifiés dans Security Command Center. Si l'audit révèle des problèmes de conformité, l'agent suggère des améliorations de sécurité et vous demande votre approbation.

  2. Appliquer les améliorations de sécurité recommandées

    Apply the recommended security enhancements.

    L'agent applique les modifications et vous demande si vous êtes prêt à approuver la conception.

La conception de votre infrastructure est conforme aux cadres de sécurité de votre organisation.

Déployer la conception de l'infrastructure

Déployez la conception de l'infrastructure sur Google Cloud.

  1. Approuvez la conception et déployez-la.

    Deploy the infrastructure design to my Google Cloud project.

    L'agent déploie la conception finale dans votre projet Google Cloud . L'agent vous demande d'approuver les modifications apportées à votre projet. Par exemple, vous devrez peut-être activer une API.

    Si le déploiement de l'application réussit, l'agent affiche les détails du déploiement, les composants d'architecture et les étapes à suivre pour utiliser l'application.

  2. Si votre déploiement échoue, obtenez de l'aide pour résoudre le problème. Par exemple, vous devrez peut-être corriger les détails de configuration des composants ou les autorisations Identity and Access Management (IAM).

    Fix the component configuration errors.

    L'agent fournit des recommandations pour les configurations de composants et crée une vue diff que vous pouvez examiner et accepter.

  3. Pour réessayer le déploiement après avoir apporté des modifications, répétez les étapes de cette section.

Vous avez déployé le code de votre application et la conception de l'infrastructure surGoogle Cloud.

Effectuer un nettoyage

Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez les ressources individuelles.

    Supprimer un projet Google Cloud  :

    gcloud projects delete PROJECT_ID

Étapes suivantes