Planifica tus proyectos en Cloud

En esta página, se proporcionan recomendaciones para definir las convenciones de nombres de los proyectos de Cloud que necesites crear además del proyecto de Cloud para tu backend de producción.

Según el propósito del entorno o de la etapa en el ciclo de vida de la API, puedes querer hacer lo siguiente:

  • Cambiar el nombre de la API o el nombre del servicio de Cloud Endpoints. Consulta Cómo configurar Endpoints para obtener más información.
  • Crear un proyecto diferente.
  • Cambiar la ruta desde donde se entrega la API.

Es posible que desees usar alguno de los siguientes patrones comunes:

  • Control de versiones de la API: Cuando en el futuro creas necesario hacer cambios incompatibles con las versiones anteriores, planifica con antelación y agrega el número de versión en la ruta desde donde se entrega la API. Por ejemplo:

    • my-api.endpoints.my‐project.cloud.goog/v1/echo
  • Instancias de desarrollo/prueba: Cada desarrollador utiliza su propia versión del servicio, en su propio proyecto. Por ejemplo, el desarrollador Dan usa:

    • my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
  • Staging: Antes de implementar en producción, debes realizar pruebas a las API en el backend de etapa de pruebas, que se encuentra en su propio proyecto. Por ejemplo:

    • my-api.endpoints.my‐project-staging.cloud.goog/v1/echo
  • Ejecutar una versión Alfa privada: Cuando quieres probar una versión nueva de tu servicio con algunos clientes, pero no con todos, el enfoque más sencillo es colocar la versión Alfa en su propio proyecto, ya que esto proporciona el nivel más alto de aislamiento respecto de la producción. Por ejemplo:

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

    Otra alternativa es colocar la versión Alfa en el mismo proyecto, pero configurarla como un servicio independiente. Dado que es un servicio independiente, puedes otorgar acceso solo a los clientes de la versión Alfa. Por ejemplo:

    • my-api-alpha.endpoints.my-project.cloud.goog/v2alpha/echo
  • Ejecutar una versión Alfa abierta: Si quieres lanzar una versión Alfa nueva que esté disponible para todos los clientes, puedes colocarla en el mismo servicio y en el mismo proyecto que la versión existente, y cambiar la ruta. Por ejemplo:

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