Crea un backend Private Service Connect

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

Per saperne di più sui servizi e sulle configurazioni supportati, consulta Informazioni sui backend 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:

Ruoli

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

Prima di iniziare

  1. Determina a quale servizio vuoi connetterti:

    • Per i servizi pubblicati:

      • Se vuoi pubblicare un tuo servizio, consulta Pubblicazione di servizi gestiti.

      • Se ti connetti a un servizio Google Cloud o di terze parti pubblicato, chiedi al produttore le seguenti informazioni:

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

        • (Facoltativo) La porta utilizzata dal servizio. Se conosci la porta utilizzata, puoi specificarla come parte della configurazione del NEG Private Service Connect.

        • Eventuali requisiti per i nomi DNS utilizzati per inviare le richieste. Potresti dover utilizzare nomi DNS specifici nella configurazione della mappa URL.

    • Per le API di Google, esegui una delle seguenti operazioni:

  2. Determina quale tipo di bilanciatore del carico supporta il servizio a cui vuoi connetterti e assicurati di conoscere il bilanciatore del carico che stai aggiornando. Questa guida descrive come aggiungere un gruppo di endpoint di rete Private Service Connect a un bilanciatore del carico, ma potresti voler eseguire passaggi di configurazione aggiuntivi.

    Per ulteriori informazioni, vedi Bilanciatori del carico e <x0A>destinazioni supportati.

Crea un NEG Private Service Connect

Quando crei un NEG, scegli il tipo di destinazione a cui si connette:

  • Un servizio pubblicato
  • Un'API di Google regionale
  • Un'API di Google globale

Crea un NEG per connetterti a un servizio pubblicato

Quando crei un NEG Private Service Connect che punta a un servizio pubblicato, devi disporre dell'URI del collegamento al servizio. L'allegato del servizio ha questo formato: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME

Il producer di servizi potrebbe anche fornire una porta da utilizzare per questo servizio. In caso affermativo, assicurati di includere la porta del produttore nella configurazione NEG.

Per informazioni sui bilanciatori del carico supportati per questa configurazione, consulta Destinazioni del servizio pubblicate.

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 il target:

    1. In Destinazione, seleziona Servizio pubblicato.
    2. Per Servizio di destinazione, inserisci l'URI del collegamento al servizio.
    3. (Facoltativo) Per Porta del producer, inserisci la porta che il producer ti ha fornito. Se viene omessa, la porta viene assegnata automaticamente.

    4. 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

Utilizza 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

Se sai quale porta viene utilizzata dal produttore, puoi specificarla con --producer-port=PORT.

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, devi fornire una subnet. Se vengono omessi sia la rete che la subnet, viene utilizzata la rete predefinita e la subnet predefinita nel REGION specificato.

  • PORT: la porta utilizzata dal produttore per il servizio.

Crea un NEG per connetterti a un'API di Google regionale

Puoi creare un NEG per connetterti a un'API di Google regionale.

Per informazioni sui bilanciatori del carico supportati per questa configurazione, consulta Target API Google regionali.

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 il target:

    1. In Target, seleziona API Google.
    2. Seleziona una regione e il servizio di destinazione.

  6. Fai clic su Crea.

gcloud

Utilizza 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'endpoint di servizio regionale 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 connetterti a un'API di Google globale

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

Per informazioni sui bilanciatori del carico supportati per questa configurazione, consulta Destinazioni API Google globali.

Per istruzioni complete sulla creazione di un bilanciatore del carico di applicazioni interno tra regioni e di un NEG Private Service Connect per accedere alle API di Google globali, consulta Accedere alle API di Google globali.

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 il target:

    1. Per Target, seleziona API di Google globali.
    2. Seleziona una regione e il servizio di destinazione.

  6. Fai clic su Crea.

gcloud

Utilizza 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 Specifiche.

Aggiungi un backend a un bilanciatore del carico delle applicazioni

Aggiungi un NEG a un bilanciatore del carico delle applicazioni.

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 da 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 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 connetterti 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 ogni 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. Crea un servizio di backend per il servizio di destinazione.

    • Se aggiungi il servizio di backend a un bilanciatore del carico regionale, 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 regionale, 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 regioni diverse 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 di percorso alla mappa URL del bilanciatore del carico.

    • Se la mappa URL è regionale, 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 di 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 di percorso.
      • BACKEND_SERVICE_NAME: il nome del servizio di backend.

  2. Per ogni nome host, aggiungi una regola 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 è regionale, 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 questo servizio.
      • PATH_MATCHER: il nome del matcher di 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 questo servizio.
      • PATH_MATCHER: il nome del matcher di percorso.

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

Puoi aggiungere un backend NEG di 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 di zona" o configurare i controlli di integrità. Anziché configurare un NEG zonale, 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. In Tipo di backend, seleziona Gruppo di endpoint di rete Private Service Connect.
  3. In Nuovo backend, seleziona il NEG che hai creato.
  4. Mantieni i restanti valori predefiniti 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. Crea 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 di zona, ma non completare i passaggi "Crea i NEG di zona" o configurare i controlli di integrità. Anziché configurare un NEG zonale, 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 esterno regionale che stai creando, fai clic su Configurazione backend.
  2. In Tipo di backend, seleziona Gruppo di endpoint di rete Private Service Connect.
  3. In Nuovo backend, seleziona il NEG che hai creato.
  4. Mantieni i restanti valori predefiniti 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. Crea 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 i 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 di Private Service Connect vengono visualizzati nella sezione Endpoint del bilanciatore del carico.

Descrivere 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 visualizzi 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 URL non è ancora stata propagata.

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

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

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

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

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