Automatizza il failover cross-region con lo stato del servizio

Anteprima — Stato del servizio Cloud Run

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa guida mostra come eseguire il deployment di un servizio Cloud Run multiregionale ad alta disponibilità con failover e failback automatici per il traffico esterno. Puoi configurare un servizio Cloud Run con queste funzionalità configurando NEG serverless, un bilanciatore del carico delle applicazioni esterno globale e un probe di idoneità. Per maggiori informazioni, vedi Gestisci il traffico da più regioni.

Obiettivi

In questo tutorial, imparerai a:

1. Prepara l'applicazione di esempio
2. Esegui il deployment dei servizi Cloud Run in due regioni con probe di idoneità
3. Configura un bilanciatore del carico delle applicazioni esterno globale
4. Aggiungi i tuoi servizi tramite il NEG serverless
5. Testa il failover

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Abilita le API Artifact Registry, Cloud Build, API Cloud Run Admin, Network Services e API Compute Engine.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

   Abilita le API

2. Installa e inizializza gcloud CLI.
3. Aggiorna i componenti:

   gcloud components update

4. Imposta le variabili di configurazione utilizzate in questo tutorial:

   PROJECT_ID= gcloud config set core/project PROJECT_ID
   PROJECT_NUMBER=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)")
   SERVICE=health-example
   REGION_A=us-west1
   REGION_B=europe-west1

   Sostituisci PROJECT_ID con l'ID progetto Google Cloud .

Impostare i ruoli richiesti

Per eseguire il deployment dall'origine con la build, tu o il tuo amministratore dovete concedere al account di servizio Cloud Build i seguenti ruoli IAM.

Fai clic per visualizzare i ruoli richiesti per il account di servizio Cloud Build

Cloud Build utilizza automaticamente l'account di servizio predefinito di Compute Engine come service account Cloud Build predefinito per creare il codice sorgente e la risorsa Cloud Run, a meno che tu non esegua l'override di questo comportamento. Per consentire a Cloud Build di creare le tue origini, chiedi all'amministratore di concedere il ruolo Cloud Run Builder (roles/run.builder) al account di servizio Compute Engine predefinito nel tuo progetto:

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:[e-mail] \
      --role=roles/run.builder
  

Sostituisci PROJECT_NUMBER con il numero del tuo progetto Google Cloude PROJECT_ID con l'ID progetto Google Cloud. Per istruzioni dettagliate su come trovare l'ID progetto e il numero di progetto, vedi Creazione e gestione dei progetti.

La concessione del ruolo Cloud Run Builder al account di servizio Compute Engine predefinito richiede alcuni minuti per la propagazione.

Nota:

Il vincolo della policy dell'organizzazione iam.automaticIamGrantsForDefaultServiceAccounts impedisce che il ruolo Editor venga concesso automaticamente ai service account predefiniti. Se hai creato la tua organizzazione dopo il 3 maggio 2024, questo vincolo viene applicato per impostazione predefinita.

Ti consigliamo vivamente di applicare questo vincolo per disattivare la concessione automatica dei ruoli. Se disattivi la concessione automatica dei ruoli, devi decidere quali ruoli concedere ai service account predefiniti, quindi concederli personalmente.

Se il service account predefinito dispone già del ruolo Editor, ti consigliamo di sostituire il ruolo Editor con ruoli meno permissivi.Per modificare in sicurezza i ruoli del service account, utilizza Policy Simulator per vedere l'impatto della modifica, quindi concedi e revoca i ruoli appropriati.

Per ottenere le autorizzazioni necessarie all'identità di servizio per accedere al file e al bucket Cloud Storage, chiedi all'amministratore di concedere all'identità di servizio il ruolo Storage Admin (roles/storage.admin). Per maggiori dettagli su ruoli e autorizzazioni di Cloud Storage, consulta IAM per Cloud Storage.

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.

Prepara l'applicazione di esempio

Per recuperare l'esempio di codice da utilizzare:

1. Clona il repository di esempio sulla tua macchina locale:

   git clone https://github.com/GoogleCloudPlatform/golang-samples
   

2. Passa alla directory che contiene il codice campione di Cloud Run:

   cd golang-samples/run/service-health
   

Nota:se utilizzi la tua applicazione, aggiungi un endpoint HTTP/1 (quello predefinito di Cloud Run, non HTTP/2) nel codice del servizio per rispondere al probe. Il nome dell'endpoint (ad esempio /startup, /health o /are_you_ready) deve corrispondere a path nella configurazione del probe. Gli endpoint di controllo di integrità HTTP sono accessibili esternamente e seguono gli stessi principi di qualsiasi altro endpoint di servizio HTTP esposto esternamente.

Esegui il deployment del servizio Cloud Run in due regioni con probe di disponibilità

I failover richiedono almeno due servizi di regioni diverse. Per eseguire il deployment dei servizi dall'origine in due regioni diverse con i probe di preparazione, esegui i seguenti comandi:

1. Esegui il deployment del servizio health-example in us-west1 e europe-west1 dalla directory di origine. Per configurare il controllo dell'integrità del servizio con i probe di preparazione, devi avere almeno un'istanza minima:

   gcloud beta run deploy $SERVICE \
   --source=. \
   --regions=$REGION_A,$REGION_B \
   --min=10 \
   --readiness-probe httpGet.path="/are_you_ready"
   

2. Rispondi a eventuali richieste di installazione delle API necessarie rispondendo y quando richiesto. Devi farlo solo una volta per progetto. Rispondi agli altri prompt fornendo la piattaforma e la regione, se non hai impostato i valori predefiniti per questi elementi come descritto nella sezione Prima di iniziare.

