Crea un backend Private Service Connect

Puoi utilizzare i backend Private Service Connect per connetterti ai servizi supportati utilizzando un bilanciatore del carico per l'applicazione dei criteri. Puoi connetterti al servizio tramite una regola di forwarding mappata a un backend che contiene un gruppo di endpoint di rete (NEG) Private Service Connect.

Per ulteriori informazioni sui servizi e sulle configurazioni supportati, consulta Informazioni sui backend di Private Service Connect.

Questa guida mostra come aggiungere un NEG Private Service Connect a un bilanciatore del carico per accedere alle API di Google o a un servizio pubblicato. Questa guida non include la configurazione completa del bilanciatore del carico.

Per istruzioni che includono la creazione di un bilanciatore del carico con un backend Private Service Connect, consulta quanto segue:

• Crea un bilanciatore del carico delle applicazioni interno per accedere alle API di Google
• Crea un bilanciatore del carico delle applicazioni esterno globale per accedere a un servizio pubblicato

Ruoli

Il ruolo Amministratore bilanciatore del carico Compute (roles/compute.loadBalancerAdmin) contiene l'autorizzazione necessaria per eseguire le attività descritte in questa guida.

Prima di iniziare

1. Stabilisci a quale API o servizio vuoi connetterti:

   • Per le API di Google:

     • Scegli un endpoint del servizio di geolocalizzazione.

   • Per i servizi pubblicati:

     • Se vuoi pubblicare il tuo servizio, vedi Pubblicare servizi gestiti.

     • Se vuoi collegarti a un servizio pubblicato di Google Cloud o di terze parti, chiedi al producer le seguenti informazioni:

       • L'URI del collegamento al servizio a cui vuoi connetterti.

       • Eventuali requisiti relativi ai nomi DNS che utilizzi per inviare le richieste. Potrebbe essere necessario utilizzare nomi DNS specifici nella configurazione della mappa URL.

2. Determina quale tipo di bilanciatore del carico supporta il servizio a cui vuoi connetterti e assicurati di avere familiarità con il bilanciatore del carico che stai aggiornando. Questa guida descrive come aggiungere un NEG Private Service Connect a un bilanciatore del carico, ma potresti voler eseguire ulteriori passaggi di configurazione.

   Per maggiori informazioni, consulta Bilanciatori del carico e target supportati.

Crea un NEG Private Service Connect

Quando crei un NEG, scegli il tipo di target a cui si collega:

• Un servizio pubblicato
• Un'API di Google basata sulla località
• Un'API di Google globale

Crea un NEG per connettersi a un servizio pubblicato

Quando crei un NEG Private Service Connect che punta a un servizio pubblicato, è necessario l'URI del collegamento al servizio per il servizio. Il collegamento al servizio ha questo formato: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME

Per informazioni sui bilanciatori del carico supportati per questa configurazione, consulta Target di servizio pubblicati.

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 NEG Private Service Connect (regionale).

5. Configura la destinazione:

   1. In Destinazione, seleziona Servizio pubblicato.
   2. In Servizio di destinazione, inserisci l'URI del collegamento al servizio.

   3. Seleziona la Rete e la Subnet in cui creare il gruppo di endpoint di rete.

      La subnet deve trovarsi nella stessa regione del servizio pubblicato.

6. Fai clic su Crea.

gcloud

Usa il comando gcloud compute 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 \
    --network=NETWORK \
    --subnet=SUBNET

Sostituisci quanto segue:

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

• TARGET_SERVICE: l'URI del collegamento al servizio.

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

• NETWORK: la rete in cui creare il gruppo di endpoint di rete. Se omesso, viene utilizzata la rete predefinita.

• SUBNET: la subnet in cui creare il gruppo di endpoint di rete. La subnet deve trovarsi nella stessa regione del servizio di destinazione. Se fornisci la rete, è necessario fornire una subnet. Se sia la rete che la subnet sono omesse, viene utilizzata la rete predefinita e la subnet predefinita nel valore REGION specificato.

Crea un NEG per connettersi a un'API di Google basata sulla località

Puoi creare un NEG per connetterti a un'API di Google basata sulla località.

Per informazioni sui bilanciatori del carico supportati per questa configurazione, vedi Target dell'API di Google per località.

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 NEG Private Service Connect (regionale).

5. Configura la destinazione:

   1. In Destinazione, seleziona API di Google.
   2. Seleziona una Regione e il Servizio di destinazione.

6. Fai clic su Crea.

gcloud

Usa il comando gcloud compute 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: gli endpoint dei servizi di localizzazione a cui vuoi connetterti.

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

Crea un NEG per connettersi a un'API di Google globale

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Puoi creare un NEG Private Service Connect per connetterti a un'API di Google globale. I NEG sono a livello di regione, anche quando si connettono alle API globali. In questa configurazione, la regione viene ignorata.

Per informazioni sui bilanciatori del carico supportati per questa configurazione, consulta Target dell'API globale di Google.

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 NEG Private Service Connect (regionale).

