Annullamento del deployment di un proxy API

Questa pagina si applica ad Apigee e Apigee hybrid.

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 di alcuna revisione del proxy API.

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 modificarlo nell'interfaccia utente per poi eseguirlo di nuovo. Se elimini il proxy API, non sarà più possibile modificarlo.

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 l'interfaccia utente 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. L'interfaccia utente mostra la visualizzazione Panoramica del proxy API.

    Proxy nella visualizzazione Panoramica.

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

    Annulla 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 Sviluppo > Proxy API.

    La UI mostra un elenco degli attuali proxy API per l'ambiente selezionato:

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

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

    L'interfaccia utente mostra la visualizzazione 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 deployment dell'elemento

    La UI richiede di confermare la versione di cui vuoi annullare il deployment:

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

  5. Fai clic su Annulla deployment.

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

    Menu a discesa che mostra l'annullamento del deployment del proxy API nell'ambiente di test

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

    Per informazioni su come controllare lo stato del proxy di cui non è stato eseguito il deployment, consulta Visualizzazione dello 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 ogni ambiente

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

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

    La UI richiede 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 deployment.

    La UI aggiorna lo stato per indicare che il deployment della revisione è stato annullato immediatamente. Tuttavia, il processo di annullamento del deployment può richiedere del tempo (nel modello a 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 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 dell'output di risposta (una risposta vuota):

{}

Per ulteriori informazioni, consulta Annullare il deployment dell'API proxy API.

gcloud

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

Per ulteriori informazioni e 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 mediante 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 della risposta:

Using Apigee organization `my-org`

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

Per confermare che è stato annullato il deployment della revisione del proxy API nell'ambiente, utilizza il seguente comando gcloud:

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

Di seguito è riportato un esempio della risposta:

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

Per maggiori informazioni, consulta Elenca l'interfaccia a riga di comando dei deployment.