Questa pagina descrive come eseguire il controllo delle versioni per l'API e come eseguire il deployment su più versioni.
Suggerimenti per la gestione delle versioni API
Quando gestisci le versioni API, tieni presente questi suggerimenti:
- Se vuoi introdurre una modifica incrementale, ma non irreversibile, mantieni costante la versione API ed esegui il deployment sull'API esistente.
- Quando introduci una modifica irreversibile all'API, incrementa la versione API.
- Per una maggiore protezione, incrementa anche la versione dell'applicazione App Engine, quindi esegui il deployment della nuova versione API nella nuova versione dell'applicazione App Engine. In questo modo puoi utilizzare la flessibilità integrata di App Engine per passare rapidamente da una versione di App Engine all'altra e utilizzare le versioni precedenti funzionanti in caso di problemi imprevisti.
La tabella seguente illustra le versioni API del backend a cascata per le diverse versioni dell'applicazione App Engine.
| Versione dell'applicazione | Versione API del backend |
|---|---|
| 1 |
|
| 2 |
|
| 3 |
|
Come mostrato nella tabella, vengono implementati aggiornamenti incrementali e non irreversibili alla versione v1 dell'API, ognuno dei quali sovrascrive la versione precedente. Quando vengono introdotte modifiche irreversibili, la versione API viene incrementata a v2 e viene eseguito il deployment in una nuova versione dell'applicazione App Engine. In questo modo, se necessario, puoi tornare alla versione precedente dell'applicazione.
Nella tabella, tieni presente che la versione 2 dell'applicazione supporta sia l'ultima versione v1 sia la nuova versione v2 dell'API. Se non elimini il codice v1 esistente dal progetto, quando esegui il deployment del progetto, sia v2 sia vl (n) dell'API vengono sottoposte a deployment nella versione 2 dell'applicazione.
Eseguire il deployment su più versioni dell'applicazione
Quando esegui il deployment dell'API del backend, devi farlo nell'ID progetto del
Google Cloud progetto che hai creato per l'API e devi anche
specificare la versione di App Engine in cui eseguire il deployment.
Specifica la versione dell'app App Engine nell'elemento <version> del
/WEB-INF/appengine-web.xml
file. La versione dell'app App Engine non è la stessa cosa del numero di versione dell'API del backend, che specifichi nell'attributo version dell'annotazione