5. Configura la destinazione:

   1. In Destinazione, seleziona API di Google globali.
   2. Seleziona una Regione e il Servizio di destinazione.

6. Fai clic su Crea.

gcloud

Usa il comando gcloud compute 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: l'API Google globale a cui vuoi connetterti.

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

Aggiungi un backend Private Service Connect a un bilanciatore del carico

Puoi configurare un bilanciatore del carico supportato per indirizzare il traffico a un backend NEG Private Service Connect.

Per ulteriori informazioni sulle configurazioni supportate, consulta le specifiche.

Aggiungi un backend a un bilanciatore del carico delle applicazioni

Aggiungi un NEG a un bilanciatore del carico delle applicazioni esterno globale, a un bilanciatore del carico delle applicazioni interno o a un bilanciatore del carico delle applicazioni esterno regionale.

Console

Modifica il bilanciatore del carico

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

   Vai a Bilanciamento del carico

2. Fai clic sul bilanciatore del carico che vuoi modificare.

3. Fai clic su Modifica.

Aggiorna la configurazione del backend

1. Fai clic su Configurazione backend.
2. Espandi l'elenco dei servizi di backend e seleziona Crea un servizio di backend.
3. Inserisci un nome per il servizio di backend.
4. Imposta il Tipo di backend su Gruppo di endpoint di rete Private Service Connect.
5. Nella sezione Backend, fai clic sull'elenco Gruppo di endpoint di rete Private Service Connect e seleziona il NEG Private Service Connect che hai creato. Fai clic su Fine.

6. Se stai configurando un bilanciatore del carico delle applicazioni esterno globale per la connessione a un servizio pubblicato in più regioni e hai creato più di un NEG Private Service Connect, fai clic su Aggiungi backend per selezionare un altro NEG.

   Ripeti questo passaggio finché tutti i NEG per questo servizio gestito non vengono aggiunti al servizio di backend.

7. Fai clic su Crea.

Aggiorna le regole di routing

1. Fai clic su Regole di routing.
2. Inserisci un Host e un Percorso per ciascun servizio di backend che hai aggiunto.
3. Per rivedere la configurazione, fai clic su Esamina e finalizza.
4. Fai clic su Crea.

gcloud

Aggiorna la configurazione del backend

1. Creare un servizio di backend per il servizio di destinazione.

   • Se aggiungi il servizio di backend a un bilanciatore del carico a livello di regione, utilizza il flag --region per specificare la stessa regione del bilanciatore del carico.

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

     Sostituisci quanto segue:

     • BACKEND_SERVICE_NAME: il nome del servizio di backend.
     • SCHEME: lo schema di bilanciamento del carico per il bilanciatore del carico che stai modificando:
       • Per un bilanciatore del carico delle applicazioni esterno regionale, utilizza EXTERNAL_MANAGED.
       • Per un bilanciatore del carico delle applicazioni interno, utilizza INTERNAL_MANAGED.
     • REGION: la regione del servizio di backend. Utilizza la stessa regione del NEG.

   • Se aggiungi il servizio di backend a un bilanciatore del carico delle applicazioni esterno globale, utilizza il flag --global.

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

     Sostituisci BACKEND_SERVICE_NAME con il nome del servizio di backend.

2. Aggiungi il NEG Private Service Connect che punta al servizio di destinazione.

   • Se aggiungi un servizio di backend a un bilanciatore del carico a livello di regione, utilizza il flag --region per specificare la stessa regione del bilanciatore del carico.

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

     Sostituisci quanto segue:

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

   • Se aggiungi un servizio di backend a un bilanciatore del carico delle applicazioni esterno globale, utilizza il flag --global.

     Se hai creato più NEG in diverse regioni per lo stesso servizio, ripeti questo passaggio per aggiungere tutti i NEG al servizio di backend.

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

     Sostituisci quanto segue:

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

Aggiorna le regole di routing

1. Per ogni servizio di backend che hai creato, aggiungi un matcher percorso alla mappa URL del bilanciatore del carico.

   • Se la mappa URL è a livello di regione, specifica la regione utilizzando il flag --region.

     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 URL.
     • PATH_MATCHER: un nome per il matcher del percorso.
     • BACKEND_SERVICE_NAME: il nome del servizio di backend.
     • REGION: la regione della mappa URL.

   • Se la mappa URL è globale, specifica il flag --global.

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

     Sostituisci quanto segue:

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

2. Aggiungi una regola host per ogni nome host.

   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.

   • Se la mappa URL è a livello di regione, specifica la regione utilizzando il flag --region.

     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 URL.
     • HOST: il nome host a cui inviare le richieste per il servizio.
     • PATH_MATCHER: il nome del matcher del percorso.
     • REGION: la regione della mappa URL.

   • Se la mappa URL è globale, specifica il flag --global.

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

     Sostituisci quanto segue:

     • URL_MAP_NAME: il nome della mappa URL.
     • HOST: il nome host a cui inviare le richieste per il servizio.
     • PATH_MATCHER: il nome del matcher del percorso.

