Questa pagina mostra come abilitare l'affinità sessione per la revisione del servizio Cloud Run.
Come funziona l'affinità sessione
Per impostazione predefinita, l'affinità sessione non è abilitata, pertanto le richieste dallo stesso client potrebbero essere gestite da istanze diverse, come mostrato qui:
Se abiliti l'affinità sessione, Cloud Run instrada 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 ispeziona il valore per
identificare più richieste dello stesso client e indirizza tutte queste richieste alla
stessa istanza, come mostrato di seguito:
Comportamenti chiave da tenere presente
Come mostrato nel diagramma in alto, con l'affinità sessione abilitata, un client raggiungerà la stessa istanza. Tuttavia, tieni presente che l'istanza può ricevere richieste da client diversi. Affinità sessione non significa che l'istanza è dedicata a un solo client.
A causa del comportamento della scalabilità automatica di Cloud Run, l'affinità sessione è l'affinità best effort. Se l'istanza viene terminata per qualsiasi motivo o raggiunge il numero massimo di richieste di contemporaneità o l'utilizzo massimo della CPU, l'affinità della sessione non funziona e ulteriori richieste vengono instradate a un'altra istanza.
Sebbene sia possibile memorizzare nella cache i dati della sessione client nella memoria delle istanze, non è possibile presumere che un client si connetta sempre alla stessa istanza, anche quando l'affinità sessione è abilitata.
Se utilizzi Cloud Load Balancing, l'affinità sessione del servizio Cloud Run può essere associata all'affinità sessione dei bilanciatori del carico globali e interni.
Affinità sessione e suddivisione del traffico
Puoi abilitare o disabilitare l'affinità sessione a livello di revisione. Se abiliti l'affinità sessione su una revisione di 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 client che utilizza l'affinità sessione è responsabile della maggior parte di tutte le richieste, tutte queste richieste possono essere instradate a una determinata revisione, indipendentemente dalla configurazione di suddivisione del traffico.
Se attivi la suddivisione del traffico per le revisioni in cui alcune revisioni hanno l'affinità sessione abilitata e altre no, il risultato è che le richieste vengono spostate gradualmente verso revisioni con affinità sessione abilitata, 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, per cui alcune verranno infine assegnate a una revisione con affinità sessione e, successivamente, queste richieste rimarranno con quella particolare revisione.
Quando aggiorni la configurazione della suddivisione del traffico per un servizio Cloud Run, le richieste successive con cookie di affinità sessione 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 divideva il traffico al 90%/10% e la suddivisione del traffico viene aggiornata all'80%/20%, il 10% del traffico verrà reindirizzato alla revisione che ora gestisce il 20% del traffico.
Imposta affinità sessione
Qualsiasi modifica alla configurazione porta alla creazione di una nuova revisione. Anche le revisioni successive riceveranno 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 Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio e 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 come preferisci, poi 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.
Riga di comando
Per specificare l'affinità sessione, utilizza il comando seguente:
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 rimuovere l'affinità sessione.
- "BOOL" con valore "
Crea o aggiorna il servizio utilizzando il comando seguente:
gcloud run services replace service.yaml
Visualizza le impostazioni di affinità sessione
Per visualizzare le impostazioni attuali di affinità sessione 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.
Riga di comando
Utilizza questo comando:
gcloud run services describe SERVICE
Individua l'impostazione di affinità sessione nella configurazione restituita.