Questa documentazione riguarda la versione più recente di Knative serving, che utilizza i parchi risorse e Anthos Service Mesh. Scopri di più.

La versione precedente (Cloud Run for Anthos) è stata archiviata, ma la documentazione rimane disponibile per gli utenti esistenti.

Versioni disponibili

Più recente
Archivia

Questa pagina è stata tradotta dall'API Cloud Translation.

Rollback, rilasci graduali, migrazione del traffico

Knative serving consente di specificare le revisioni che devono ricevere il 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 di Knative serving.

Rollback a una revisione precedente in corso

Per eseguire il rollback a una revisione precedente:

Console

Vai a Knative serving nella console Google Cloud:

Vai a Knative serving
Individua il servizio nell'elenco dei servizi e fai clic su di esso.
Fai clic sulla scheda Revisioni per mostrare l'elenco delle revisioni correnti per quel servizio.
Nell'elenco delle revisioni, fai clic sui 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:
1. Seleziona la revisione precedente a cui vuoi eseguire il rollback nell'elenco a discesa.
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 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. Assicurarsi 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 Knative serving.

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 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 a Knative serving nella console Google Cloud:

Vai a Knative serving
Individua il servizio nell'elenco dei servizi e fai clic su di esso.
Fai clic su Esegui il deployment di una nuova revisione.
Compila il modulo di deployment in base alle esigenze, ma assicurati che la casella di controllo con l'etichetta Invia questa revisione immediatamente sia NON CONTROLLATA.
Fai clic su Esegui il deployment.
Fai clic su Gestisci traffico.
La nuova revisione è elencata ma con una percentuale impostata pari a 0: attualmente non gestisce alcun traffico. Nel modulo:
1. Impostalo sulla percentuale desiderata, ad esempio 5. Tieni presente che la percentuale della versione attualmente in uso viene ridotta automaticamente dello stesso importo.
2. Fai clic su Salva.
3. Ripeti questi passaggi per Gestione del traffico ma 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

Per eseguire il deployment della revisione da 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.
Specifica la percentuale di traffico che deve essere gestita dalla nuova revisione, ad esempio il 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 da inviare alla nuova revisione, ad esempio 5 per inviargli il 5% del traffico.
Se le prestazioni della revisione sono soddisfacenti, ripeti il passaggio update-traffic precedente, ma aumenta il valore percentuale come preferisci.

YAML

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.
Apporta le modifiche alla configurazione del servizio come descritto nelle varie pagine di configurazione e specifica il 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 che deve avere la nuova revisione.
Sotto l'attributo spec, individua e aggiorna l'attributo traffic 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 in fase di pubblicazione.
- PERCENT-NEW con la percentuale di traffico da inviare alla nuova revisione, ad esempio usa 10 per inviare il 10% del traffico a quella revisione.
- PERCENT-FORMER con la percentuale di traffico da inviare alla revisione precedente

Suddivisione del traffico tra più revisioni

Per suddividere il traffico tra due o più revisioni:

Console

Vai a Knative serving nella console Google Cloud:

Vai a Knative serving
Individua il servizio nell'elenco dei servizi e fai clic su di esso.
Fai clic su Gestisci traffico.
Viene elencata la nuova revisione attualmente in fase di elaborazione. Nel modulo:
1. Imposta la percentuale di revisione attualmente in pubblicazione sulla suddivisione desiderata.
2. Seleziona una delle revisioni precedenti utilizzando l'elenco a discesa e impostala sulla suddivisione percentuale desiderata.
3. Per suddividere il traffico tra più revisioni, fai clic su Aggiungi revisione, seleziona la revisione che ti interessa e imposta la percentuale sulla suddivisione desiderata.
4. 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 per cui vuoi ricevere il traffico e la corrispondente percentuale di traffico, per un totale del 100%:
REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEn
ad esempio hello2-00005-red=25,hello2-00001-bod=25,hello2-00002-nan=50.

YAML

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.
Nel file locale, aggiorna l'attributo traffic 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-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 allocando 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 in corso...

Quando esegui il deployment di una nuova revisione, puoi fare in modo che questa e tutte quelle future gestiscano il 100% del traffico il prima possibile, eseguendo l'override di qualsiasi suddivisione del traffico stabilita:

Console

Vai a Knative serving nella console Google Cloud:

Vai a Knative serving
Individua il servizio nell'elenco dei servizi e fai clic su di esso.
Fai clic su Esegui il deployment di una nuova revisione.
Se necessario, compila il modulo di deployment, assicurandoti di selezionare la casella di controllo con l'etichetta Serve questa revisione immediatamente. In questo modo, la suddivisione del traffico esistente verrà ignorata e la nuova revisione gestirà 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ù recente:

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

Sostituisci SERVICE con il nome del servizio.

YAML

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.

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

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 consente di accedere alla revisione da un URL specifico senza gestire traffico. Puoi quindi utilizzare questo tag per eseguire gradualmente la migrazione del traffico alla revisione con tag ed eseguire il rollback di una revisione con tag.

Un caso d'uso comune di questa funzionalità è utilizzarla per testare e controllare una nuova revisione di un servizio prima che gestisca 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, senza gestione del traffico, ed esegui il test su una revisione con tag.
Esegui il deployment dell'app in produzione, senza gestire il traffico, e testala 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 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 che hai fornito: http://{TAG_NAME}---{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.nip.io

Ad esempio, se utilizzassi il nome tag green sul servizio myservice, testerai la revisione con 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 funziona correttamente, puoi iniziare a eseguire la migrazione del traffico utilizzando la console Google Cloud, la riga di comando gcloud o un file YAML:

Console

Vai a Knative serving nella console Google Cloud:

Vai a Knative serving
Individua il servizio nell'elenco dei servizi e fai clic su di esso:
Seleziona la revisione con tag a cui vuoi inviare il traffico:
Fai clic su Gestisci traffico.
Individua il nome della revisione con tag: è elencata ma con una percentuale impostata su 0: al momento non gestisce alcun traffico. Nel modulo Gestisci traffico*:
1. Impostalo sulla percentuale desiderata, ad esempio 5. Tieni presente che la percentuale della versione attualmente in uso viene ridotta automaticamente dello stesso importo.
2. Fai clic su Salva.
3. Per un periodo di ore o giorni, se necessario, ripeti questi passaggi di Gestione del traffico ma con le percentuali modificate, aumentando la percentuale secondo 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 su cui stai eseguendo la migrazione del traffico
TRAFFIC_PERCENT con la percentuale di traffico da pubblicare alla revisione con tag, ad esempio 1.

YAML

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.
Apporta al servizio le modifiche desiderate alla configurazione, come descritto nelle varie pagine di configurazione.
Sotto l'attributo spec, individua e aggiorna l'attributo traffic per la revisione con tag in modo che la revisione con tag gestisca 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 taggata.
- TAG_NAME con il nome del tag che stai implementando gradualmente.
- PERCENT-NEW con la percentuale di traffico da inviare alla revisione con tag, ad esempio usa 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 da inviare alla revisione precedente
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```