Configurare i connettori nel progetto host VPC condiviso

Console

1. Vai alla dashboard della console Google Cloud.

   Vai alla dashboard della console Google Cloud

2. Nella barra dei menu nella parte superiore della dashboard, fai clic sul menu a discesa del progetto e seleziona il progetto host.

gcloud

Imposta il progetto predefinito nellgcloud CLI sul progetto host eseguendo quanto segue nel terminale:

gcloud config set project HOST_PROJECT_ID

Sostituisci quanto segue:

• HOST_PROJECT_ID: l'ID del progetto host VPC condiviso

Console

1. Abilita l'API Serverless VPC Access per il tuo progetto.

   Attiva l'API

2. Vai alla pagina Panoramica di Accesso VPC serverless.

   Vai ad Accesso VPC serverless

3. Fai clic su Crea connettore.

4. Nel campo Nome, inserisci un nome per il connettore. Il nome deve rispettare la convezione di denominazione di Compute Engine e deve contenere meno di 21 caratteri. I trattini (-) vengono conteggiati come due caratteri.

5. Nel campo Regione, seleziona una regione per il connettore. Deve corrispondere alla regione del servizio serverless.

   Se il tuo servizio si trova nella regione us-central o europe-west, utilizza us-central1 o europe-west1.

6. Nel campo Rete, seleziona la rete VPC a cui collegare il connettore.

7. Fai clic sul menu a discesa Sottorete:

   Seleziona una subnet /28 non utilizzata.

   • Le subnet devono essere utilizzate esclusivamente dal connettore. Non possono essere utilizzati da altre risorse come VM, Private Service Connect o bilanciatori del carico.
   • Per verificare che la subnet non sia utilizzata per Private Service Connect o Cloud Load Balancing, controlla che la subnet purpose sia PRIVATE eseguendo il seguente comando in gcloud CLI:

     gcloud compute networks subnets describe SUBNET_NAME
     

     Sostituisci SUBNET_NAME con il nome della subnet.

8. (Facoltativo) Per impostare le opzioni di ridimensionamento per un maggiore controllo sul connettore, fai clic su Mostra impostazioni di ridimensionamento per visualizzare il modulo di ridimensionamento.

   1. Imposta il numero minimo e massimo di istanze per il connettore oppure utilizza i valori predefiniti, ovvero 2 (min) e 10 (max). Il connettore esegue lo scale out fino al numero massimo specificato con l'aumento del traffico, ma non esegue lo scale in quando il traffico diminuisce. Devi utilizzare valori compresi tra 2 e 10 e il valore MIN deve essere inferiore al valore MAX.
   2. Nel menu a discesa Tipo di istanza, scegli il tipo di macchina da utilizzare per il connettore o utilizza il valore predefinito e2-micro. Quando scegli il tipo di istanza, noterai la barra laterale dei costi sulla destra, che mostra le stime di larghezza di banda e costi.

9. Fai clic su Crea.

10. Quando è pronto per l'uso, accanto al nome del connettore viene visualizzato un segno di spunta verde.

gcloud

1. Aggiorna i componenti di gcloud alla versione più recente:

   gcloud components update
   

2. Abilita l'API Serverless VPC Access per il tuo progetto:

   gcloud services enable vpcaccess.googleapis.com
   

3. Crea un connettore di accesso VPC serverless:

   gcloud compute networks vpc-access connectors create CONNECTOR_NAME \
   --region=REGION \
   --subnet=SUBNET \
   --subnet-project=HOST_PROJECT_ID \
   # Optional: specify minimum and maximum instance values between 2 and 10, default is 2 min, 10 max.
   --min-instances=MIN \
   --max-instances=MAX \
   # Optional: specify machine type, default is e2-micro
   --machine-type=MACHINE_TYPE

   Sostituisci quanto segue:

   • CONNECTOR_NAME: un nome per il connettore. Il nome deve rispettare la convezione di denominazione di Compute Engine e deve contenere meno di 21 caratteri. I trattini (-) vengono conteggiati come due caratteri.
   • REGION: una regione per il connettore. Deve corrispondere alla regione del servizio serverless. Se il tuo servizio si trova nella regione us-central o europe-west, utilizza us-central1 o europe-west1.
   • SUBNET: il nome di una subnet /28 inutilizzata.
     • Le subnet devono essere utilizzate esclusivamente dal connettore. Non possono essere utilizzati da altre risorse come VM, Private Service Connect o bilanciatori del carico.
     • Per verificare che la subnet non sia utilizzata per Private Service Connect o Cloud Load Balancing, controlla che la subnet purpose sia PRIVATE eseguendo il seguente comando in gcloud CLI:

       gcloud compute networks subnets describe SUBNET_NAME
       

       Sostituisci quanto segue:
       • SUBNET_NAME: il nome della subnet
   • HOST_PROJECT_ID: l'ID del progetto host
   • MIN: il numero minimo di istanze da utilizzare per il connettore. Utilizza un numero intero compreso tra 2 e 9. Il valore predefinito è 2. Per informazioni sulla scalabilità dei connettori, consulta Throughput e scalabilità.
   • MAX: il numero massimo di istanze da utilizzare per il connettore. Utilizza un numero intero compreso tra 3 e 10. Il valore predefinito è 10. Se il traffico lo richiede, il connettore esegue il ridimensionamento fino a [MAX] istanze, ma non esegue il ridimensionamento verso il basso. Per informazioni sulla scalabilità dei connettori, consulta Throughput e scalabilità.
   • MACHINE_TYPE: f1-micro, e2-micro o e2-standard-4. Per informazioni sulla velocità effettiva del connettore, inclusi il tipo di macchina e la scalabilità, consulta Velocità effettiva e scalabilità.

   Per maggiori dettagli e argomenti facoltativi, consulta la documentazione di riferimento di gcloud.

