Accedere alle API di Google regionali tramite i backend

Console

1. Nella console Google Cloud, vai alla pagina Gruppi di endpoint di rete.

   Vai a Gruppi di endpoint di rete

2. Fai clic su Crea gruppo di endpoint di rete.

3. Inserisci un nome per il gruppo di endpoint di rete.

4. Per Tipo di gruppo di endpoint di rete, seleziona Gruppo di endpoint di rete (Private Service Connect).

5. Seleziona la regione per il gruppo di endpoint di rete.

6. Seleziona il Servizio target per il gruppo di endpoint di rete.

7. Fai clic su Crea.

gcloud

gcloud compute network-endpoint-groups create NEG_NAME \
    --network-endpoint-type=private-service-connect \
    --psc-target-service=TARGET_SERVICE \
    --region=REGION

Sostituisci quanto segue:

• NEG_NAME: un nome per il gruppo di endpoint di rete.

• TARGET_SERVICE: il servizio di destinazione a cui vuoi collegarti. Consulta l'elenco degli endpoint di servizio regionali supportati.

• REGION: la regione in cui creare il gruppo di endpoint di rete. La regione deve essere la stessa del servizio a cui vuoi connetterti.

Console

Avvia la configurazione

1. Nella console Google Cloud, vai alla pagina Bilanciamento del carico.

   Vai a Bilanciamento del carico

2. Fai clic su Crea bilanciatore del carico.
3. In Tipo di bilanciatore del carico, seleziona Bilanciatore del carico delle applicazioni (HTTP/HTTPS) e fai clic su Avanti.
4. In Pubblico o interno, seleziona Interno e fai clic su Avanti.
5. In Deployment tra regioni o in una regione singola, seleziona Ideale per workload regionali e fai clic su Avanti.
6. Fai clic su Configura.

Configurazione di base

1. Inserisci un nome per il bilanciatore del carico.
2. Seleziona una regione per il bilanciatore del carico.

3. Seleziona una rete per il bilanciatore del carico.

   La rete deve contenere una subnet solo proxy nella regione in cui stai creando il NEG e il bilanciatore del carico. Se non ne hai una, puoi fare clic su Prenota sottorete per crearne una.

4. Tieni aperta la finestra per continuare.

Configurazione backend

Il gruppo di endpoint di rete Private Service Connect è un tipo di backend del bilanciatore del carico. Devi creare un servizio di backend per ogni backend che vuoi configurare.

1. Fai clic su Configurazione backend.

2. Per ogni gruppo di endpoint di rete Private Service Connect che vuoi configurare, crea un servizio di backend.

   1. Dal menu Crea o seleziona servizi di backend, seleziona Crea un servizio di backend.
   2. Inserisci un nome per il servizio di backend.
   3. Imposta Tipo di backend su Gruppo di endpoint di rete Private Service Connect.
   4. Imposta il tipo di destinazione Private Service Connect su API di Google regionale.

   5. Seleziona HTTPS per il protocollo.

   6. Nella sezione Backend, fai clic sul menu Nuovo backend e seleziona il gruppo di endpoint di rete Private Service Connect.

      Se devi creare un nuovo gruppo di endpoint di rete Private Service Connect, fai clic su Crea gruppo di endpoint di rete Private Service Connect.

Regole di routing

L'insieme di regole per instradare le richieste HTTPS in entrata a servizi di backend o bucket di backend specifici è chiamato mappa URL. Per scoprire di più sulle mappe URL, consulta la panoramica delle mappe URL.

Se stai configurando un solo servizio di backend per il bilanciatore del carico, la regola di routing predefinita è sufficiente e puoi passare alla configurazione del frontend.

