Connettiti a un'istanza utilizzando Private Service Connect

Console

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

   Vai a Private Service Connect

2. Fai clic sulla scheda Norme di connessione.

3. Fai clic su Crea policy di connessione.

4. Inserisci un nome per la policy di connessione.

5. Specifica la classe di servizio nel seguente modo:

   1. Per Classe di servizio di origine, seleziona Servizi Google.
   2. Dal menu Classe di servizio, seleziona google-cloud-alloydb perché AlloyDB è il servizio gestito per la policy di connessione.

6. Nella sezione Ambito degli endpoint di destinazione, seleziona una rete e una regione a cui si applica questo criterio.

7. Nella sezione Policy, seleziona una o più subnet dal menu Subnet. Le subnet vengono utilizzate per allocare indirizzi IP per gli endpoint.

8. (Facoltativo) Specifica un limite di connessioni per la policy. Il limite determina il numero di endpoint che AlloyDB può creare per questa policy di connessione. Se non specifichi un limite di connessione, non ce n'è nessuno.

9. Fai clic su Crea criterio.

gcloud

Per creare una policy di connessione al servizio, utilizza il comando service-connection-policies create.

gcloud network-connectivity service-connection-policies create POLICY_NAME \
    --network=NETWORK \
    --project=PROJECT_ID \
    --region=REGION \
    --service-class=SERVICE_CLASS \
    --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNETS \
    --psc-connection-limit=LIMIT \
    --description="DESCRIPTION" \
    --producer-instance-location=PRODUCER_INSTANCE_LOCATION \
    --allowed-google-producers-resource-hierarchy-level=LIST_OF_NODES

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di connessione al servizio.
• NETWORK: la rete a cui si applica questa policy.
• PROJECT_ID: l'ID o il numero del progetto della rete VPC. Per le reti VPC condivise, devi implementare le norme di connessione del servizio nel progetto host perché queste norme non sono supportate nei progetti di servizio.
• REGION: la regione a cui si applica questa policy. La stessa policy deve esistere per ogni regione in cui vuoi automatizzare la connettività dei servizi.
• SERVICE_CLASS: l'identificatore della risorsa fornito dal produttore della classe di servizio. Per AlloyDB, la classe di servizio è google-cloud-alloydb.
• SUBNETS: una o più subnet consumer regolari utilizzate per allocare indirizzi IP per gli endpoint Private Service Connect. Questi indirizzi IP vengono allocati automaticamente e restituiti al pool della subnet man mano che le istanze del servizio gestito vengono create ed eliminate. Le subnet devono trovarsi nella stessa regione della policy di connessione al servizio. Se più policy di connessione condividono la stessa regione, puoi riutilizzare la stessa subnet in queste policy. Puoi inserire più subnet in un elenco separato da virgole.
• LIMIT: il numero massimo di endpoint che puoi creare con questa policy. Se non specifichi un limite, non ce n'è.
• DESCRIPTION: una descrizione facoltativa della policy di connessione al servizio.

• PRODUCER_INSTANCE_LOCATION: specifica se il criterio automatizza le connessioni alle istanze AlloyDB. Puoi impostare questo valore su uno dei seguenti:

  • none (impostazione predefinita): l'istanza AlloyDB si trova nello stesso progetto della policy di connessione al servizio (o, nel caso del VPC condiviso, nei progetti connessi).
  • custom-resource-hierarchy-levels: richiede di impostare il percorso della località di Resource Manager per i progetti per i quali vuoi automatizzare la connettività tramite il parametro allowed-google-producers-resource-hierarchy-level.

• LIST_OF_NODES: imposta questo parametro se la posizione dell'istanza del produttore è impostata su custom-resource-hierarchy-levels. Questo parametro è un elenco di progetti, cartelle e organizzazioni in cui si trovano le istanze per cui vuoi automatizzare la connettività. L'elenco è in formato projects/PROJECT_ID, folders/FOLDER_ID o organizations/ORGANIZATION_ID.

