Questa pagina fornisce consigli per le convenzioni di denominazione dei progetti Cloud che potresti dover creare oltre al progetto Cloud per il tuo 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 ulteriori informazioni, consulta Configurazione degli endpoint.
- Crea un progetto diverso.
- Modifica il percorso da cui viene pubblicata l'API.
Di seguito sono riportati alcuni pattern comuni che potresti utilizzare:
Controllo delle versioni dell'API: se ritieni di dover apportare modifiche non compatibili 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 esegue l'implementazione della propria versione del servizio nel proprio progetto. Ad esempio, Dan, lo sviluppatore, utilizza:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Preparazione: prima di eseguire il deployment in produzione, testa le API sul backend di preparazione, che si trova in un progetto a parte. 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 con tutti, l'approccio più semplice è inserire la versione alpha in un progetto dedicato, 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
Eseguire un'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