Annullamento del deployment di un proxy API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza 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 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 riapplicarlo in un secondo momento. Se lo elimini, 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 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. Nella UI viene visualizzata la vista Panoramica del proxy API.

    in modalità Panoramica.

  3. Passa il cursore 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'UI di Apigee.
  2. Seleziona Sviluppa > Proxy API.

    La UI 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 Annulla deployment:

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

    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 il deployment.

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

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

    Tieni presente, tuttavia, che il processo di annullamento del deployment può richiedere del tempo (nella coerente). Infatti, quando fai clic su Annulla deployment, Apigee inizia il processo per annullare il deployment della revisione selezionata da quell'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 Scheda Sviluppo:

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

    Menu a discesa di Deployment che consente di eseguire il deployment o il dis-deployment della revisione corrente 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 non è presente) e mostra i pulsanti Esegui deployment revision e Esegui il rollback del 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.

    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 una revisione 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 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 maggiori informazioni, consulta Annulla il deployment dell'API di 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 per una descrizione delle variabili di ambiente utilizzate negli esempi, consulta Introduzione a 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 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 maggiori informazioni, consulta Elenco dei deployment dell'interfaccia a riga di comando.