La pubblicazione Knative consente di specificare quali revisioni devono ricevere traffico e le percentuali di traffico ricevute da una revisione. Questa funzionalità consente di eseguire il rollback a una revisione precedente, implementare gradualmente una 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 verso le revisioni della pubblicazione di Knative.
Rollback a una revisione precedente
Per eseguire il rollback a una revisione precedente:
Console
Vai alla gestione di Knative nella console Google Cloud:
Individua il servizio nell'elenco e fai clic su di esso.
Fai clic sulla scheda Revisioni per visualizzare l'elenco delle revisioni correnti per quel servizio.
Nell'elenco delle revisioni, fai clic sull'icona con i puntini di sospensione a destra della revisione di cui stai eseguendo il rollback:
Fai clic su Gestisci traffico per visualizzare il modulo di gestione del traffico:
- Seleziona dall'elenco a discesa la revisione precedente di cui vuoi eseguire il rollback.
- Impostare la percentuale di traffico della revisione precedente su 100.
- Imposta la percentuale della revisione attualmente pubblicata su 0.
- Fai clic su Salva.
Riga di comando
Utilizza il seguente 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 a cui stai eseguendo il rollback.
YAML
Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe
utilizzando il flag --format=export
.
Puoi quindi modificare il file YAML ed
eseguire il deployment delle modifiche con il comando gcloud run services replace
.
Devi assicurarti di modificare solo gli attributi specificati.
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 di pubblicazione Knative.
Nel file locale, aggiorna l'attributo
traffic
che si trova inspec
: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 stai eseguendo il rollback.
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
Vai alla gestione di Knative nella console Google Cloud:
Individua il servizio nell'elenco e fai clic su di esso.
Fai clic su Esegui il deployment di nuova revisione.
Compila il modulo di deployment se necessario, ma assicurati che la casella di controllo Pubblica immediatamente questa revisione sia NON CONTROLLATA.
Fai clic su Esegui il deployment.
Fai clic su Gestisci traffico.
La nuova revisione è elencata ma con una percentuale impostata su 0: al momento non gestisce alcun traffico. Nel modulo:
- Impostala sulla percentuale desiderata, ad esempio 5. Tieni presente che la percentuale della versione attualmente pubblicata viene ridotta automaticamente dello stesso importo.
- Fai clic su Salva.
- Ripeti questi passaggi in Gestione del traffico, ma con percentuali modificate, aumentando la percentuale secondo necessità per la nuova revisione. Non è necessario eseguire nuovamente il deployment per modificare le percentuali di traffico.
Riga di comando
Per eseguire il deployment della revisione da implementare gradualmente, inizialmente impostandola 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.
Specifica la percentuale di traffico da gestire con la 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 esempioLATEST=5
. - Sostituisci PERCENTAGE con la percentuale di traffico che vuoi inviare alla nuova revisione, ad esempio
5
per inviarle il 5% del traffico.
Quando le prestazioni della revisione sono soddisfacenti, ripeti il passaggio
update-traffic
precedente, 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 flag --format=export
.
Puoi quindi modificare il file YAML ed
eseguire il deployment delle modifiche con il comando gcloud run services replace
.
Devi assicurarti di modificare solo gli attributi specificati.
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 di pubblicazione Knative.
Apporta le modifiche alla configurazione del servizio come descritto nelle varie pagine di configurazione e specifica il nome della versione che vuoi 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 che vuoi che abbia la nuova revisione.
Sotto l'attributo
spec
, individua e aggiorna l'attributotraffic
in modo che la nuova revisione pubblichi 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 la somma delle percentuali deve essere 100. Sostituisci
- REVISION-NEW con il nome della revisione che stai implementando gradualmente.
- REVISION-FORMER con il nome della revisione attualmente pubblicata.
- 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
Vai alla gestione di Knative nella console Google Cloud:
Individua il servizio nell'elenco e fai clic su di esso.
Fai clic su Gestisci traffico.
È elencata la nuova revisione attualmente in fase di pubblicazione. Nel modulo:
- Imposta la percentuale di revisione attualmente pubblicata sulla suddivisione desiderata.
- Seleziona una delle revisioni precedenti utilizzando l'elenco a discesa e impostala sulla suddivisione percentuale desiderata.
- Per suddividere il traffico tra più revisioni, fai clic su Aggiungi revisione, seleziona la revisione desiderata e imposta la percentuale sulla suddivisione desiderata.
- Fai clic su Salva.
Riga di comando
Specifica le revisioni e la percentuale di traffico per ogni 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 di revisioni delimitato da virgole che vuoi
ricevere traffico e la corrispondente percentuale di traffico,
per un totale del 100%:
REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEn
ad esempiohello2-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 flag --format=export
.
Puoi quindi modificare il file YAML ed
eseguire il deployment delle modifiche con il comando gcloud run services replace
.
Devi assicurarti di modificare solo gli attributi specificati.
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 di pubblicazione Knative.
Nel file locale, aggiorna l'attributo
traffic
in modo che la nuova revisione pubblica 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.
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 fare in modo che questa revisione, insieme a tutte quelle future, coprano il 100% del traffico il prima possibile, sostituendo qualsiasi suddivisione del traffico stabilita:
Console
Vai alla gestione di Knative nella console Google Cloud:
Individua il servizio nell'elenco e fai clic su di esso.
Fai clic su Esegui il deployment di nuova revisione.
Compila il modulo di deployment in base alle esigenze, assicurandoti di selezionare la casella di controllo con l'etichetta Pubblica immediatamente questa revisione. Questa operazione sostituirà qualsiasi suddivisione del traffico esistente, in quanto la nuova revisione gestisce il 100% del traffico.
Fai clic su Esegui il deployment.
Riga di comando
Per inviare tutto il traffico alla revisione di cui è stato eseguito il deployment più di 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 flag --format=export
.
Puoi quindi modificare il file YAML ed
eseguire il deployment delle modifiche con il comando gcloud run services replace
.
Devi assicurarti di modificare solo gli attributi specificati.
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 di pubblicazione Knative.
Nel file locale, aggiorna l'attributo
traffic
che si trova inspec
:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: ... traffic: - latestRevision: true percent: 100
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 eseguito il deployment di un servizio, puoi creare una nuova revisione e assegnare un tag che ti consenta di accedere alla revisione a un URL specifico senza gestire il traffico. Puoi quindi utilizzare quel tag per eseguire gradualmente la migrazione del traffico alla revisione con tag e per eseguire il rollback di una revisione con tag.
Un caso d'uso comune per questa funzionalità consiste nell'utilizzare la funzionalità per i test e il controllo di una nuova revisione del servizio prima di gestire tutto il traffico, in questa sequenza tipica:
- Esegui test di integrazione su un container durante lo sviluppo.
- Esegui il deployment del container in un progetto Google Cloud che utilizzi solo per la gestione temporanea e senza traffico e il test rispetto a una revisione con tag.
- Esegui il deployment in produzione, senza gestire il traffico, ed esegui il test con una revisione con tag in produzione.
- Esegui la migrazione del traffico alla revisione con tag.
Deployment di una nuova revisione con tag
Per eseguire il deployment in produzione di una nuova revisione di un servizio esistente:
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 tuo tag in minuscolo
Il tag consente di testare direttamente la nuova revisione in un URL specifico, senza
gestire il traffico. L'URL di test inizia con il
nome del tag fornito:
http://{TAG_NAME}---{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.nip.io
Ad esempio, se hai utilizzato il nome del tag green
nel
servizio myservice
, testeresti la revisione del tag in corrispondenza dell'URL:
https://green---myservice.default.kuberun.11.111.11.111.nip.io
Migrazione del traffico a una revisione con tag
Dopo aver verificato che la nuova revisione funzioni correttamente, puoi iniziare a eseguire la migrazione del traffico alla nuova revisione utilizzando la console Google Cloud, la riga di comando gcloud o un file YAML:
Console
Vai alla gestione di Knative nella console Google Cloud:
Individua il servizio nell'elenco dei servizi e fai clic su di esso:
Seleziona la revisione codificata a cui vuoi inviare il traffico:
Fai clic su Gestisci traffico.
Individua il nome della revisione codificata: è elencata ma con una percentuale impostata su 0: al momento non gestisce traffico. Nel modulo Gestisci traffico*:
- Impostala sulla percentuale desiderata, ad esempio 5. Tieni presente che la percentuale della versione attualmente pubblicata viene ridotta automaticamente dello stesso importo.
- Fai clic su Salva.
- Per un periodo di ore o giorni, a seconda delle esigenze, ripeti questi passaggi di Gestione del traffico, ma con percentuali modificate, aumentando la percentuale secondo necessità per la revisione codificata. 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 deve essere pubblicata dalla revisione codificata, ad esempio
1
.
YAML
Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe
utilizzando il flag --format=export
.
Puoi quindi modificare il file YAML ed
eseguire il deployment delle modifiche con il comando gcloud run services replace
.
Devi assicurarti di modificare solo gli attributi specificati.
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 di pubblicazione Knative.
Apporta le modifiche alla configurazione del servizio come descritto nelle varie pagine di configurazione.
Sotto l'attributo
spec
, individua e aggiorna l'attributotraffic
per la revisione con tag in modo che la revisione con tag pubblichi 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 la somma delle percentuali deve essere 100. Sostituisci
- REVISION con il nome della revisione codificata.
- TAG_NAME con il nome del tag che stai implementando gradualmente.
- PERCENT-NEW con la percentuale di traffico che vuoi inviare alla
revisione codificata; ad esempio, utilizza
10
per inviare il 10% del traffico a quella revisione. - REVISION-FORMER con il nome della revisione attualmente pubblicata.
- PERCENT-FORMER con la percentuale di traffico che vuoi inviare alla vecchia revisione
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
gcloud run services replace service.yaml