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, planifiez à l'avance et ajoutez le numéro de version dans le chemin d'accès à partir duquel l'API est diffusée. Par 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, vous testez vos API sur votre backend de préproduction, qui se trouve dans son propre projet. Par 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. Par 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. Par 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