Annullamento del deployment di un proxy API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Esegui il ritiro di una revisione del proxy API dal cluster come descritto nelle sezioni seguenti.

Tieni presente che quando esegui il ritiro di una revisione:

  • Apigee non esegue il rollback della revisione alla revisione di cui è stato eseguito il deployment in precedenza.
  • Dopo il ritiro, non vengono implementate revisioni del proxy API nell'ambiente.

L'annullamento del deployment di un proxy API è simile all'eliminazione di un proxy API, tranne per il fatto che quando annulli il deployment di una revisione puoi scegliere di modificarla nell'interfaccia utente e di eseguire nuovamente il deployment in un secondo momento. Se lo elimini, il proxy API non sarà più disponibile per la modifica.

Nuovo editor proxy

Per annullare il deployment di un proxy API utilizzando l'interfaccia utente:

  1. Se utilizzi l'interfaccia utente di Apigee nella console Cloud: seleziona Sviluppo proxy > Proxy API.

    Se utilizzi la UI di Apigee classica: seleziona Sviluppa > Proxy API e nel riquadro Proxy, seleziona l'ambiente per il proxy.

  2. Seleziona il proxy API di cui vuoi annullare il deployment. L'interfaccia utente mostra la vista Panoramica del proxy API.

    Proxy nella visualizzazione Panoramica.

  3. Passa il cursore sopra l'icona nella colonna Stato e seleziona Annulla deployment:

    Annullare il deployment di un proxy.

Editor proxy classico

Per annullare il deployment di un proxy API utilizzando l'interfaccia utente:

  1. Accedi all'interfaccia utente di Apigee.
  2. Seleziona Sviluppa > Proxy API.

    L'interfaccia utente mostra un elenco dei proxy API correnti per l'ambiente selezionato:

    Viene visualizzato un elenco di proxy API che include
      il nome, lo stato, il traffico nelle ultime 24 ore, l'autore e l'ora dell'ultima modifica.

  3. Seleziona il proxy API di cui vuoi annullare il deployment.

    L'interfaccia utente mostra la vista Panoramica del proxy API.

  4. Nella riga dell'ambiente che ti interessa, espandi l'elenco a discesa Revisione e seleziona Esegui il ritiro:

    Menu a discesa Revisione per l'ambiente di produzione che mostra l'elemento Rilascia deployment

    L'interfaccia utente ti chiede di confermare la versione di cui vuoi annullare il deployment:

    Finestra di dialogo che richiede di confermare l'azione di annullamento del deployment

  5. Fai clic su Annulla il deployment.

    L'interfaccia utente aggiorna lo stato per indicare che il deployment della revisione è stato annullato immediatamente dal cluster:

    Menu a discesa che mostra che il proxy API non è stato disegnato dall'ambiente di test

    Tieni presente, però, che la procedura di annullamento del deployment può richiedere del tempo (nel modello eventualmente coerente). Infatti, quando fai clic su Annulla deployment, Apigee avvia la procedura di annullamento del deployment della revisione selezionata dall'ambiente nel cluster.

    Per informazioni su come controllare lo stato del proxy non di cui non è stato eseguito il deployment, consulta Visualizzare lo stato del deployment.

In alternativa, puoi annullare il deployment della revisione corrente che stai modificando nella scheda Sviluppa:

  1. Fai clic sull'elenco a discesa Esegui il deployment in: env_name:

    Menu a discesa di Deployment che consente di eseguire il deployment o il dis-deployment della revisione corrente in ogni ambiente

    L'interfaccia utente mostra un elenco di ambienti. Nella colonna Revisione, l'interfaccia utente elenca la revisione attualmente di cui è stato eseguito il deployment (o &emdash; se non è presente alcuna revisione) e mostra i pulsanti Esegui deployment revision e Esegui il rollback del deployment.

  2. Fai clic sul pulsante Esegui il ritiro per l'ambiente che preferisci.

    L'interfaccia utente ti chiede di confermare la versione di cui vuoi annullare il deployment:

    Finestra di dialogo che richiede di confermare l'operazione di annullamento del deployment del proxy API

  3. Fai clic sul pulsante Annulla il deployment.

    L'interfaccia utente aggiorna lo stato per indicare che il deployment della revisione è stato annullato immediatamente. Tuttavia, la procedura di annullamento del deployment può richiedere del tempo (nel modello coerente in modo definitivo). Quando fai clic su Annulla deployment, Apigee avvia il processo di annullamento del deployment della revisione selezionata dall'ambiente.

API Apigee

Per annullare il deployment di un proxy API, utilizza la seguente chiamata API:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \
  -X DELETE \
  -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 Impostazione delle variabili di ambiente per le richieste dell'API Apigee.

Di seguito è riportato un esempio di output della risposta (una risposta vuota):

{}

Per ulteriori informazioni, consulta l'API Annullamento del deployment della revisione del proxy API.

gcloud

Le seguenti sezioni forniscono esempi di utilizzo dei comandi gcloud alpha apigee CLI per eseguire il annullamento del deployment delle revisioni del proxy API e convalidare l'annullamento del deployment.

Per ulteriori informazioni e una descrizione delle variabili di ambiente utilizzate negli esempi, consulta la sezione Guida introduttiva all'utilizzo di gcloud con Apigee.

Annullamento del deployment di una revisione del proxy API utilizzando gcloud CLI

Per annullare il deployment di una revisione del proxy API, utilizza il seguente comando gcloud:

gcloud alpha apigee apis undeploy $REV --api=$API --environment=$ENV

Di seguito è riportato un esempio di risposta:

Using Apigee organization `my-org`

Convalida del ritiro di una revisione del proxy API utilizzando gcloud CLI

Per verificare che la revisione del proxy API sia stata annullata dall'ambiente, utilizza il seguente comando gcloud:

gcloud alpha apigee deployments list --api=$API --environment=$ENV

Di seguito è riportato un esempio di risposta:

Using Apigee organization `my-org`
Listed 0 items.

Per ulteriori informazioni, consulta List deployments CLI.