Ad esempio, il seguente comando crea una policy di connessione al servizio per la classe di servizio
google-cloud-alloydb che alloca indirizzi IP dalla subnet managed-services. Con questa policy è possibile creare un massimo di 10 endpoint Private Service Connect. Gli endpoint devono essere creati in progetti che appartengono alla stessa organizzazione dell'istanza di servizio gestito. L'istanza AlloyDB si trova nel progetto myproject.

gcloud network-connectivity service-connection-policies create alloydb-policy \
    --network=default \
    --project=my-project \
    --region=us-central1 \
    --service-class=google-cloud-alloydb \
    --subnets=managed-service-subnet \
    --psc-connection-limit=10 \
    --producer-instance-location=custom-resource-hierarchy-levels \
    --allowed-google-producers-resource-hierarchy-level=projects/myproject

Console

1. Nella console Google Cloud , vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su Crea cluster.

3. In ID cluster, inserisci my-cluster.

4. Inserisci una password. Prendi nota di questa password perché la utilizzerai in questa guida rapida.

5. Mantieni la versione del database predefinita.

6. Seleziona la regione us-central1 (Iowa).

7. Mantieni l'ID istanza predefinito, my-cluster-primary.

8. In Disponibilità a livello di zona, mantieni Zona singola come opzione selezionata. Sebbene non consigliamo un'istanza a zona singola per la produzione, in questa guida rapida utilizzerai una zona singola per ridurre al minimo i costi. Per ulteriori informazioni, consulta la sezione Ridurre i costi utilizzando le istanze di base.

9. Seleziona il tipo di macchina 2 vCPU, 16 GB.

10. Mantieni la connettività IP privato.

    1. Seleziona Private Service Connect (PSC).
    2. Fai clic su Aggiungi un endpoint.
    3. Seleziona il progetto in cui vuoi creare l'endpoint.
    4. Seleziona la rete.
    5. Fai clic su Controlla policy per informazioni sulla policy di connessione al servizio.

11. Mantieni le impostazioni predefinite in Sicurezza di rete.

12. Non apportare modifiche in Mostra opzioni avanzate.

13. Fai clic su Crea cluster. Potrebbero essere necessari diversi minuti prima che AlloyDB crei il cluster e lo visualizzi nella pagina Panoramica del cluster primario.

gcloud

Per creare il cluster, utilizza il comando gcloud alloydb clusters create.

gcloud alloydb clusters create CLUSTER_ID \
  --password=PASSWORD \
  --region=REGION_ID \
  --project=PROJECT_ID \
  --enable-private-service-connect

Sostituisci quanto segue:

• CLUSTER_ID: l'ID del cluster che stai creando. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.

• PASSWORD: la password da utilizzare per l'utente postgres predefinito.

• REGION_ID: la regione in cui vuoi posizionare il cluster.

• PROJECT_ID: l'ID del progetto in cui vuoi posizionare il cluster.

Questo comando avvia un'operazione a lunga esecuzione, restituendo un ID operazione.

Per creare l'istanza AlloyDB, principale o un pool di lettura per l'utilizzo di Private Service Connect, utilizza il comando gcloud alloydb instances create. Assicurati di includere il parametro --allowed-psc-projects per specificare quali progetti consumer possono creare endpoint per connettersi a questa istanza.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --availability-type=AVAILABILITY \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --allowed-psc-projects=ALLOWED_PROJECT_LIST \
    --psc-network-attachment-uri=NETWORK_ATTACHMENT_URI \
    --psc-auto-connections=network=CONSUMER_NETWORK,project=CONSUMER_PROJECT

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza che stai creando. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• CPU_COUNT: il numero di vCPU che vuoi per l'istanza. I valori validi includono:
  • 2: 2 vCPU, 16 GB di RAM
  • 4: 4 vCPU, 32 GB di RAM
  • 8: 8 vCPU, 64 GB di RAM
  • 16: 16 vCPU, 128 GB di RAM
  • 32: 32 vCPU, 256 GB di RAM
  • 64: 64 vCPU, 512 GB di RAM
  • 96: 96 vCPU, 768 GB di RAM
  • 128: 128 vCPU, 864 GB di RAM
