Configurer un environnement de développement local

Découvrez comment configurer un environnement de développement local pourCloud de Confiance by S3NS. Ce document décrit les outils de base nécessaires pour créer, tester et exécuter des applications avec les services Cloud de Confiance  :

  • gcloud CLI : gérez les ressources cloud, configurez les projets et configurez les Identifiants par défaut de l'application (ADC) locaux.
  • Bibliothèques clientes Cloud : accédez aux API Cloud de Confiance de manière programmatique à l'aide de bibliothèques idiomatiques dans votre langage de programmation préféré.

Ce document explique également comment installer le plug-in google-cloud-developer pour obtenir de l'aide concernant les tâches Cloud de Confiance et le codage dans différents agents.

Pour obtenir une présentation des autres outils et interfaces de Cloud de Confiance, consultez Interagir avec Cloud de Confiance.

Avant de commencer

Demandez à l'administrateur de votre organisation de remplir les conditions préalables suivantes :

  • Provisionnez l'identité de votre utilisateur : attribuez un compte Cloud Identity ou Google Workspace.
  • Accorder l'accès au projet et les rôles IAM : attribuez les rôles IAM (Identity and Access Management) requis pour votre projet.
  • Activez la facturation : vérifiez que Cloud Billing est activé pour votre projet.

Pour une configuration à l'échelle de l'organisation, consultez le Cloud de Confiance flux guidé de configuration.

Configurer gcloud CLI et l'authentification

Configurez gcloud CLI (gcloud) pour gérer les ressources et authentifier votre environnement local :

  1. Installez la gcloud CLI sur votre poste de travail local.
  2. Exécutez gcloud init dans votre terminal pour vous connecter et sélectionner votre projet par défaut.
  3. Exécutez gcloud auth application-default login pour configurer les identifiants par défaut de l'application (ADC). Les ADC permettent aux bibliothèques clientes locales de s'authentifier automatiquement auprès de votre projet.

Installer les bibliothèques clientes Cloud

Pour accéder aux services Cloud de Confiance de manière programmatique à partir du code de votre application :

  1. Activez les API Cloud requises pour votre projet.
  2. Installez les bibliothèques clientes Cloud pour votre langage de programmation (Java, Python ou Go, par exemple). Votre code s'authentifie automatiquement à l'aide d'ADC.

Installer le plug-in google-cloud-developer

Si vous utilisez un agent tel que Claude Code CLI, Antigravity CLI ou Codex CLI pour vous aider dans votre travail de développement, vous pouvez installer le plug-in google-cloud-developer pour obtenir de l'aide concernant les tâches Cloud de Confiance et le codage. Ce plug-in inclut :

  • Compétences pour vous aider à créer un compte, à configurer la facturation, à gérer des projets et à vous authentifier auprès des services et des API Cloud de Confiance .
  • La skill finding-google-skills, qui localise et exécute la skill du produit Google approprié à la demande, ce qui évite de précharger les skills Google.
  • Le serveur MCP distant Developer Knowledge, qui permet de rechercher la documentation officielle de Google pour les développeurs et de récupérer des informations sur les produits Google tels que Google Cloud, Firebase, Android, Maps et plus encore.

Installez le plug-in google-cloud-developer en suivant les instructions ci-dessous en fonction de votre agent.

CLI Antigravity

  1. Installez le plug-in en spécifiant son emplacement dans le dépôt Google Agent Skills :

    agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer

  2. Activez l'API Developer Knowledge dans votre projet Cloud de Confiance à l'aide de la gcloud CLI :

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

Interface de ligne de commande Claude Code

  1. Ajoutez le plug-in Marketplace de Google, puis installez le plug-in :

    claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-plugins

  2. Activez l'API Developer Knowledge dans votre projet Cloud de Confiance à l'aide de la gcloud CLI :

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. Créez une clé API pour l'API Developer Knowledge en suivant les instructions Créer et sécuriser la clé API. Enregistrez la clé que vous créez dans un endroit sûr.

  4. Exportez la clé API vers votre environnement avant de démarrer la CLI Claude Code :

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

CLI Codex

  1. Ajoutez le plug-in Marketplace de Google, puis installez le plug-in :

    codex plugin marketplace add google/skills
codex plugin add google-cloud-developer@google-plugins

  2. Activez l'API Developer Knowledge dans votre projet Cloud de Confiance à l'aide de la gcloud CLI :

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. Créez une clé API pour l'API Developer Knowledge en suivant les instructions Créer et sécuriser la clé API. Enregistrez la clé que vous créez dans un endroit sûr.

  4. Activez l'accès authentifié au serveur MCP Developer Knowledge en mettant à jour ~/.codex/config.toml (ou le .codex/config.toml de votre projet) pour inclure les lignes suivantes :

    [mcp_servers.developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  env_http_headers = { "X-Goog-Api-Key" = "DEVELOPERKNOWLEDGE_API_KEY" }

  5. Exportez la clé API vers votre environnement avant de démarrer Codex :

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

Autres outils et environnements

Si votre workflow nécessite des environnements de développement ou des outils d'infrastructure spécifiques, tenez compte des points suivants :

Étapes suivantes