Annullamento del deployment di un proxy API

Questa pagina si applica a Apigee e Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Annulla il deployment di una revisione del proxy API dal cluster, come descritto nelle sezioni seguenti.

Tieni presente che quando annulli il deployment di una revisione:

  • Apigee non esegue il rollback della revisione alla revisione di cui è stato eseguito il deployment in precedenza.
  • Dopo l'annullamento del deployment, nell'ambiente non viene eseguito il deployment delle revisioni del proxy API.

L'annullamento del deployment di un proxy API è simile all'eliminazione di un proxy API, ma quando annulli il deployment di una revisione puoi scegliere di modificarla nell'interfaccia utente e di eseguirla di nuovo. Se 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 la UI di Apigee nella console Cloud: seleziona Sviluppo proxy > Proxy API.

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

  2. Seleziona il proxy API di cui vuoi annullare il deployment. Nella UI viene visualizzata la vista Panoramica del proxy API.

    in modalità Panoramica.

  3. Passa il cursore sopra l'icona della 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'UI di Apigee.
  2. Seleziona Develop > API Proxy.

    La UI mostra un elenco dei proxy API correnti per l'ambiente selezionato:

    Viene visualizzato un elenco di proxy API che include nome, stato, traffico oltre le 24 ore, autore e ora dell'ultima modifica.

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

    Nella UI viene visualizzata la vista Panoramica del proxy API.

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

    Menu a discesa Revisione per l'ambiente di produzione che mostra l'opzione Annulla il deployment dell'elemento

    Nella UI ti viene chiesto di confermare la versione di cui vuoi annullare il deployment:

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

  5. Fai clic su Annulla deployment.

    La UI aggiorna lo stato per indicare che il deployment della revisione nel cluster è stato immediatamente annullato:

    Menu a discesa che mostra il deployment del proxy API annullato dall'ambiente di test

    Tieni presente, tuttavia, che il processo di annullamento del deployment può richiedere del tempo (nel modello con coerenza finale). Infatti, quando fai clic su Annulla deployment, Apigee inizia il processo di annullamento del deployment della revisione selezionata dall'ambiente nel cluster.

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

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

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

    Menu a discesa Deployment che consente di eseguire il deployment della revisione corrente o annullarne il deployment in ciascun ambiente

    La UI mostra un elenco di ambienti. Nella colonna Revisione, la UI elenca la revisione attualmente di cui è stato eseguito il deployment (o &emdash; se nessuna) e ti chiede i pulsanti Esegui il deployment di revision e Annulla deployment.

  2. Fai clic sul pulsante Annulla deployment per l'ambiente che ti interessa.

    Nella UI ti viene chiesto di confermare la versione di cui vuoi annullare il deployment:

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

  3. Fai clic sul pulsante Annulla deployment.

    La UI aggiorna lo stato per indicare che il deployment della revisione è stato immediatamente annullato. Tuttavia, il processo di annullamento del deployment può richiedere del tempo (nel modello con coerenza finale). Quando fai clic su Annulla deployment, Apigee avvia il processo di annullamento del deployment della revisione selezionata da quell'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 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 Utilizzo di curl. Per una descrizione delle variabili di ambiente utilizzate, consulta Impostare le variabili di ambiente per le richieste API Apigee.

Di seguito viene fornito un esempio di output di risposta (una risposta vuota):

{}

Per maggiori informazioni, consulta Annulla il deployment dell'API di revisione del proxy API.

gcloud

Le sezioni seguenti forniscono esempi di utilizzo dei comandi dell'interfaccia a riga di comando gcloud alpha apigee per annullare il deployment delle revisioni del proxy API e convalidare l'annullamento del deployment.

Per ulteriori informazioni e per una descrizione delle variabili di ambiente utilizzate negli esempi, consulta Iniziare a utilizzare 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 viene fornito un esempio della risposta:

Using Apigee organization `my-org`

Convalida dell'annullamento del deployment di una revisione del proxy API utilizzando gcloud CLI

Per verificare che sia stato annullato il deployment della revisione del proxy API dall'ambiente, utilizza il seguente comando gcloud:

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

Di seguito viene fornito un esempio della risposta:

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

Per maggiori informazioni, consulta Elenco dei deployment dell'interfaccia a riga di comando.