Panoramica del deployment

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Nota:per eseguire il deployment dei proxy API in ambienti abilitati per deployment degli archivi, consulta Eseguire il deployment e gestire gli archivi in un ambiente Apigee.

Quando apporti una modifica a un proxy API, puoi salvarlo come nuova revisione ed eseguirne il deployment nel cluster.

Guida rapida:

• Deployment di un proxy API
• Annullare il deployment di un proxy API

Informazioni sul deployment

Nella figura seguente è mostrato il ciclo di vita del deployment di una revisione del proxy API su Apigee.

Nota: in Apigee, i MP agiscono in modo indipendente l'uno dall'altro e ogni determinato MP può avere uno stato diverso rispetto agli altri MP (ad esempio attivo o disabilitato). Questo è noto come modello di deployment a coerenza finale per i proxy API.

Limitazioni delle revisioni dei proxy API

Alle revisioni dei proxy API si applicano le seguenti limitazioni:

• 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 una revisione del proxy API (ad esempio, per apportare modifiche incrementali). L'unico modo per modificare una revisione è crearne una nuova ed eseguirne il deployment.
• I MP possono distribuire un bundle proxy solo nella sua interezza. Se apporti modifiche a singoli frammenti o criteri, i MP eseguiranno comunque il deployment dell'intero bundle proxy.
• Se l'utilizzo di Apigee distingue tra proxy standard ed estensibili, quando esegui il deployment di una revisione che modifica un proxy API da un proxy standard a un proxy estensibile:
  • potrebbe esserti addebitato un costo. Se sei un cliente con pagamento a consumo, consulta la sezione Diritti di pagamento a consumo. Se sei un cliente con abbonamento, visualizza i dettagli del tuo piano.
  • il deployment richiede più tempo. Durante la finestra di deployment, il flusso di chiamate API non viene interrotto, ma non puoi eseguire il deployment, annullare il deployment o eliminare il proxy. Inoltre, non è possibile eliminare le revisioni attuali o nuove durante la finestra di deployment. Sono consentite modifiche al proxy API e alla creazione di nuove revisioni.

Deployment senza tempi di inattività

Tutti i deployment proxy API in Apigee sono deployment senza tempi di inattività. I deployment del proxy API avvengono nel seguente ordine:

1. È stato eseguito il deployment della revisione 1 del proxy API /hello e gestisce il traffico.
2. È stato eseguito il deployment della revisione 2 di /hello.
3. Il deployment della revisione 2 viene eseguito nei processori di messaggi nel piano di runtime.
4. Deployment della revisione 1 annullato.

Il deployment della revisione del proxy API è ora completo senza tempi di inattività.

Nota: se per qualsiasi motivo il deployment della revisione 2 non va a buon fine, il deployment della versione precedente della revisione 1 risulta ancora annullato. In questo caso, puoi eseguire nuovamente il deployment della revisione precedente per ripristinarla. Successivamente, puoi correggere la nuova revisione ed eseguirne il deployment.

Visualizzazione dello stato del deployment

Il deployment di un proxy API su Apigee non lo rende immediatamente disponibile. La sincronizzazione del proxy API su tutti gli MP nel piano di runtime richiede del tempo. Tuttavia, Apigee fornisce strumenti che possono fornirti alcune informazioni sullo stato delle revisioni dei proxy API.

Interfaccia utente di Apigee

All'interno della UI di Apigee sono presenti diverse viste che forniscono lo stato di deployment dei proxy API.

Visualizzazione UI di Apigee

Passaggi e descrizione

proxy

Seleziona Sviluppo > Proxy API: L'interfaccia utente di Apigee utilizza le seguenti icone per fornire un rapido stato di ogni proxy API: indica che non è stato eseguito il deployment del proxy API nell'ambiente selezionato. Indica che non sono presenti errori o avvisi per il proxy nell'ambiente selezionato. Indica che alcuni percorsi non sono stati aggiornati a causa di conflitti di percorsi di base. Indica che si è verificato un errore durante il deployment del proxy API. Per visualizzare l'icona di stato, fai clic sulla scheda Sviluppo. In alternativa, puoi selezionare Sviluppo > Proxy API e fare clic su un proxy API