Configura un bilanciatore del carico delle applicazioni esterno globale

Per configurare un bilanciatore del carico delle applicazioni esterno globale per instradare il traffico tra us-west1 e europe-west1, segui questi passaggi:

1. Crea un servizio di backend:

   gcloud compute backend-services create $SERVICE-bs \
     --load-balancing-scheme=EXTERNAL_MANAGED \
     --global
   

2. Configura un indirizzo IP esterno statico e globale per raggiungere il bilanciatore del carico:

   gcloud compute addresses create $SERVICE-ip \
     --network-tier=PREMIUM \
     --ip-version=IPV4 \
     --global
   

3. Crea una mappa URL per instradare le richieste in entrata al servizio di backend:

   gcloud compute url-maps create $SERVICE-lb \
     --default-service $SERVICE-bs
   

4. Crea un proxy HTTP di destinazione per instradare le richieste alla mappa URL:

   gcloud compute target-http-proxies create $SERVICE-hp \
   --url-map=$SERVICE-lb
   

5. Crea una regola di forwarding per indirizzare le richieste in entrata al proxy:

   gcloud compute forwarding-rules create $SERVICE-fr \
     --load-balancing-scheme=EXTERNAL_MANAGED \
     --network-tier=PREMIUM \
     --address=$SERVICE-ip \
     --target-http-proxy=$SERVICE-hp \
     --global \
     --ports=80
   

Aggiungere i tuoi servizi tramite un NEG serverless

Per aggiungere i servizi che hai eseguito il deployment in us-west1 e europe-west1 utilizzando il NEG serverless, segui questi passaggi:

1. Crea un gruppo di endpoint di rete (NEG) serverless per il tuo servizio Cloud Run in us-west1 e europe-west1:

   gcloud compute network-endpoint-groups create $SERVICE-neg-$REGION_A \
       --region $REGION_A \
       --network-endpoint-type=serverless \
       --cloud-run-service=$SERVICE
   

   gcloud compute network-endpoint-groups create $SERVICE-neg-$REGION_B \
       --region $REGION_B \
       --network-endpoint-type=serverless \
       --cloud-run-service=$SERVICE
   

2. Aggiungi il NEG serverless come backend ai servizi di backend in us-west1 e europe-west1:

   gcloud compute backend-services add-backend $SERVICE-bs \
       --global \
       --network-endpoint-group=$SERVICE-neg-$REGION_A \
       --network-endpoint-group-region=$REGION_A
   

   gcloud compute backend-services add-backend $SERVICE-bs \
       --global \
       --network-endpoint-group=$SERVICE-neg-$REGION_B \
       --network-endpoint-group-region=$REGION_B
   

Per ulteriori opzioni di configurazione, consulta Configurare un bilanciatore del carico delle applicazioni esterno globale con Cloud Run.

Testa il failover

Per testare il failover per garantire l'affidabilità e la resilienza dei tuoi servizi Cloud Run, segui questi passaggi:

1. Esegui questo comando per ottenere l'indirizzo IP del bilanciatore del carico:

   LBIP=$(gcloud compute addresses describe $SERVICE-ip --global --format='value(address)')
   

2. (Facoltativo) Invia una richiesta al bilanciatore del carico se i tuoi servizi richiedono l'autenticazione:

   curl  -H "Authorization: Bearer $(gcloud auth print-identity-token)" $LBIP
   

3. Ottieni il valore della variabile LBIP eseguendo il comando echo $LBIP. Viene restituito l'indirizzo IP del bilanciatore del carico. Ad esempio, 11.22.33.44

4. Per testare un failover, vai all'URL http://LOAD_BALANCER_IP, dove LOAD_BALANCER_IP è il valore ottenuto nel passaggio precedente. Fai clic sul pulsante di attivazione/disattivazione per la tua regione nella sezione Regioni di pubblicazione. Indica la regione integra e l'istanza che gestisce il traffico:

   

Operazione riuscita: hai eseguito il deployment di un servizio Cloud Run multiregionale ad alta disponibilità con failover e failback automatici per il traffico esterno.

Esegui la pulizia

Per evitare addebiti aggiuntivi al tuo account Google Cloud , elimina tutte le risorse che hai implementato con questo tutorial.

Elimina il progetto

Se hai creato un nuovo progetto per questo tutorial, eliminalo. Se hai utilizzato un progetto esistente e devi conservarlo senza le modifiche aggiunte in questo tutorial, elimina le risorse che hai creato per il tutorial.

Il modo più semplice per eliminare la fatturazione è eliminare il progetto creato per il tutorial.

Per eliminare il progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona quello che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Elimina le risorse del tutorial

1. Elimina il servizio Cloud Run di cui hai eseguito il deployment in questo tutorial. I servizi Cloud Run non comportano costi finché non ricevono richieste.

   Per eliminare il servizio Cloud Run, esegui questo comando:

   gcloud run services delete SERVICE-NAME

   Sostituisci SERVICE-NAME con il nome del servizio.

   Puoi eliminare i servizi Cloud Run anche dalla consoleGoogle Cloud .

2. Rimuovi la configurazione della regione predefinita gcloud che hai aggiunto durante la configurazione del tutorial:

    gcloud config unset run/region
   

3. Rimuovi la configurazione del progetto:

    gcloud config unset project
   

Passaggi successivi

• Scopri di più sulle configurazioni multiregionali in altri prodotti Google Cloud :

  • Firestore
  • Spanner
  • Cloud Storage
  • Cloud SQL

• Scopri come configurare i controlli di integrità per i servizi Cloud Run

• Configura un bilanciatore del carico delle applicazioni esterno globale con Cloud Run