• AVAILABILITY: indica se questa istanza deve essere a disponibilità elevata (HA), con nodi in più zone. I valori validi includono:
  • REGIONAL: crea un'istanza HA con nodi attivo e di standby separati e failover automatico tra loro. Questo è il valore predefinito, adatto agli ambienti di produzione.
  • ZONAL: crea un'istanza di base, contenente un solo nodo e nessun failover automatico.
• REGION_ID: la regione in cui vuoi posizionare l'istanza.
• CLUSTER_ID: l'ID del cluster che hai creato in precedenza.
• ALLOWED_PROJECT_LIST: l'elenco separato da virgole di ID progetto o numeri di progetto a cui vuoi consentire l'accesso all'istanza, ad esempio my-project-1, 12345,my-project-n.
• NETWORK_ATTACHMENT_URI (facoltativo): il nome completo della risorsa dell'URI del collegamento di rete che crei per la connettività in uscita. Ad esempio: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• CONSUMER_NETWORK: il percorso della rete VPC in cui devono essere creati gli endpoint Private Service Connect. Ad esempio: projects/my-host-project/global/networks/default. Questa opzione viene applicata quando crei automaticamente gli endpoint. Assicurati che la policy di connessione al servizio sia stata creata. Puoi creare il criterio prima o dopo la creazione dell'istanza.
• CONSUMER_PROJECT: il progetto in cui viene creato l'endpoint Private Service Connect. Se utilizzi una rete VPC condiviso, può trattarsi del progetto host o del progetto di servizio. Tutti i progetti specificati nei parametri di connessione automatica vengono aggiunti automaticamente ai progetti consentiti. Se vuoi, per i progetti in cui vuoi creare manualmente endpoint Private Service Connect, puoi aggiungerli all'elenco dei progetti consentiti.

Un cluster secondario creato per un cluster primario abilitato a Private Service Connect eredita automaticamente la configurazione di Private Service Connect. Per saperne di più, consulta Creare un cluster secondario.

Terraform

Per creare un'istanza all'interno del cluster di database, utilizza una risorsa Terraform.

resource "google_alloydb_instance" "default" {
  cluster       = google_alloydb_cluster.default.name
  instance_id   = "alloydb-instance"
  instance_type = "PRIMARY"
  machine_config {
    cpu_count = 2
  }
  psc_instance_config {
  allowed_consumer_projects = ["123456789"]
  psc_interface_configs {
    network_attachment_resource = google_compute_network_attachment.default.id
  }
  }
}

