Questa pagina mostra come attivare l'affinità sessione per la revisione del servizio Cloud Run.
Come funziona l'affinità sessione
Per impostazione predefinita, l'affinità sessione non è attivata, pertanto le richieste dello stesso client potrebbero essere gestite da istanze diverse, come mostrato di seguito:
Se attivi l'affinità sessione, Cloud Run inoltra le richieste sequenziali per un determinato client alla stessa istanza di revisione. Cloud Run utilizza un cookie di affinità sessione con un TTL di 30 giorni e ne controlla il valore per identificare più richieste dello stesso client e indirizzarle tutte alla stessa istanza, come mostrato di seguito:
Comportamenti chiave da tenere presenti
Come mostrato nel diagramma sopra, con l'affinità sessione abilitata, un client raggiungerà la stessa istanza. Tuttavia, tieni presente che l'istanza può ricevere richieste da diversi client. L'affinità sessione non significa che l'istanza sia dedicata a un solo client.
A causa del comportamento di scalabilità automatica di Cloud Run, l'affinità sessione è un'affinità best effort. Se l'istanza viene interrotta per qualsiasi motivo o raggiunge la concorrenza massima delle richieste o l'utilizzo massimo della CPU, l'affinità sessione viene interrotta e le richieste successive vengono indirizzate a un'altra istanza.
Sebbene tu possa memorizzare nella cache i dati della sessione del client nella memoria delle istanze, non puoi assumere che un client si ricollegherà sempre alla stessa istanza, anche quando l'affinità sessione è attivata.
L'affinità di sessione di Cloud Load Balancing e l'affinità sessione di Cloud Run sono due implementazioni separate e indipendenti dellaffinità sessione. Puoi attivare l'affinità sessione di Cloud Run su un servizio Cloud Run, anche se si trova dietro un bilanciatore del carico. Tuttavia, non devi attivare l'affinità sessione di Cloud Load Balancing in un gruppo di endpoint di rete serverless, poiché non è supportata.
Affinità sessione e suddivisione del traffico
Puoi attivare o disattivare l'affinità sessione a livello di revisione. Se attivi l'affinità sessione in una revisione Cloud Run e utilizzi anche la suddivisione del traffico, l'affinità sessione ha la precedenza su qualsiasi suddivisione del traffico. In casi estremi, se un singolo cliente che utilizza l'affinità sessione è responsabile della maggior parte di tutte le richieste, tutte queste richieste possono essere indirizzate a una determinata revisione indipendentemente dalla configurazione della suddivisione del traffico.
Se attivi la suddivisione del traffico per le revisioni in cui alcune hanno l'affinità sessione abilitata e altre no, le richieste vengono gradualmente spostate verso le revisioni in cui è abilitata l'affinità sessione, anche se non modifichi esplicitamente la configurazione della suddivisione del traffico. Il motivo è che ogni richiesta che non ha un cookie di affinità sessione associato è soggetta a una suddivisione casuale, dove alcune verranno eventualmente assegnate a una revisione con affinità sessione e di conseguenza queste richieste rimarranno con quella determinata revisione.
Quando aggiorni la configurazione della suddivisione del traffico per un servizio Cloud Run, le richieste successive con cookie di affinità sessione allegati potrebbero essere assegnate a una revisione diversa. Cloud Run riduce al minimo il numero di client reindirizzati a una nuova revisione.
Ad esempio, se un servizio suddivideva il traffico in una percentuale del 90%/10% e la suddivisione viene aggiornata al 80%/20%, il 10% del traffico verrà reindirizzato alla revisione che ora pubblica il 20% del traffico.
Impostare l'affinità sessione
Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive acquisiranno automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.
Puoi impostare l'affinità sessione utilizzando la console Google Cloud, la riga di comando gcloud o un file .yaml quando crei un nuovo servizio o esegui il deployment di una nuova revisione:
Console
Nella console Google Cloud, vai a Cloud Run:
Fai clic su Esegui il deployment del contenitore e seleziona Servizio per configurare un nuovo servizio. Se stai configurando un servizio esistente, fai clic sul servizio, poi su Modifica ed esegui il deployment di una nuova revisione.
Se stai configurando un nuovo servizio, compila la pagina iniziale delle impostazioni del servizio, quindi fai clic su Container, volumi, networking, sicurezza per espandere la pagina di configurazione del servizio.
Fai clic sulla scheda Networking.
- Fai clic sulla casella di testo Affinità sessione.
Fai clic su Crea o Esegui il deployment.
gcloud
Per specificare l'affinità sessione, utilizza il seguente comando:
gcloud run services update SERVICE --session-affinity
Sostituisci
- SERVICE con il nome del servizio che stai aggiornando.
Per rimuovere l'affinità sessione, utilizza il comando
gcloud run services update SERVICE --no-session-affinity
YAML
Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:
gcloud run services describe SERVICE --format export > service.yaml
Aggiungi l'annotazione
run.googleapis.com/sessionAffinity:
:spec: template: metadata: annotations: run.googleapis.com/sessionAffinity: 'BOOL'
Sostituisci
- "BOOL" con valore "
true
" per impostare l'affinità sessione o "false
" per rimuoverla.
- "BOOL" con valore "
Crea o aggiorna il servizio utilizzando il seguente comando:
gcloud run services replace service.yaml
Visualizzare le impostazioni di affinità sessione
Per visualizzare le impostazioni di affinità sessione correnti per il servizio Cloud Run:
Console
Nella console Google Cloud, vai a Cloud Run:
Fai clic sul servizio che ti interessa per aprire la pagina Dettagli servizio.
Fai clic sulla scheda Revisioni.
Nel riquadro dei dettagli a destra, l'impostazione di affinità sessione è elencata nella scheda Networking.
gcloud
Utilizza il seguente comando:
gcloud run services describe SERVICE
Individua l'impostazione di affinità sessione nella configurazione restituita.