Aggiungi un backend a un bilanciatore del carico di rete proxy interno regionale

Puoi aggiungere un backend NEG Private Service Connect a un bilanciatore del carico di rete proxy interno regionale se il NEG punta a un servizio pubblicato. I bilanciatori del carico di rete proxy interni regionali supportano un solo servizio di backend.

Per configurare il bilanciatore del carico di rete proxy interno regionale, segui le istruzioni per configurare un bilanciatore del carico di rete proxy interno regionale con backend di zona, ma non completare i passaggi "Crea i NEG a livello di zona" o non configurare i controlli di integrità. Anziché configurare un NEG a livello di zona, utilizza le seguenti istruzioni per aggiungere il NEG Private Service Connect che hai creato a un backend Private Service Connect.

Console

1. Nel bilanciatore del carico di rete proxy interno regionale che stai creando, fai clic su Configurazione backend.
2. Per Tipo di backend, seleziona Gruppo di endpoint di rete Private Service Connect.
3. Per Nuovo backend, seleziona il NEG che hai creato.
4. Conserva i valori predefiniti rimanenti e fai clic su Fine.
5. Nella console Google Cloud, verifica che sia presente un segno di spunta accanto a Configurazione backend. In caso contrario, assicurati di aver completato tutti i passaggi.

gcloud

1. Creare un servizio di backend per il servizio di destinazione.

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

   Sostituisci quanto segue:

   • BACKEND_SERVICE_NAME: il nome del servizio di backend.
   • REGION: la regione del servizio di backend. Utilizza la stessa regione del NEG.

2. Aggiungi il NEG Private Service Connect che punta al servizio di destinazione.

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

   Sostituisci quanto segue:

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

Aggiungi un backend a un bilanciatore del carico di rete proxy esterno regionale

Puoi aggiungere un backend NEG di Private Service Connect a un bilanciatore del carico di rete proxy esterno regionale se il NEG punta a un servizio pubblicato. Questo bilanciatore del carico supporta un solo servizio di backend.

Per configurare il bilanciatore del carico, segui le istruzioni per configurare un bilanciatore del carico di rete proxy esterno regionale con backend a livello di zona, ma non completare i passaggi "Crea i NEG a livello di zona" o non configurare i controlli di integrità. Anziché configurare un NEG a livello di zona, utilizza le seguenti istruzioni per aggiungere il NEG Private Service Connect che hai creato a un backend Private Service Connect.

Console

1. Nel bilanciatore del carico di rete del proxy esterno regionale che stai creando, fai clic su Configurazione backend.
2. Per Tipo di backend, seleziona Gruppo di endpoint di rete Private Service Connect.
3. Per Nuovo backend, seleziona il NEG che hai creato.
4. Conserva i valori predefiniti rimanenti e fai clic su Fine.
5. Nella console Google Cloud, verifica che sia presente un segno di spunta accanto a Configurazione backend. In caso contrario, assicurati di aver completato tutti i passaggi.

gcloud

1. Creare un servizio di backend per il servizio di destinazione.

   gcloud compute backend-services create BACKEND_SERVICE_NAME \
       --load-balancing-scheme=EXTERNAL_MANAGED \
       --protocol=TCP \
       --region=REGION
   

   Sostituisci quanto segue:

   • BACKEND_SERVICE_NAME: il nome del servizio di backend.
   • REGION: la regione del servizio di backend. Utilizza la stessa regione del NEG.

2. Aggiungi il NEG Private Service Connect che punta al servizio di destinazione.

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

   Sostituisci quanto segue:

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

Elenca backend

Puoi elencare tutti i backend Private Service Connect configurati.

Console

1. Nella console Google Cloud, vai alla pagina Private Service Connect.

   Vai a Private Service Connect

2. Fai clic sulla scheda Endpoint connessi.

   I backend Private Service Connect sono visualizzati nella sezione Endpoint del bilanciatore del carico.

Descrivi un backend

Puoi descrivere un backend Private Service Connect per visualizzarne i dettagli, incluso lo stato della connessione.

Console

1. Elenca i backend disponibili.
2. Fai clic sul backend che vuoi descrivere.

Risoluzione dei problemi

Errore durante l'accesso alla regola di forwarding del bilanciatore del carico

Se viene visualizzato un errore 404 quando provi ad accedere alla regola di forwarding del bilanciatore del carico, l'errore potrebbe avere una delle seguenti cause:

• La mappa degli URL non è stata ancora propagata.

  Se hai appena creato il bilanciatore del carico, prova ad attendere qualche minuto.

• L'URL che stai utilizzando nella tua richiesta non corrisponde a un URL definito nella mappa URL.

  Verifica che l'URL che stai cercando corrisponda alla configurazione della mappa URL nel tuo bilanciatore del carico.

• Il backend del producer di servizi non supporta l'URL a cui stai tentando di accedere

  Chiedi al producer di servizi di verificare quale URL usare per accedere al suo servizio.