Planear os seus projetos na nuvem

Esta página fornece recomendações para convenções de nomenclatura dos projetos do Google Cloud que pode ter de criar, além do projeto do Google Cloud para o seu back-end de produção.

Consoante a finalidade do ambiente ou a fase no ciclo de vida da API, pode querer:

  • Altere o nome da API ou o nome do serviço Cloud Endpoints. Consulte o artigo Configurar pontos finais para mais informações.
  • Crie um projeto diferente.
  • Alterar o caminho a partir do qual a API é publicada.

Seguem-se alguns padrões comuns que pode querer usar:

  • Controlar as versões da API: quando achar que pode ter de fazer alterações incompatíveis com versões anteriores no futuro, planeie antecipadamente e adicione o número da versão no caminho a partir do qual a API é fornecida. Por exemplo:

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

  • Instâncias de desenvolvimento/teste: cada programador cria a sua própria versão do serviço no seu próprio projeto. Por exemplo, o programador Daniel usa:

    • my-api.endpoints.dan-dev-project.cloud.goog/v1/echo

  • Preparação: antes de implementar para produção, testa as suas APIs no backend de preparação, que está no seu próprio projeto. Por exemplo:

    • my-api.endpoints.my‐project-staging.cloud.goog/v1/echo

  • Executar uma versão alfa privada: quando quer testar uma nova versão do seu serviço com alguns clientes, mas não com todos, a abordagem mais fácil é colocar a versão alfa no seu próprio projeto, o que oferece o nível mais elevado de isolamento da produção. Por exemplo:

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

    Em alternativa, pode colocar a versão alfa no mesmo projeto, mas configurá-la como um serviço separado. Uma vez que é um serviço separado, pode restringir o acesso apenas aos clientes fidedignos. Por exemplo:

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

  • Executar uma versão alfa aberta: quando quiser lançar uma versão alfa que esteja disponível para todos os clientes, pode colocá-la no mesmo serviço e projeto que a versão existente e alterar o caminho. Por exemplo:

    • my-api.endpoints.my-project.cloud.goog/v2alpha/echo
Veja também: