Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza documentazione di Apigee Edge.
Quando apporti una modifica a un proxy API, puoi salvarlo come nuova revisione ed eseguirne il deployment in un cluster Kubernetes.
Informazioni sul deployment
Il ciclo di vita del deployment di una revisione del proxy API su Apigee è mostrato nella figura seguente.
Limitazioni delle revisioni dei proxy API
Le seguenti limitazioni si applicano alle revisioni del proxy API:
- Se apporti modifiche a un proxy API, devi eseguirne il deployment come nuova revisione.
- Dopo aver eseguito il deployment di un proxy API, la revisione è di sola lettura. Non puoi modificare un proxy API revisione (ad esempio per apportare modifiche incrementali); l'unico modo per modificare una revisione è creare una nuova revisione ed eseguirne il deployment.
- Gli MP possono implementare un bundle di proxy solo nella sua interezza. Se apporti modifiche singoli frammenti o criteri, il team MP eseguirà comunque il deployment dell'intero bundle proxy.
- Se il tuo utilizzo di Apigee distingue tra
proxy standard ed estensibili,
quando esegui il deployment di una revisione che trasforma un proxy API da standard a estensibile:
- potrebbe essere addebitato un costo. Se sei un cliente con pagamento a consumo, consulta le Diritti di pagamento a consumo. Se sei un cliente con un abbonamento, controlla i dettagli del tuo piano.
- richiede più tempo per il deployment. Durante la finestra di deployment, il flusso di chiamate API non viene interrotto, ma non puoi eseguire il deployment, il dis-deployment o l'eliminazione del proxy. Inoltre, le revisioni attuali o nuove non possono essere eliminate durante la finestra di implementazione. Sono consentite modifiche al proxy API e la creazione di nuove revisioni.
Deployment senza tempi di inattività
Tutti i deployment di proxy API su Apigee riusciti sono zero-inattività deployment. I deployment dei proxy API avvengono in questo ordine:
- La revisione 1 del proxy API
/hello
è di cui è stato eseguito il deployment e gestisce il traffico. - È stato eseguito il deployment della revisione 2 di
/hello
. - La revisione 2 viene implementata nei processori di messaggi nel piano di runtime.
- Il deployment della revisione 1 è stato annullato.
Il deployment della revisione del proxy API è ora completo senza tempi di inattività.
Visualizzazione dello stato del deployment
Il deployment di un proxy API su Apigee non lo rende immediatamente disponibile. Occorre del tempo per il proxy API verrà sincronizzato tra tutti gli MP nel piano di runtime. Tuttavia, Apigee offre strumenti in grado di fornirti alcune informazioni sullo stato delle revisioni del proxy API.
Interfaccia utente Apigee classica
Nell'interfaccia utente di Apigee sono disponibili diverse visualizzazioni che forniscono lo stato di implementazione dei proxy API.
Visualizzazione dell'interfaccia utente di Apigee | Passi e Descrizione |
---|---|
Proxy |
L'interfaccia utente di Apigee utilizza le seguenti icone per fornire uno stato rapido di ogni proxy API: Indica che
Non è stato eseguito il deployment del proxy API nell'ambiente selezionato. Per visualizzare l'icona di stato, fai clic sulla scheda Sviluppo. In alternativa, puoi selezionare Sviluppa > Proxy API e fare clic su un proxy API. |
API Apigee
Per visualizzare lo stato di implementazione della revisione del proxy API in un ambiente, utilizza la seguente chiamata API:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \ -X GET \ -H "Authorization: Bearer $TOKEN"
dove $TOKEN
è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl
utilizzate in questo esempio, consulta
Utilizzare curl. Per una descrizione delle variabili di ambiente utilizzate,
consulta Impostare le variabili di ambiente per le richieste API Apigee.
Di seguito è riportato un esempio di risposta. Questo esempio mostra lo stato del deployment della revisione 1
del proxy API helloworld
di cui è stato eseguito il deployment nell'ambiente test
:
{ "environment": "test", "apiProxy": "helloworld", "revision": "1", "deployStartTime": "1559149080457", "pods": [ { "podName": "apigee-runtime-myorg-test-f8bdf9d-2s72w", "deploymentStatus": "deployed", "statusCodeDetails": "Deployment Success", "podStatus": "active", "podStatusTime": "1595357668001" } ], "state": "READY" }
Per ulteriori informazioni, consulta la pagina sull'API dei deployment dell'ambiente di revisione del proxy API.
gcloud
Per visualizzare lo stato di implementazione della revisione del proxy API in un ambiente, utilizza il seguente comando gcloud:
gcloud alpha apigee deployments describe --api=$API --environment=$ENV
Per ulteriori informazioni e per una descrizione delle variabili di ambiente utilizzate negli esempi, consulta Introduzione a gcloud con Apigee.
Di seguito è riportato un esempio di risposta. Questo esempio mostra lo stato del deployment per la revisione 1
del proxy API helloworld
di cui è stato eseguito il deployment nell'ambiente test
:
Using Apigee organization `my-org` Using deployed revision `1` apiProxy: helloworld deployStartTime: '1598032332802' environment: test pods: - deploymentStatus: deployed podName: apigee-runtime-myorg-test-f8bdf9d-2s72w podStatus: active podStatusTime: '1598302128087' statusCodeDetails: Deployment Success revision: '1' state: READY
Per maggiori informazioni, consulta Descrivere l'interfaccia a riga di comando dei deployment.
Visualizzare l'utilizzo del deployment del proxy
L'utilizzo dei proxy API nella tua organizzazione potrebbe essere soggetto a una quota di deployment, ovvero un limite al numero di unità di deployment che puoi utilizzare alla volta. Verificare i diritti (Pay-as-you-go o Subscription) per i dettagli. Puoi visualizzare l'utilizzo del deployment del proxy della tua organizzazione da diversi punti all'interno dell'interfaccia utente di Apigee nella console Cloud, come descritto di seguito.
Visualizza l'utilizzo del deployment nella pagina Panoramica di Apigee
Per visualizzare l'utilizzo del deployment del proxy API dalla pagina Panoramica di Apigee:
- Apri la pagina Panoramica nella UI di Apigee nella console Google Cloud.
- Puoi visualizzare un riepilogo dell'utilizzo del deployment del proxy per la tua organizzazione utilizzando la scheda Utilizzo del proxy, che
mostra le seguenti informazioni relative alla tua organizzazione:
- Proxy totali creati: il numero totale di proxy API creati, inclusi i proxy di cui è stato eseguito il deployment e quelli di cui non è stato eseguito il deployment.
- Proxy di cui è stato eseguito il deployment: il numero totale di proxy API di cui è stato eseguito il deployment in tutti gli ambienti dell'organizzazione.
- Unità di deployment del proxy: il numero totale di revisioni di proxy API o flussi condivisi di cui è stato eseguito il deployment nella tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come una singola unità.
- Proxy e flussi condivisi di cui è stato eseguito il deployment rispetto al limite: numero totale di proxy API e flussi condivisi di cui è stato eseguito il deployment nell'organizzazione, rispetto al limite previsto per il tuo tipo di organizzazione.
- Unità di deployment estensibili: il numero di revisioni del proxy API estensibili di cui è stato eseguito il deployment in dell'organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come una singola unità.
- Unità di deployment standard: il numero di revisioni del proxy API standard di cui è stato eseguito il deployment in dell'organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come una singola unità.
Visualizza l'utilizzo del deployment nella pagina Proxy API
Per visualizzare l'utilizzo del deployment del proxy API dalla pagina Proxy API:
- Apri la pagina Proxy API nella UI di Apigee nella console Google Cloud.
- Nella pagina Proxy API vengono visualizzate le seguenti informazioni:
- Proxy totali creati: il numero totale di proxy API sviluppati nella tua organizzazione, inclusi di cui è stato eseguito il deployment e di cui non è stato eseguito il deployment.
- Proxy di cui è stato eseguito il deployment: il numero totale di revisioni dei proxy API di cui è stato eseguito il deployment in tutti gli ambienti della tua organizzazione.
- Unità di deployment del proxy: il numero totale di revisioni del proxy API o del flusso condiviso di cui è stato eseguito il deployment in tutti gli ambienti che fa parte della tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
- Unità di deployment di proxy estensibili: il numero di revisioni di proxy API estensibili di cui è stato eseguito il deployment in tutti gli ambienti della tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
- Unità di deployment proxy standard: il numero di revisioni del proxy API standard di cui è stato eseguito il deployment in tutte ambienti aziendali all'interno dell'organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come una singola unità.
Visualizzare l'utilizzo del deployment nella pagina Ambienti
Per visualizzare l'utilizzo del deployment del proxy API dalla pagina Ambienti:
- Apri la pagina Ambienti nella UI di Apigee nella console Google Cloud.
- Seleziona la scheda Panoramica Ambienti per visualizzare le seguenti informazioni per tutti gli ambienti:
- Unità di deployment del proxy totali: il numero totale di revisioni del proxy API o del flusso condiviso di cui è stato eseguito il deployment in tutti gli ambienti che fa parte della tua organizzazione.
- Unità di deployment di proxy estensibili: il numero di revisioni di proxy API estensibili di cui è stato eseguito il deployment in tutti gli ambienti della tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
- Unità di deployment proxy standard: il numero di revisioni del proxy API standard di cui è stato eseguito il deployment in tutti gli ambienti che fa parte della tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
- Unità di deployment del flusso condiviso: il numero totale di revisioni del flusso condiviso di cui è stato eseguito il deployment in in tutti gli ambienti della tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
- Per visualizzare l'utilizzo del deployment del proxy per un singolo ambiente:
- Nell'elenco Ambienti, seleziona il nome di un ambiente per visualizzarne i dettagli.
- Seleziona la scheda Deployment per visualizzare l'utilizzo delle unità di deployment per l'ambiente selezionato.
Passaggi successivi
Impara come effettuare l'implementazione:
|
Scopri come annullare il deployment: Annullamento del deployment di un proxy API
|