Questa pagina descrive come eseguire il controllo delle versioni per l'API e come eseguire il deployment più versioni.
Suggerimenti per la gestione delle versioni delle API
Per la gestione delle versioni dell'API, tieni in considerazione questi consigli:
- Se vuoi introdurre una modifica incrementale ma senza interruzioni, mantieni dell'API ed il deployment sull'API esistente.
- Quando introduci una modifica che provoca un errore nell'API, incrementa la versione dell'API.
- Per una maggiore protezione, incrementa anche la versione dell'applicazione App Engine, quindi esegui il deployment della nuova versione dell'API nella nuova versione dell'applicazione App Engine. Ciò ti consente di sfruttare la flessibilità integrata con App Engine per passare rapidamente da una versione all'altra e pubblicare dalla versione precedente in caso di problemi imprevisti.
La tabella seguente mostra le versioni dell'API di backend in cascata per diverse versioni dell'applicazione App Engine.
| Versione dell'applicazione | Versione dell'API di backend |
|---|---|
| 1 |
|
| 2 |
|
| 3 |
|
Come mostrato nella tabella, vengono implementati aggiornamenti incrementali e non inversi alla versione 1 dell'API, ciascuno dei quali sovrascrive la versione precedente. Quando vengono introdotte modifiche che comportano interruzioni, la versione dell'API viene incrementata a v2 e viene eseguita il deployment in una nuova versione dell'applicazione App Engine. In questo modo, se necessario, puoi tornare alla versione precedente delle applicazioni.
Nella tabella, nota che la versione 2 dell'applicazione supporta sia l'ultima versione v1
e la nuova versione v2 dell'API. Se non elimini il codice v1 esistente
dal tuo progetto, quando esegui il deployment del progetto sia v2 sia vl (n)
dell'API nella versione 2 dell'applicazione.
Deployment su più versioni dell'applicazione
Quando esegui il deployment dell'API backend, ne esegui il deployment nell'ID progetto del
il progetto Google Cloud che hai creato per l'API e devi inoltre
specifica la versione di App Engine in cui esegui il deployment.
Specifichi la versione dell'app App Engine sulla riga di comando quando
esegui il deployment dell'app.
La versione dell'app App Engine non è la stessa del numero di versione
dell'API di backend, che specifichi nell'argomento version del decoratore
@endpoints.api.
Come mostrato nella figura precedente, puoi eseguire il deployment di più versioni dell'API nella stessa versione di App Engine. Inoltre, puoi avere molte App Engine tutte le versioni di un'applicazione.
Accesso alle versioni dell'API di cui è stato eseguito il deployment in una versione di pubblicazione
La prima
versione di App Engine
in cui esegui il deployment dell'API è la versione di pubblicazione. Questa versione viene eseguita all'URL
http://YOUR_PROJECT_ID.appspot.com, dove
YOUR_PROJECT_ID rappresenta il tuo ID progetto
Google Cloud. Puoi accedere a tutte le versioni dell'API di cui è stato eseguito il deployment nella versione dell'applicazione App Engine utilizzando questo URL.
La versione pubblicata rimane invariata finché non la modifichi esplicitamente nella console Google Cloud.
Accesso alle versioni dell'API di cui è stato eseguito il deployment in una versione dell'applicazione non pubblicata
Se devi accedere a versioni dell'API non di cui è stato eseguito il deployment nella versione di App Engine attualmente in esecuzione, utilizza un URL specifico per la versione, simile al seguente:
https://VERSION-dot-YOUR_PROJECT_ID.appspot.com
Sostituisci VERSION con la tua versione di App Engine,
e YOUR_PROJECT_ID con il tuo progetto Google Cloud
ID. Ad esempio, supponiamo che la versione di App Engine in cui viene eseguito il servizio sia 1, ma tu voglia accedere a una versione dell'API di cui è stato eseguito il deployment nella versione 2. Dovresti
utilizza questo URL: https://2-dot-YOUR_PROJECT_ID.appspot.com.
Per ulteriori dettagli, consulta la documentazione di App Engine.
Accesso alle versioni dell'API di cui è stato eseguito il deployment in servizi non di pubblicazione (in precedenza moduli)
Se hai bisogno di accedere a versioni dell'API di cui non è stato eseguito il deployment nell'ambiente predefinito servizio App Engine, puoi utilizzare un URL specifico del servizio utilizzando il punto come segue:
https://SERVICE-NAME-dot-YOUR_PROJECT_ID.appspot.com/_ah/api/...
Per ulteriori dettagli, consulta la documentazione di App Engine.