Rollback, rilasci graduali, migrazione del traffico

Knative serving ti consente di specificare quali revisioni devono ricevere il traffico. e specificare le percentuali di traffico ricevute da una revisione. Questo consente di tornare a una revisione precedente, implementare revisione (nota anche come deployment blu/verde) e suddividere il traffico tra più revisioni. In questa pagina viene descritto come utilizzare questa funzionalità per gestire il traffico alle revisioni di Knative serving.

Eseguire il rollback a una revisione precedente

Per eseguire il rollback a una revisione precedente:

Console

  1. Vai a Knative serving nella console Google Cloud:

    Vai a Knative serving

  2. Individua il servizio nell'elenco dei servizi e fai clic su di esso.

  3. Fai clic sulla scheda Revisioni per visualizzare l'elenco delle revisioni correnti per quel servizio.

  4. Nell'elenco delle revisioni, fai clic sull'icona dei tre puntini a destra della revisione di cui vuoi eseguire il rollback:

  5. Fai clic su Gestisci traffico per visualizzare il modulo di gestione del traffico:

    1. Seleziona nel menu a discesa la revisione precedente di cui vuoi eseguire il rollback dall'elenco di lettura.
    2. Imposta la percentuale di traffico della revisione precedente su 100.
    3. Imposta la percentuale della revisione attualmente in fase di elaborazione su 0.
    4. Fai clic su Salva.

Riga di comando

Utilizza questo comando:

gcloud run services update-traffic SERVICE --to-revisions REVISION=100

  • Sostituisci SERVICE con il nome del servizio.
  • Sostituisci REVISION con il nome della revisione di cui stai eseguendo il rollback.

YAML

Puoi scaricare la configurazione di un servizio esistente in un YAML con il comando gcloud run services describe utilizzando --format=export. Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace. Assicurarsi di modificare solo gli attributi specificati.

  1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

    gcloud run services describe SERVICE --format export > service.yaml

    Sostituisci SERVICE con il nome del tuo servizio Knative serving.

  2. Nel file locale, aggiorna l'attributo traffic che si trova in spec:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
     name: SERVICE
    spec:
    ...
      traffic:
      - revisionName: REVISION
        percent: 100
    

    Sostituisci

    • REVISION con il nome della revisione a cui vuoi eseguire il rollback.
  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud run services replace service.yaml

Implementazione graduale di una revisione

Per implementare gradualmente una nuova revisione (deployment blu/verde):

Console

  1. Vai a Erogazione Knative nella console Google Cloud:

    Vai a Knative serving

  2. Individua il servizio nell'elenco dei servizi e fai clic su di esso.

  3. Fai clic su Esegui il deployment di una nuova revisione.

  4. Compila il modulo di deployment in base alle tue esigenze, ma assicurati che la casella di controllo Pubblica questa revisione immediatamente NON sia selezionata.

  5. Fai clic su Esegui il deployment.

  6. Fai clic su Gestisci traffico.

  7. La nuova revisione è elencata, ma con una percentuale impostata su 0: al momento non gestisce alcun traffico. Nel modulo:

    1. Imposta la percentuale desiderata, ad esempio 5. Tieni presente che la percentuale della versione attualmente pubblicata è automaticamente lo stesso importo.
    2. Fai clic su Salva.
    3. Ripeti questi passaggi per Gestione del traffico con le percentuali modificate. aumentando la percentuale in base alle necessità per la nuova revisione. Non è necessario eseguire nuovamente il deployment per modificare le percentuali di traffico.

Riga di comando

  1. Per implementare la revisione che vuoi implementare gradualmente, impostandola inizialmente in modo che non riceva traffico, utilizza il comando update con il parametro --no-traffic:

    gcloud run deploy --image IMAGE --no-traffic

    Sostituisci IMAGE con l'immagine di cui stai eseguendo il deployment.

  2. Specifica la percentuale di traffico che vuoi venga gestita dalla nuova revisione. Ad esempio, 5%:

    gcloud run services update-traffic SERVICE --to-revisions REVISION=PERCENTAGE
    • Sostituisci SERVICE con il nome del servizio.
    • Sostituisci REVISION con il nome della revisione che stai implementando gradualmente. Per specificare la revisione più recente, puoi utilizzare LATEST, ad esempio LATEST=5.
    • Sostituisci PERCENTAGE con la percentuale di traffico che vuoi inviare alla nuova revisione, ad esempio 5 per inviare il 5% di traffico.
  3. Quando il rendimento della revisione è soddisfacente, ripeti il passaggio precedenteupdate-traffic, ma aumenta il valore percentuale in base alle tue esigenze.