1. Se hai più di un servizio di backend, fai clic su Regole di routing.
2. Seleziona Regola host e percorso semplice.
3. Per ogni backend:
   1. Aggiungi regola host e percorso.
   2. In Host, inserisci il nome host che verrà utilizzato per inviare richieste a questo servizio, ad esempio pubsub.example.com.
   3. In Percorsi, inserisci il percorso, ad esempio /*.
   4. In Backend, seleziona il servizio di backend.

Configurazione frontend

1. Fai clic su Configurazione frontend.
2. Fai clic su Aggiungi IP e porta frontend.
3. Inserisci un nome per il bilanciatore del carico.
4. Nel campo Protocollo, seleziona HTTPS (include HTTP/2).
5. Seleziona una subnet per il bilanciatore del carico.
6. Assicurati che Porta sia impostata su 443 per consentire il traffico HTTPS.

7. In Indirizzo IP, seleziona un indirizzo IP dal menu.

   Se vuoi prenotare un nuovo indirizzo IP, fai clic su Crea indirizzo IP.

8. Fai clic sull'elenco a discesa Certificato.

   1. Se hai già una risorsa di certificato SSL con gestione indipendente che vuoi utilizzare, selezionala dal menu.
   2. In caso contrario, seleziona Crea un nuovo certificato.
   3. Inserisci un nome per la risorsa del certificato.
   4. Nei campi appropriati, carica i file in formato PEM:
      • Certificato
      • Chiave privata
   5. Fai clic su Crea.

9. Fai clic su Fine.

Esamina e finalizza

1. Fai clic su Esamina e finalizza per esaminare la configurazione.
2. Fai clic su Crea.

gcloud

1. Per ogni gruppo di endpoint di rete che hai creato, crea un servizio di backend.

   gcloud compute backend-services create BACKEND_SERVICE_NAME \
       --load-balancing-scheme=INTERNAL_MANAGED \
       --protocol=HTTPS \
       --region=REGION
   

   Sostituisci quanto segue:

   • BACKEND_SERVICE_NAME: il nome del servizio di backend.
   • REGION: la regione in cui creare il servizio di backend.

2. Per ogni servizio di backend che hai creato, aggiungi il NEG corrispondente al servizio di backend.

   gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
       --network-endpoint-group=NEG_NAME \
       --region=REGION
   

   Sostituisci quanto segue:

   • BACKEND_SERVICE_NAME: il nome del servizio di backend.
   • NEG_NAME: il nome del gruppo di endpoint di rete.
   • REGION: la regione per il backend.

3. Crea una mappa URL per il bilanciatore del carico.

   Una mappa URL deve fare riferimento a un servizio di backend predefinito. Se configuri il bilanciatore del carico con un servizio di backend, impostalo come predefinito. Se configuri il bilanciatore del carico in modo che utilizzi più servizi di backend, a cui fanno riferimento le regole host e i matcher percorso che crei nel passaggio successivo, scegli uno dei servizi di backend come predefinito per la mappa URL.

   gcloud compute url-maps create URL_MAP_NAME \
       --default-service=DEFAULT_BACKEND_SERVICE_NAME \
       --region=REGION
   

   Sostituisci quanto segue:

   • URL_MAP_NAME: un nome per la mappa degli URL.

   • DEFAULT_BACKEND_SERVICE_NAME: il nome del valore predefinito del bilanciatore del carico. Il valore predefinito viene utilizzato quando nessuna regola host corrisponde al nome host richiesto.

   • REGION: la regione in cui creare la mappa URL.

4. Aggiungi altri servizi di backend alla mappa degli URL.

   Se la mappa URL deve fare riferimento a due o più servizi di backend, completa i passaggi che seguono. Se la mappa URL fa riferimento a un solo servizio di backend, ignora questo passaggio.

   1. Per ogni servizio di backend, aggiungi un corrispettivo per i percorsi. Devi creare un parametro di corrispondenza dei percorsi per ogni servizio di backend.

      gcloud compute url-maps add-path-matcher URL_MAP_NAME \
          --path-matcher-name=PATH_MATCHER \
          --default-service=BACKEND_SERVICE_NAME \
          --region=REGION
      

      Sostituisci quanto segue:

      • URL_MAP_NAME: il nome della mappa di URL.
      • PATH_MATCHER: un nome per il matcher percorso.
      • BACKEND_SERVICE_NAME: il nome del servizio di backend.
      • REGION: la regione della mappa URL.

   2. Per ogni nome host, aggiungi una regola host.

      Ogni regola host può fare riferimento a un solo corrispondenze di percorso, ma due o più regole host possono fare riferimento alla stessa corrispondenza di percorso.

      gcloud compute url-maps add-host-rule URL_MAP_NAME \
          --hosts=HOST \
          --path-matcher-name=PATH_MATCHER \
          --region=REGION
      

      Sostituisci quanto segue:

      • URL_MAP_NAME: il nome della mappa di URL.
      • HOST: il nome host a cui inviare le richieste per questo servizio. Ad esempio, pubsub.example.com.
      • PATH_MATCHER: il nome del matcher percorso.
      • REGION: la regione della mappa URL.

5. Crea il proxy HTTPS di destinazione.

   1. Crea una risorsa del certificato SSL a livello di regione utilizzando il comando gcloud compute ssl-certificates create. I certificati gestiti da Google non sono supportati con i bilanciatori del carico delle applicazioni interni.

      gcloud compute ssl-certificates create CERTIFICATE \
          --certificate=LB_CERT \
          --private-key=LB_PRIVATE_KEY \
          --region=REGION
      

      Sostituisci quanto segue:

      • CERTIFICATE: un nome per il certificato.

      • LB_CERT: il percorso del file del certificato in formato PEM per il certificato autogestito.

      • LB_PRIVATE_KEY: il percorso del file della chiave privata in formato PEM per il certificato autogestito.

      • REGION: la regione per il certificato.

   2. Utilizza la risorsa del certificato SSL a livello di regione per creare un proxy HTTPS di destinazione con il comando gcloud compute target-https-proxies create.

      gcloud compute target-https-proxies create PROXY_NAME \
          --url-map=URL_MAP_NAME \
          --region=REGION \
          --ssl-certificates=CERTIFICATE
      

      Sostituisci quanto segue:

      • PROXY_NAME: un nome per il proxy HTTPS di destinazione.
      • URL_MAP_NAME: il nome della mappa di URL.
      • REGION: la regione per la risorsa del certificato.
      • CERTIFICATE: il nome della risorsa del certificato.

6. Prenota un indirizzo IPv4 interno regionale per la regola di forwarding.

   gcloud compute addresses create ADDRESS_NAME \
       --ip-version=IPV4 \
       --region=REGION \
       --subnet=SUBNETWORK
   

   Sostituisci quanto segue:

   • ADDRESS_NAME: un nome per la risorsa indirizzo IP.
   • REGION: la regione in cui creare l'indirizzo IP.
   • SUBNET: la subnet in cui creare l'indirizzo IP.

   Esegui questo comando per visualizzare l'indirizzo IP riservato. Dopo aver creato il bilanciatore del carico, puoi utilizzare l'indirizzo IP per verificare la configurazione.

   gcloud compute addresses describe ADDRESS_NAME \
       --format="get(address)" --region=REGION
   

7. Crea la regola di forwarding.

   Crea la regola di forwarding utilizzando il comando gcloud compute forwarding-rules create.

   gcloud compute forwarding-rules create FWD_RULE \
       --load-balancing-scheme=INTERNAL_MANAGED \
       --network=NETWORK \
       --address=ADDRESS_NAME \
       --ports=443 \
       --region=REGION \
       --target-https-proxy=PROXY_NAME \
       --target-https-proxy-region=PROXY_REGION \
      [--service-directory-registration=SD_SERVICE_NAME]
   

   Sostituisci quanto segue:

   • FWD_RULE: un nome per la regola di forwarding.

   • NETWORK: la rete in cui creare la regola di forwarding.

   • ADDRESS_NAME: l'indirizzo IP riservato.

   • REGION: la regione per la regola di forwarding.

   • PROXY_NAME: il nome del proxy HTTPS di destinazione.

   • PROXY_REGION: la regione del proxy HTTPS di destinazione.

   • SD_SERVICE_NAME: l'URI del servizio Directory dei servizi con cui vuoi registrare il bilanciatore del carico, in questo formato: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME. La specifica di --service-directory-registration è facoltativa.