En esta página se ofrecen recomendaciones sobre las convenciones de nomenclatura de los proyectos de Cloud que puede que tengas que crear además del proyecto de Cloud de tu backend de producción.
En función del propósito del entorno o de la fase del ciclo de vida de la API, puede que quieras hacer lo siguiente:
- Cambia el nombre de la API o el nombre del servicio de Cloud Endpoints. Para obtener más información, consulta el artículo sobre cómo configurar endpoints.
- Crea otro proyecto.
- Cambia la ruta desde la que se sirve la API.
A continuación, se incluyen algunos patrones habituales que puede usar:
Control de versiones de la API: si crees que vas a tener que hacer cambios incompatibles con versiones anteriores en el futuro, planifica con antelación y añade el número de versión en la ruta desde la que se sirve la API. Por ejemplo:
my-api.endpoints.my‐project.cloud.goog/v1/echo
Instancias de desarrollo o prueba: cada desarrollador configura su propia versión del servicio en su proyecto. Por ejemplo, el desarrollador Daniel usa lo siguiente:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Fase de pruebas: antes de implementar las APIs en producción, las pruebas en tu backend de fase de pruebas, que está en su propio proyecto. Por ejemplo:
my-api.endpoints.my‐project-staging.cloud.goog/v1/echo
Ejecutar una versión alfa privada: si quieres probar una nueva versión de tu servicio con algunos clientes, pero no con todos, lo más fácil es poner la versión alfa en su propio proyecto, que proporciona el mayor nivel de aislamiento de la producción. Por ejemplo:
my-api.endpoints.my‐project-alpha.cloud.goog/v2alpha/echo
También puedes poner la versión alfa en el mismo proyecto, pero configurarla como un servicio independiente. Como se trata de un servicio independiente, puedes restringir el acceso solo a los clientes de la versión alfa. Por ejemplo:
my-api-alpha.endpoints.my-project.cloud.goog/v2alpha/echo
Lanzar una versión alfa abierta: si quieres lanzar una versión alfa que esté disponible para todos los clientes, puedes ponerla en el mismo servicio y proyecto que la versión actual y cambiar la ruta. Por ejemplo:
my-api.endpoints.my-project.cloud.goog/v2alpha/echo