Questa pagina fornisce suggerimenti per le convenzioni di denominazione dei progetti Cloud che potresti dover creare in aggiunta al progetto Cloud per il tuo backend di produzione.
A seconda dello scopo dell'ambiente o della fase nel ciclo di vita dell'API, puoi:
- Cambia il nome dell'API o il nome del servizio Cloud Endpoints. Per ulteriori informazioni, consulta la sezione Configurare endpoint.
- Crea un progetto diverso.
- Cambia il percorso da cui viene pubblicata l'API.
Di seguito sono riportati alcuni pattern comuni che potresti utilizzare:
Controllo delle versioni dell'API: quando pensi 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 rappresenta la propria versione del servizio nel proprio progetto. Ad esempio, Dan lo sviluppatore utilizza:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Staging: prima di passare alla fase di produzione, sottoponi a test le API sul tuo backend temporaneo, che fa parte del suo progetto. Ad esempio:
my-api.endpoints.my‐project-staging.cloud.goog/v1/echo
Eseguire una versione alpha privata: quando vuoi testare una nuova versione del tuo servizio con alcuni clienti, ma non tutti, l'approccio più semplice consiste nell'inserire la versione alpha nel proprio progetto, offrendo 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 una versione alpha aperta: quando 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