resource "google_compute_network" "default" {
    name = "alloydb-network"
    auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "default" {
    name = "alloydb-subnetwork"
    region = "us-central1"
    network = google_compute_network.default.id
    ip_cidr_range = "10.0.0.0/16"
}

resource "google_compute_network_attachment" "default" {
  name                  = "alloydb-network-attachment"
  region                = "us-central1"
  connection_preference = "ACCEPT_AUTOMATIC"
  subnetworks = [
    google_compute_subnetwork.default.self_link
  ]
}

data "google_project" "project" {}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Console

1. Nella console Google Cloud , vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su Crea cluster.

3. In ID cluster, inserisci my-cluster.

4. Inserisci una password. Prendi nota di questa password perché la utilizzerai in questa guida rapida.

5. Mantieni la versione del database predefinita.

6. Seleziona la regione us-central1 (Iowa).

7. Mantieni l'ID istanza predefinito, my-cluster-primary.

8. In Disponibilità a livello di zona, mantieni Zona singola come opzione selezionata. Sebbene non consigliamo un'istanza a zona singola per la produzione, in questa guida rapida utilizzerai una zona singola per ridurre al minimo i costi. Per ulteriori informazioni, consulta la sezione Ridurre i costi utilizzando le istanze di base.

9. Seleziona il tipo di macchina 2 vCPU, 16 GB.

10. Mantieni la connettività IP privato.

    1. Seleziona Private Service Connect(PSC).
    2. Fai clic su Aggiungi un endpoint.
    3. Seleziona il progetto in cui vuoi creare l'endpoint.
    4. Seleziona la rete.
    5. Fai clic su Controlla policy per informazioni sulla policy di connessione al servizio.

11. Mantieni le impostazioni predefinite in Sicurezza di rete.

12. Non apportare modifiche in Mostra opzioni avanzate.

13. Fai clic su Crea cluster. Potrebbero essere necessari diversi minuti prima che AlloyDB crei il cluster e lo visualizzi nella pagina Panoramica del cluster primario.

gcloud

Per creare il cluster, utilizza il comando gcloud alloydb clusters create.

gcloud alloydb clusters create CLUSTER_ID \
  --password=PASSWORD \
  --region=REGION_ID \
  --project=PROJECT_ID \
  --enable-private-service-connect

Sostituisci quanto segue:

• CLUSTER_ID: l'ID del cluster che stai creando. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.

• PASSWORD: la password da utilizzare per l'utente postgres predefinito.

• REGION_ID: la regione in cui vuoi posizionare il cluster.

• PROJECT_ID: l'ID del progetto in cui vuoi posizionare il cluster.

Questo comando avvia un'operazione a lunga esecuzione, restituendo un ID operazione.

Per creare l'istanza primaria, utilizza il comando gcloud alloydb instances create.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --availability-type=AVAILABILITY \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --allowed-psc-projects=ALLOWED_PROJECT_LIST \
    --psc-network-attachment-uri=NETWORK_ATTACHMENT_URI \

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza che stai creando. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• CPU_COUNT: il numero di vCPU che vuoi per l'istanza. I valori validi includono:
  • 2: 2 vCPU, 16 GB di RAM
  • 4: 4 vCPU, 32 GB di RAM
  • 8: 8 vCPU, 64 GB di RAM
  • 16: 16 vCPU, 128 GB di RAM
  • 32: 32 vCPU, 256 GB di RAM
  • 64: 64 vCPU, 512 GB di RAM
  • 96: 96 vCPU, 768 GB di RAM
  • 128: 128 vCPU, 864 GB di RAM
• AVAILABILITY: indica se questa istanza deve essere a disponibilità elevata (HA), con nodi in più zone. I valori validi includono:
  • REGIONAL: crea un'istanza HA con nodi attivo e di standby separati e failover automatico tra loro. Questo è il valore predefinito, adatto agli ambienti di produzione.
  • ZONAL: crea un'istanza di base, contenente un solo nodo e nessun failover automatico.
• REGION_ID: la regione in cui vuoi posizionare l'istanza.
• CLUSTER_ID: l'ID del cluster che hai creato in precedenza.
• ALLOWED_PROJECT_LIST: l'elenco separato da virgole di ID progetto o numero di progetto a cui vuoi consentire l'accesso all'istanza, ad esempio my-project-1, 12345,my-project-n.
• NETWORK_ATTACHMENT_URI (facoltativo): il nome completo della risorsa dell'URI del collegamento di rete che crei per la connettività in uscita. Ad esempio: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• CONSUMER_NETWORK: il percorso della rete VPC da cui devono essere creati gli endpoint Private Service Connect. Ad esempio: projects/my-host-project/global/networks/default. Questa opzione viene applicata quando crei automaticamente gli endpoint. Assicurati che la policy di connessione al servizio sia stata creata. Puoi creare il criterio prima o dopo la creazione dell'istanza.
• CONSUMER_PROJECT: il progetto in cui viene creato l'endpoint Private Service Connect. Se utilizzi una rete VPC condiviso, può trattarsi del progetto host o del progetto di servizio. Tutti i progetti specificati nei parametri di connessione automatica vengono aggiunti automaticamente ai progetti consentiti. Se vuoi, per i progetti in cui vuoi creare manualmente endpoint Private Service Connect, puoi aggiungerli all'elenco dei progetti consentiti.

Un cluster secondario creato per un cluster primario abilitato a Private Service Connect eredita automaticamente la configurazione di Private Service Connect. Per saperne di più, consulta Creare un cluster secondario.

Terraform

Per creare un'istanza all'interno del cluster di database, utilizza una risorsa Terraform.

resource "google_alloydb_instance" "default" {
  cluster       = google_alloydb_cluster.default.name
  instance_id   = "alloydb-instance"
  instance_type = "PRIMARY"
  machine_config {
    cpu_count = 2
  }
  psc_instance_config {
  allowed_consumer_projects = ["123456789"]
  psc_interface_configs {
    network_attachment_resource = google_compute_network_attachment.default.id
  }
  }
}

resource "google_compute_network" "default" {
    name = "alloydb-network"
    auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "default" {
    name = "alloydb-subnetwork"
    region = "us-central1"
    network = google_compute_network.default.id
    ip_cidr_range = "10.0.0.0/16"
}

resource "google_compute_network_attachment" "default" {
  name                  = "alloydb-network-attachment"
  region                = "us-central1"
  connection_preference = "ACCEPT_AUTOMATIC"
  subnetworks = [
    google_compute_subnetwork.default.self_link
  ]
}

data "google_project" "project" {}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Java

Se utilizzi Private Service Connect per connetterti all'istanza AlloyDB, includi quanto segue:

config.addDataSourceProperty("alloydbIpType", "PSC");

Per ulteriori informazioni sull'utilizzo dell'endpoint Private Service Connect nei connettori di linguaggio Java, consulta il repository GitHub.

Python (pg8000)

Se utilizzi Private Service Connect per connetterti all'istanza AlloyDB, includi quanto segue:

  def getconn() -> pg8000.dbapi.Connection:
      conn: pg8000.dbapi.Connection = connector.connect(
          inst_uri,
          "pg8000",
          user=user,
          password=password,
          db=db,
          # use ip_type to specify PSC
          ip_type=IPTypes.PSC,
      )
      return conn

Per saperne di più sull'utilizzo dell'endpoint Private Service Connect in Python Language Connectors, consulta il repository GitHub.

Python (asyncpg)

Se utilizzi Private Service Connect per connetterti all'istanza AlloyDB, includi quanto segue:

  async def getconn() -> asyncpg.Connection:
    conn: asyncpg.Connection = await connector.connect(
        inst_uri,
        "asyncpg",
        user=user,
        password=password,
        db=db,
        # use ip_type to specify PSC
        ip_type=IPTypes.PSC,
    )
    return conn

Per saperne di più sull'utilizzo dell'endpoint Private Service Connect in Python Language Connectors, consulta il repository GitHub.

Go (pgx)

Se utilizzi Private Service Connect per connetterti all'istanza AlloyDB, includi quanto segue:

d.Dial(ctx, instURI, alloydbconn.WithPSC())

Per saperne di più sull'utilizzo dell'endpoint Private Service Connect nei connettori del linguaggio Go, consulta il repository GitHub.

Go (database/sql)

Se utilizzi Private Service Connect per connetterti all'istanza AlloyDB, includi quanto segue:

  cleanup, err := pgxv5.RegisterDriver(
    "alloydb",
    alloydbconn.WithDefaultDialOptions(alloydbconn.WithPSC())
)

Per saperne di più sull'utilizzo dell'endpoint Private Service Connect nei connettori del linguaggio Go, consulta il repository GitHub.