Accedere alle API di Google globali tramite i backend

Console

1. Nella console Google Cloud , vai alla pagina Crea un gruppo di endpoint di rete.

   Vai a Crea un gruppo di endpoint di rete

2. Nella pagina Crea gruppo di endpoint di rete, inserisci un Nome per il gruppo di endpoint di rete.

3. Per Tipo di gruppo di endpoint di rete, seleziona NEG Private Service Connect (regionale).

4. Per Target, seleziona API di Google globali.

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

6. Seleziona il servizio di destinazione per il gruppo di endpoint di rete.

7. Fai clic su Crea.

gcloud

Utilizza il comando network-endpoint-groups create.

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: la destinazione dell'API Google globale a cui vuoi connetterti, ad esempio pubsub.googleapis.com. Consulta l'elenco dei target globali delle API di Google supportati.

• REGION: la regione in cui creare il gruppo di endpoint di rete.

API

Invia una richiesta POST al metodo regionNetworkEndpointGroups.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups
{
  "name": "NEG_NAME",
  "networkEndpointType": "PRIVATE_SERVICE_CONNECT",
  "pscTargetService": "TARGET_SERVICE"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto del gruppo di endpoint di rete.
• REGION: la regione in cui creare il gruppo di endpoint di rete.
• NEG_NAME: un nome per il gruppo di endpoint di rete.
• TARGET_SERVICE: la destinazione dell'API Google globale a cui vuoi connetterti, ad esempio pubsub.googleapis.com. Consulta l'elenco dei target globali delle API di Google supportati.

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 tra regioni 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 rete per il bilanciatore del carico.

   La rete deve contenere una subnet solo proxy nella regione in cui stai creando il bilanciatore del carico.

Configurazione frontend

1. Fai clic su Configurazione frontend.
2. Inserisci un nome per la regola di forwarding del bilanciatore del carico.
3. Nel campo Protocollo, seleziona HTTPS (include HTTP/2 e HTTP/3).
4. Seleziona una regione di subnet per la subnet del bilanciatore del carico.
5. Seleziona una subnet per il bilanciatore del carico.
6. Fai clic su Indirizzo IP ed esegui una delle seguenti operazioni:
   • Per assegnare automaticamente un indirizzo IP temporaneo, seleziona Temporaneo (automatico).
   • Per scegliere un indirizzo IP temporaneo, seleziona Temporaneo (personalizzato) e poi inserisci un indirizzo IP temporaneo personalizzato dall'intervallo di indirizzi IP della subnet del bilanciatore del carico.
   • Per prenotare e utilizzare un indirizzo IP interno statico, fai clic su Crea indirizzo IP, quindi procedi nel seguente modo:
     1. Inserisci un nome per l'indirizzo IP.
     2. Fai clic su Indirizzo IP statico, quindi esegui una delle seguenti operazioni:
        • Per assegnare automaticamente un indirizzo IP statico, seleziona Assegna automaticamente.
        • Per configurare un indirizzo IP specifico, seleziona Fammi scegliere e poi inserisci un Indirizzo IP personalizzato dall'intervallo di indirizzi IP della subnet del bilanciatore del carico.
     3. Fai clic su Prenota.
7. Assicurati che il campo Porta sia impostato su 443 per consentire il traffico HTTPS.
8. Fai clic sull'elenco Certificato e seleziona il certificato autogestito.
9. Fai clic su Fine.

Configurazione backend

1. Fai clic su Configurazione backend.

2. Per ogni API Google globale a cui vuoi accedere, crea un servizio di backend globale. Per creare un servizio di backend globale:

   1. Nel 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 globale.
   5. Seleziona HTTPS per il protocollo.

   6. Nella sezione Backend, fai clic sul menu Nuovo backend e seleziona un 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 NEG PSC.

   7. Fai clic su Fine.

   8. Fai clic su Crea.

3. Assicurati che ogni servizio di backend che vuoi aggiungere sia selezionato nel menu Crea o seleziona servizi di backend, quindi fai clic su Ok.

Regole di routing

L'insieme di regole per instradare le richieste HTTPS in entrata a servizi di backend specifici è chiamato mappa URL. Per saperne 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 a Rivedi e finalizza.

Se stai configurando più servizi di backend, devi creare un matcher di percorso per ciascun servizio di backend. Ogni regola host può fare riferimento a un solo matcher di percorso, ma due o più regole host possono fare riferimento allo stesso matcher di percorso.

1. Se hai più di un servizio di backend, fai clic su Regole di routing.
2. Seleziona Regola semplice per host e percorso.
3. Per ogni backend, procedi nel seguente modo:
   1. Fai clic su 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.

Esamina e finalizza

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

gcloud

1. Per ogni API Google globale a cui vuoi accedere:

   1. Per creare un servizio di backend globale, utilizza il comando gcloud compute backend-services create.

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

      Sostituisci BACKEND_SERVICE_NAME con il nome del servizio di backend.

   2. Per aggiungere un NEG al servizio di backend corrispondente, utilizza il comando gcloud compute backend-services add-backend.

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

      Sostituisci quanto segue:

      • NEG_NAME: il nome del NEG Private Service Connect.
      • REGION: la regione del NEG Private Service Connect.

2. Per creare una mappa URL globale per il bilanciatore del carico, utilizza il comando gcloud compute url-maps create.

   Una mappa URL deve fare riferimento a un servizio di backend predefinito. Se stai configurando il bilanciatore del carico con un servizio di backend, impostalo come predefinito. Se stai configurando il bilanciatore del carico in modo che utilizzi più servizi di backend, scegli uno dei servizi di backend da impostare come predefinito per la mappa URL.

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

   Sostituisci quanto segue:

   • URL_MAP_NAME: un nome per la mappa URL.
   • DEFAULT_BACKEND_SERVICE_NAME: il nome del servizio di backend predefinito del bilanciatore del carico. L'impostazione predefinita viene utilizzata quando nessuna regola host corrisponde al nome host richiesto.

3. (Facoltativo) Se stai configurando il bilanciatore del carico in modo che utilizzi più servizi di backend, completa questo passaggio. Se la mappa URL fa riferimento a un solo servizio di backend, salta questo passaggio.

   Per aggiungere altri servizi di backend alla mappa URL, utilizza il comando gcloud compute url-maps add-path-matcher.

   Per ogni servizio di backend, aggiungi un matcher di percorso e una o più regole dell'host. Devi creare un matcher di percorso per ogni servizio di backend. Ogni regola host può fare riferimento a un solo matcher percorso, ma due o più regole host possono fare riferimento allo stesso matcher percorso.

   gcloud compute url-maps add-path-matcher URL_MAP_NAME \
       --path-matcher-name=PATH_MATCHER \
       --default-service=BACKEND_SERVICE_NAME \
       --new-hosts=HOSTNAMES
   

   Sostituisci quanto segue:

   • PATH_MATCHER: un nome per il matcher di percorso.
   • BACKEND_SERVICE_NAME: il nome del servizio di backend.
   • HOSTNAMES: uno o più nomi host a cui inviare le richieste per il servizio di backend, ad esempio pubsub.example.com. Puoi inserire più nomi host in un elenco separato da virgole.

4. Per creare un proxy HTTPS di destinazione, utilizza il comando gcloud compute target-https-proxies create.

   gcloud compute target-https-proxies create PROXY_NAME \
       --url-map=URL_MAP_NAME \
       --certificate-manager-certificates=CERTIFICATE_NAME
   

   Sostituisci quanto segue:

   • PROXY_NAME: un nome per il proxy HTTPS di destinazione.
   • URL_MAP_NAME: il nome della mappa URL.
   • CERTIFICATE_NAME: il nome della risorsa del certificato.

5. Per creare una regola di forwarding globale per il bilanciatore del carico, utilizza il comando gcloud compute forwarding-rules create.

   gcloud compute forwarding-rules create RULE_NAME \
       --load-balancing-scheme=INTERNAL_MANAGED \
       --network=NETWORK \
       --address=IP_ADDRESS \
       --ports=443 \
       --target-https-proxy=PROXY_NAME \
       --subnet=SUBNET \
       --subnet-region=SUBNET_REGION \
       --global
   

   Sostituisci quanto segue:

   • RULE_NAME: il nome della regola di forwarding.
   • NETWORK: la rete VPC della regola di forwarding. Questa rete deve contenere una subnet solo proxy nella regione in cui stai creando il bilanciatore del carico.
   • IP_ADDRESS: l'indirizzo IP interno della regola di forwarding, che deve rientrare nell'intervallo di indirizzi IP della subnet della regola di forwarding. Per utilizzare un indirizzo IP temporaneo specifico, inserisci l'indirizzo IP, ad esempio 10.0.0.5. Per utilizzare un indirizzo IP interno statico, inserisci il nome dell'indirizzo IP. Per consentire a Google Cloud di selezionare un indirizzo IP temporaneo, ometti questo flag.
   • SUBNET: la subnet della regola di forwarding.
   • SUBNET_REGION: la regione della subnet della regola di inoltro.

API

1. Per ogni API Google globale a cui vuoi accedere:

   1. Per creare un servizio di backend globale, invia una richiesta POST al metodo backendServices.insert.

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
      {
        "loadBalancingScheme": "INTERNAL_MANAGED",
        "name": "BACKEND_SERVICE_NAME",
        "protocol": "HTTPS"
      }
      

      Sostituisci quanto segue:

      • PROJECT_ID: l'ID progetto.
      • BACKEND_SERVICE_NAME: il nome del servizio di backend.

   2. Per aggiungere un NEG al servizio di backend corrispondente, invia una richiesta PATCH al metodo backendServices.patch.

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE_NAME
      {
        "backends": [
          {
            "group": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups/NEG_NAME"
          }
        ]
      }
      

      Sostituisci quanto segue:

      • REGION: la regione del NEG.
      • NEG_NAME: il nome del gruppo di endpoint di rete da aggiungere.

2. Per creare una mappa URL globale per il bilanciatore del carico, invia una richiesta POST al metodo urlMaps.insert.

   Una mappa URL deve fare riferimento a un servizio di backend predefinito. Se stai configurando il bilanciatore del carico con un servizio di backend, impostalo come predefinito. Se stai configurando il bilanciatore del carico in modo che utilizzi più servizi di backend, scegli uno dei servizi di backend da impostare come predefinito per la mappa URL.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps
    {
      "defaultService": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/DEFAULT_BACKEND_SERVICE_NAME",
      "name": "URL_MAP_NAME"
    }
    

   Sostituisci quanto segue:

   • DEFAULT_BACKEND_SERVICE_NAME: il nome del valore predefinito del bilanciatore del carico. L'impostazione predefinita viene utilizzata quando nessuna regola host corrisponde al nome host richiesto.
   • URL_MAP_NAME: un nome per la mappa URL.

3. Se stai configurando il bilanciatore del carico in modo che utilizzi più servizi di backend, completa questo passaggio. Se la mappa URL fa riferimento a un solo servizio di backend, salta questo passaggio.

   Per aggiungere altri servizi di backend alla mappa URL, invia una richiesta PATCH al metodo urlMaps.patch.

   Per ogni servizio di backend, aggiungi un matcher di percorso e una o più regole dell'host. Devi creare un matcher di percorso per ogni servizio di backend. Ogni regola host può fare riferimento a un solo matcher percorso, ma due o più regole host possono fare riferimento allo stesso matcher percorso.

   Puoi aggiungere più criteri di corrispondenza del percorso e regole host effettuando una singola richiesta API.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME
    {
      "pathMatchers": [
        {
          "name": "PATH_MATCHER_NAME_1",
          "defaultService": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE_NAME_1"
        },
        {
          "name": "PATH_MATCHER_NAME_2",
          "defaultService": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE_NAME_2"
        }
      ],
      "hostRules": [
        {
          "hosts": ["HOSTNAME_1"],
          "pathMatcher": "PATH_MATCHER_NAME_1"
        },
        {
          "hosts": ["HOSTNAME_2"],
          "pathMatcher": "PATH_MATCHER_NAME_2"
        }
      ]
    }
    

   Sostituisci quanto segue:

   • PATH_MATCHER_NAME_1: un nome per il primo matcher di percorso.
   • BACKEND_SERVICE_NAME_1: il nome del primo servizio di backend.
   • PATH_MATCHER_NAME_2: un nome per il secondo matcher di percorso.
   • BACKEND_SERVICE_NAME_2: il nome del secondo servizio di backend.
   • HOSTNAME_1: il nome host a cui inviare le richieste per il primo servizio, ad esempio pubsub.example.com.
   • HOSTNAME_2: il nome host a cui inviare le richieste per il secondo servizio.

4. Per creare un proxy HTTPS di destinazione, invia una richiesta POST al metodo targetHttpsProxies.insert.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies
    {
      "name": "PROXY_NAME",
      "sslCertificates": [
        "https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME"
      ],
      "urlMap": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME"
    }
    

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del progetto.
   • PROXY_NAME: un nome per il proxy HTTPS di destinazione.
   • CERTIFICATE_NAME: il nome della risorsa del certificato.
   • URL_MAP_NAME: il nome della mappa URL.

5. Per creare una regola di forwarding globale per il bilanciatore del carico, invia una richiesta POST al metodo globalForwardingRules.insert. La rete della regola di forwarding deve contenere una subnet solo proxy nella subnet della regione della regola di forwarding.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules
    {
      "IPAddress": "IP_ADDRESS",
      "loadBalancingScheme": "INTERNAL_MANAGED",
      "name": "FORWARDING_RULE_NAME",
      "network": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME",
      "portRange": "443",
      "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SUBNET_REGION/subnetworks/SUBNET_NAME",
      "target": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME"
    }
    

   Sostituisci quanto segue:

   • IP_ADDRESS: l'indirizzo IP interno della regola di forwarding, che deve rientrare nell'intervallo di indirizzi IP della subnet della regola di forwarding. Per utilizzare un indirizzo IP temporaneo specifico, fornisci l'indirizzo IP, ad esempio 10.0.0.5. Per utilizzare un indirizzo IP interno statico, fornisci il nome dell'indirizzo IP. Per consentire a Google Cloud di selezionare un indirizzo IP temporaneo, ometti questo campo.
   • FORWARDING_RULE_NAME: il nome della regola di inoltro.
   • NETWORK_NAME: il nome della rete VPC della regola di forwarding. Questa rete deve contenere una subnet solo proxy nella regione in cui stai creando il bilanciatore del carico.
   • SUBNET_REGION: la regione della subnet della regola di forwardingo.
   • SUBNET_NAME: il nome della subnet della regola di forwarding.