API Apigee

Per visualizzare lo stato del deployment 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 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 Impostazione delle variabili di ambiente per le richieste API Apigee.

Di seguito è riportato un esempio della 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:

{
  "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 sezione API dei deployment dell'ambiente di revisione del proxy API.

gcloud

Per visualizzare lo stato del deployment 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 una descrizione delle variabili di ambiente utilizzate negli esempi, consulta Iniziare a utilizzare gcloud con Apigee.

Di seguito è riportato un esempio della 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.

Visualizza l'utilizzo del deployment del proxy

L'utilizzo dei proxy API nella tua organizzazione può essere soggetto a una quota di deployment, che corrisponde a un limite al numero di unità di deployment che puoi utilizzare contemporaneamente. Per informazioni dettagliate, consulta i tuoi diritti (Pay-as-you-go o abbonamento). Puoi visualizzare l'utilizzo del deployment proxy da parte della tua organizzazione da diverse posizioni all'interno della pagina https://console.cloud.google.com/apigee, 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:

1. Apri la pagina Panoramica nell'interfaccia utente di Apigee nella console Google Cloud.

   Vai a Panoramica

2. 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 per la tua organizzazione:
   • Proxy di cui è stato eseguito il deployment: numero totale di revisioni proxy API di cui è stato eseguito il deployment nella tua organizzazione.
   • Unità di deployment proxy: il numero totale di revisioni del proxy API di cui è stato eseguito il deployment nella tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
   • Unità di deployment estensibili: il numero di revisioni proxy API estensibili di cui è stato eseguito il deployment nella tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
   • Unità di deployment standard: il numero di revisioni del proxy API standard di cui è stato eseguito il deployment nella tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
3. Utilizzando la scheda Ambienti della pagina Panoramica, puoi anche visualizzare la quota utilizzata dalla tua organizzazione.

Visualizza l'utilizzo del deployment nella pagina Proxy API

Per visualizzare l'utilizzo del deployment del proxy API dalla pagina proxy API:

1. Apri la pagina proxy API nell'interfaccia utente di Apigee nella console Google Cloud.

   Vai a Proxy API

2. Nella pagina proxy API vengono visualizzate le seguenti informazioni:
   • Proxy totali: il numero totale di proxy API sviluppati nella tua organizzazione.
   • Proxy di cui è stato eseguito il deployment: numero totale di revisioni proxy API di cui è stato eseguito il deployment in tutti gli ambienti della tua organizzazione.
   • Unità totali di deployment: numero totale di revisioni proxy API 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 del proxy estensibile: il numero di revisioni 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 proxy API standard 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à.

Visualizza l'utilizzo del deployment nella pagina Ambienti

Per visualizzare l'utilizzo del deployment del proxy API dalla pagina Ambienti:

1. Apri la pagina Ambienti nell'interfaccia utente di Apigee nella console Google Cloud.

   Vai a Ambienti

2. Seleziona la scheda Panoramica Ambienti per visualizzare le informazioni seguenti per tutti gli ambienti:
   • Unità totali di deployment: numero totale di revisioni proxy API di cui è stato eseguito il deployment in tutti gli ambienti della tua organizzazione.
   • Unità di deployment del proxy estensibile: il numero di revisioni 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 proxy API standard 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 del flusso condiviso: numero totale di revisioni dei flussi condivise con deployment in tutti gli ambienti della tua organizzazione. Ogni deployment per ambiente e per istanza viene conteggiato come un'unità.
   • Quota: il numero di unità di deployment disponibili per la tua organizzazione utilizzate in tutti gli ambienti dell'organizzazione.
3. Per visualizzare l'utilizzo del deployment del proxy per un singolo ambiente:
   1. Nell'elenco Ambienti, seleziona il nome di un ambiente per visualizzarne i dettagli.
   2. Seleziona la scheda Deployment per visualizzare l'utilizzo delle unità di deployment per l'ambiente selezionato.

Passaggi successivi

Impara come effettuare l'implementazione: Deployment di un proxy API

Scopri come annullare il deployment: Annullare il deployment di un proxy API