Questa pagina fornisce consigli sulle convenzioni di denominazione dei progetti Cloud che potresti dover creare oltre al progetto Cloud per il backend di produzione.
A seconda dello scopo dell'ambiente o della fase del ciclo di vita dell'API, potresti voler:
- Modifica il nome dell'API o il nome del servizio Cloud Endpoints. Per saperne di più, consulta Configurazione degli endpoint.
- Crea un altro progetto.
- Modifica il percorso da cui viene pubblicata l'API.
Di seguito sono riportati alcuni pattern comuni che potresti voler utilizzare:
Controllo delle versioni dell'API: se prevedi di dover apportare modifiche incompatibili con le versioni precedenti in futuro, pianifica in anticipo e aggiungi il numero di versione nel percorso da cui viene pubblicata l'API. Ad esempio:
my-api.endpoints.my‐project.cloud.goog/v1/echo
Istanze di sviluppo/test: ogni sviluppatore crea la propria versione del servizio nel proprio progetto. Ad esempio, lo sviluppatore Dan utilizza:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Staging: prima del deployment in produzione, testa le API sul backend di staging, che si trova in un progetto separato. Ad esempio:
my-api.endpoints.my‐project-staging.cloud.goog/v1/echo
Esecuzione di un test alpha privato: quando vuoi testare una nuova versione del tuo servizio con alcuni clienti, ma non con tutti, l'approccio più semplice è inserire la versione alpha in un progetto separato, che offre il massimo livello di isolamento dalla produzione. Ad esempio:
my-api.endpoints.my‐project-alpha.cloud.goog/v2alpha/echo
In alternativa, puoi inserire la versione alpha nello stesso progetto, ma configurarla come servizio separato. Poiché si tratta di un servizio separato, puoi limitare l'accesso solo ai clienti alpha. Ad esempio:
my-api-alpha.endpoints.my-project.cloud.goog/v2alpha/echo
Esecuzione di un test alpha aperto: se vuoi rilasciare una versione alpha disponibile per tutti i clienti, puoi inserirla nello stesso servizio e progetto della versione esistente e modificare il percorso. Ad esempio:
my-api.endpoints.my-project.cloud.goog/v2alpha/echo