YAML

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe utilizzando il --format=export flag. Puoi quindi modificare il file YAML ed eseguire il deployment queste modifiche con il comando gcloud run services replace. Assicurarsi di modificare solo gli attributi specificati.

  1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

    gcloud run services describe SERVICE --format export > service.yaml

    Sostituisci SERVICE con il nome del tuo servizio Knative serving.

  2. Apporta le modifiche desiderate alla configurazione del servizio come descritto in da varie pagine di configurazione e specificare nome della revisione per la nuova revisione:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
     name: SERVICE
    template:
      metadata:
        annotations:
          ...
        name: REVISION-NAME
     ```
    
    Replace
    
    • REVISION-NAME con il nome da utilizzare per la nuova revisione avere.
  3. Sotto l'attributo spec, individua e aggiorna l'attributo traffic in modo che la nuova revisione generi solo una piccola quantità di traffico:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
     name: SERVICE
    spec:
    ...
      traffic:
      - revisionName: REVISION-NEW
        percent: PERCENT-NEW
      - revisionName: REVISION-FORMER
        percent: PERCENT-FORMER
    

    Tieni presente che le percentuali devono essere pari al 100%. Sostituisci

    • REVISION-NEW con il nome della revisione che stai implementando gradualmente.
    • REVISION-FORMER con il nome della revisione attualmente in fase di pubblicazione.
    • PERCENT-NEW con la percentuale di traffico da inviare alla nuova revisione, Ad esempio, utilizza 10 per inviare il 10% del traffico a quella revisione.
    • PERCENT-FORMER con la percentuale di traffico che vuoi inviare alla vecchia revisione

Suddivisione del traffico tra più revisioni

Per suddividere il traffico tra due o più revisioni:

Console

  1. Vai a Erogazione Knative nella console Google Cloud:

    Vai a Knative serving

  2. Individua il servizio nell'elenco dei servizi e fai clic su di esso.

  3. Fai clic su Gestisci traffico.

  4. Viene elencata la nuova revisione attualmente in fase di elaborazione. Nel modulo:

    1. Imposta la percentuale di revisione attualmente pubblicata sulla suddivisione desiderata.
    2. Seleziona una delle revisioni precedenti usando l'elenco a discesa e imposta con la suddivisione percentuale desiderata.
    3. Per suddividere il traffico tra più revisioni, fai clic su Aggiungi revisione. selezionare la revisione desiderata e impostare la percentuale sulla suddivisione desiderata.
    4. Fai clic su Salva.

Riga di comando

Specifica le revisioni e la percentuale di traffico per ciascuna revisione in un elenco delimitato da virgole:

gcloud run services update-traffic SERVICE --to-revisions LIST

Sostituisci:

  • SERVICE con il nome del servizio.
  • LIST con un elenco separato da virgole delle revisioni per le quali vuoi ricevere il traffico e la percentuale di traffico corrispondente, che deve ammontare al 100%:
    REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEn
    ad esempio hello2-00005-red=25,hello2-00001-bod=25,hello2-00002-nan=50.

YAML

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe utilizzando il --format=export flag. Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace. Assicurarsi di modificare solo gli attributi specificati.

  1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

    gcloud run services describe SERVICE --format export > service.yaml

    Sostituisci SERVICE con il nome del servizio Knative serving.

  2. Nel file locale, aggiorna l'attributo traffic in modo che la nuova revisione serva solo una piccola quantità di traffico:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
     name: SERVICE
    spec:
    ...
      traffic:
      - revisionName: REVISION-A
        percent: PERCENT-A
      - revisionName: REVISION-B
        percent: PERCENT-B
      - revisionName: REVISION-C
        percent: PERCENT-C
    

    Tieni presente che la somma delle percentuali deve essere 100. Sostituisci

    • REVISION-A, REVISION-B, REVISION-C con le revisioni a cui stai assegnando il traffico.
    • PERCENT-A, PERCENT-B, PERCENT-C con la percentuale per la revisione corrispondente.
  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud run services replace service.yaml

Invio di tutto il traffico all'ultima revisione

Quando esegui il deployment di una nuova revisione, puoi rendere questa e tutte quelle future gestire il 100% del traffico il prima possibile, con l'override di qualsiasi suddivisione del traffico:

Console

  1. Vai a Knative serving nella console Google Cloud:

    Vai a Knative serving

  2. Individua il servizio nell'elenco dei servizi e fai clic su .

  3. Fai clic su Deploy New Revision (Esegui il deployment di nuova revisione).

  4. Compila il modulo di deployment, se necessario, assicurandoti di controllare con la casella di controllo Pubblica questa revisione immediatamente. Verranno sostituite eventuali la suddivisione del traffico esistente, con la nuova revisione che gestisce il 100% per via del traffico.

  5. Fai clic su Esegui il deployment.

Riga di comando

Per inviare tutto il traffico alla revisione di cui è stato eseguito il deployment più recente:

gcloud run services update-traffic SERVICE --to-latest

Sostituisci SERVICE con il nome del servizio.

YAML

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe utilizzando il --format=export flag. Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace. Assicurarsi di modificare solo gli attributi specificati.

  1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

    gcloud run services describe SERVICE --format export > service.yaml

    Sostituisci SERVICE con il nome del tuo servizio Knative serving.

  2. Nel file locale, aggiorna l'attributo traffic che si trova in spec:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
     name: SERVICE
    spec:
    ...
      traffic:
      - latestRevision: true
        percent: 100
    
  3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud run services replace service.yaml

Utilizzo di tag per test, migrazione del traffico e rollback

Dopo aver implementato un servizio, puoi creare una nuova revisione e assegnare un tag che ti consenta di accedere alla revisione in un URL specifico senza pubblicare traffico. Tu puoi utilizzare quel tag per migrare gradualmente il traffico alla revisione con tag per eseguire il rollback di una revisione con tag.

Un caso d'uso comune di questa funzionalità è l'uso per testare e controllare un nuova revisione del servizio prima di gestire il traffico, in questa sequenza tipica:

  1. Esegui test di integrazione su un contenitore durante lo sviluppo.
  2. Esegui il deployment del container in un progetto Google Cloud che utilizzi solo per gestione temporanea, senza traffico e test rispetto a una revisione con tag.
  3. Esegui il deployment in produzione, senza gestire il traffico, e testa rispetto a una revisione con tag in produzione.
  4. Esegui la migrazione del traffico alla revisione con tag.

Eseguire il deployment di una nuova revisione con tag

Per eseguire il deployment di una nuova revisione di un servizio esistente in produzione:

gcloud run deploy myservice --image IMAGE_URL  --no-traffic --tag TAG_NAME

Sostituisci:

  • IMAGE_URL con l'URL della tua immagine
  • TAG_NAME con il nome del tag in minuscolo

Il tag ti consente di testare direttamente la nuova revisione in un URL specifico, senza attivare il traffico. L'URL di test inizia con il nome del tag che hai fornito: http://{TAG_NAME}---{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.nip.io

Ad esempio, se hai utilizzato il nome del tag green per il servizio myservice, dovrai testare la revisione taggata all'URL: https://green---myservice.default.kuberun.11.111.11.111.nip.io

Migrazione del traffico a una revisione con tag

Dopo aver confermato che la nuova revisione funziona correttamente, puoi iniziare la migrazione per il traffico usando la console Google Cloud, lo strumento alla riga di comando o un file YAML:

Console

  1. Vai a Knative serving nella console Google Cloud:

    Vai a Knative serving

  2. Individua il servizio nell'elenco dei servizi e fai clic su su di esso:

  3. Seleziona la revisione con tag a cui vuoi inviare il traffico:

  4. Fai clic su Gestisci traffico.

  5. Individua il nome della revisione con tag: è elencato, ma con una percentuale impostata su 0: al momento non gestisce traffico. Nel modulo Gestisci traffico*:

    1. Imposta la percentuale desiderata, ad esempio 5. Tieni presente che la percentuale della versione attualmente pubblicata è automaticamente lo stesso importo.
    2. Fai clic su Salva.
    3. Nel corso di alcune ore o giorni, se necessario, ripeti questi passaggi per la gestione del traffico, ma con percentuali diverse, aumentando la percentuale in base alle necessità per la revisione con tag. Non è necessario eseguire nuovamente il deployment per modificare le percentuali di traffico.

Riga di comando

Per eseguire la migrazione del traffico a un tag di revisione specifico:

gcloud run deploy update-traffic myservice --tag TAG_NAME=TRAFFIC_PERCENT

Sostituisci

  • TAG_NAME con il nome del tag a cui stai eseguendo la migrazione del traffico
  • TRAFFIC_PERCENT con la percentuale di traffico che vuoi la revisione codificata deve pubblicare, ad esempio 1.

YAML

Puoi scaricare la configurazione di un servizio esistente in un YAML con il comando gcloud run services describe utilizzando --format=export. Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

  1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

    gcloud run services describe SERVICE --format export > service.yaml

    Sostituisci SERVICE con il nome del servizio Knative serving.

  2. Apporta le modifiche di configurazione necessarie al servizio come descritto nelle varie pagine di configurazione.

  3. Sotto l'attributo spec, individua e aggiorna l'attributo traffic per la revisione taggata in modo che revisione gestisce solo una piccola quantità di traffico:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
     name: SERVICE
    spec:
    ...
      traffic:
      - revisionName: REVISION
        tag: TAG_NAME
        percent: PERCENT-NEW
      - revisionName: REVISION-FORMER
        percent: PERCENT-FORMER
    

    Tieni presente che le percentuali devono essere pari al 100%. Sostituisci

    • REVISION con il nome della revisione taggata.
    • TAG_NAME con il nome del tag che stai implementando gradualmente.
    • PERCENT-NEW con la percentuale di traffico che vuoi inviare alla revisione taggata, ad esempio utilizza 10 per inviare il 10% del traffico a quella revisione.
    • REVISION-FORMER con il nome della revisione attualmente in fase di pubblicazione.
    • PERCENT-FORMER con la percentuale di traffico che vuoi inviare alla vecchia revisione
  4. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

    gcloud run services replace service.yaml