Planifier vos projets Cloud

Cette page fournit des recommandations pour les conventions de nommage des projets Cloud que vous devrez peut-être créer en plus du projet Cloud pour votre backend de production.

En fonction de l'objectif de l'environnement ou de l'étape du cycle de vie de l'API, vous souhaiterez peut-être :

  • Modifier le nom de l'API ou le nom du service Cloud Endpoints. Consultez la section Configurer Endpoints pour plus d'informations.
  • Créer un projet différent.
  • Modifier le chemin d'accès à partir duquel l'API est diffusée.

Vous trouverez ci-dessous certains modèles courants que vous pouvez utiliser :

  • Gestion des versions de l'API : si vous pensez devoir éventuellement apporter des modifications incompatibles avec les versions antérieures, anticipez les erreurs et ajoutez le numéro de version dans le chemin d'accès à l'API. Exemple :

    • my-api.endpoints.my‐project.cloud.goog/v1/echo
  • Instances de développement/test : chaque développeur construit sa propre version du service dans son propre projet. Par exemple, le développeur Dan utilise ce qui suit :

    • my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
  • Préproduction : avant de déployer en production, testez vos API sur votre backend de préproduction, dans votre propre projet. Exemple :

    • my-api.endpoints.my‐project-staging.cloud.goog/v1/echo
  • Exécution d'une version alpha privée : lorsque vous souhaitez tester une nouvelle version de votre service avec certains clients mais pas avec tous, l'approche la plus simple consiste à placer la version alpha dans son propre projet, ce qui procure le plus haut niveau d'isolation par rapport à la production. Exemple :

    • my-api.endpoints.my‐project-alpha.cloud.goog/v2alpha/echo

    Vous pouvez également placer la version alpha dans le même projet mais la configurer en tant que service distinct. S'agissant d'un service séparé, vous pouvez limiter l'accès aux seuls clients alpha. Exemple :

    • my-api-alpha.endpoints.my-project.cloud.goog/v2alpha/echo
  • Exécution d'une version alpha ouverte : lorsque vous souhaitez publier une version alpha disponible pour tous les clients, vous pouvez la placer dans le même service et le même projet que la version existante et modifier le chemin. Exemple :

    • my-api.endpoints.my-project.cloud.goog/v2alpha/echo