4. Prima di utilizzarlo, verifica che il connettore sia nello stato READY:

   gcloud compute networks vpc-access connectors describe CONNECTOR_NAME \
   --region=REGION

   Sostituisci quanto segue:

   • CONNECTOR_NAME: il nome del connettore, ovvero il nome specificato nel passaggio precedente
   • REGION: la regione del connettore, ovvero quella specificata nel passaggio precedente

   L'output deve contenere la riga state: READY.

Terraform

Puoi utilizzare una risorsa Terraform per abilitare l'API vpcaccess.googleapis.com.

resource "google_project_service" "vpcaccess-api" {
  project = var.project_id # Replace this with your project ID in quotes
  service = "vpcaccess.googleapis.com"
}

Puoi utilizzare i moduli Terraform per creare una rete e una subnet VPC, quindi creare il connettore.

module "test-vpc-module" {
  source       = "terraform-google-modules/network/google"
  version      = "~> 9.0"
  project_id   = var.project_id # Replace this with your project ID in quotes
  network_name = "my-serverless-network"
  mtu          = 1460

  subnets = [
    {
      subnet_name   = "serverless-subnet"
      subnet_ip     = "10.10.10.0/28"
      subnet_region = "us-central1"
    }
  ]
}

module "serverless-connector" {
  source     = "terraform-google-modules/network/google//modules/vpc-serverless-connector-beta"
  version    = "~> 9.0"
  project_id = var.project_id
  vpc_connectors = [{
    name        = "central-serverless"
    region      = "us-central1"
    subnet_name = module.test-vpc-module.subnets["us-central1/serverless-subnet"].name
    # host_project_id = var.host_project_id # Specify a host_project_id for shared VPC
    machine_type  = "e2-standard-4"
    min_instances = 2
    max_instances = 7
    }
    # Uncomment to specify an ip_cidr_range
    #   , {
    #     name          = "central-serverless2"
    #     region        = "us-central1"
    #     network       = module.test-vpc-module.network_name
    #     ip_cidr_range = "10.10.11.0/28"
    #     subnet_name   = null
    #     machine_type  = "e2-standard-4"
    #     min_instances = 2
    #   max_instances = 7 }
  ]
  depends_on = [
    google_project_service.vpcaccess-api
  ]
}

Console

1. Apri la pagina IAM.

   Vai a IAM

2. Fai clic sul menu a discesa del progetto e seleziona il progetto host.

3. Fai clic su Aggiungi.

4. Nel campo Nuove entità, aggiungi l'entità che esegue il deployment del servizio App Engine.

5. Nel campo Ruolo, seleziona Utente con accesso VPC serverless.

6. Fai clic su Salva.

gcloud

Esegui il seguente comando nel terminale:

gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
--member=PRINCIPAL \
--role=roles/vpcaccess.user

Sostituisci quanto segue:

• HOST_PROJECT_ID: l'ID del progetto host VPC condiviso
• PRINCIPAL: il principale che esegue il deployment del servizio App Engine. Scopri di più sul flag --member.

Console

1. Apri la pagina IAM.

   Vai a IAM

2. Fai clic sul menu a discesa del progetto e seleziona il progetto host.

3. Fai clic su Aggiungi.

4. Nel campo Nuove entità, inserisci l'indirizzo email dell'entità che deve essere in grado di vedere il connettore dal progetto di servizio. In questo campo puoi inserire più indirizzi email.

5. Nel campo Ruolo, seleziona Visualizzatore Accesso VPC serverless.

6. Fai clic su Salva.

gcloud

Esegui il seguente comando nel terminale:

gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
--member=PRINCIPAL \
--role=roles/vpcaccess.viewer

Sostituisci quanto segue:

• HOST_PROJECT_ID: l'ID del progetto host VPC condiviso
• PRINCIPAL: il principale che esegue il deployment dei servizi App Engine. Scopri di più sul flag --member.

Console

1. Apri la pagina IAM.

   Vai a IAM

2. Fai clic sul menu a discesa del progetto e seleziona il progetto di servizio.

3. Fai clic su Aggiungi.

4. Nel campo Nuove entità, inserisci l'indirizzo email dell'entità che deve essere in grado di vedere il connettore dal progetto di servizio. In questo campo puoi inserire più indirizzi email.

5. Nel campo Ruolo, seleziona Visualizzatore rete Compute.

6. Fai clic su Salva.

gcloud

Esegui il seguente comando nel terminale:

gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
--member=PRINCIPAL \
--role=roles/compute.networkViewer

Sostituisci quanto segue:

• SERVICE_PROJECT_ID: l'ID del progetto di servizio
• PRINCIPAL: il principale che esegue il deployment dei servizi App Engine. Scopri di più sul flag --member.