Se connecter à une instance à l'aide de Private Service Connect

Console

1. Dans la console Google Cloud , accédez à la page Private Service Connect.

   Accéder à Private Service Connect

2. Cliquez sur l'onglet Règles de connexion.

3. Cliquez sur Créer une règle de connexion.

4. Saisissez un nom pour la règle de connexion.

5. Spécifiez la classe de service en procédant comme suit :

   1. Dans la case Classe de service source, sélectionnez Services Google.
   2. Dans le menu Classe de service, sélectionnez google-cloud-alloydb, car AlloyDB est le service géré pour la règle de connexion.

6. Dans la section Champ d'application des points de terminaison cibles, sélectionnez un réseau et une région auxquels cette règle s'applique.

7. Dans la section Règle, sélectionnez un ou plusieurs sous-réseaux dans le menu Sous-réseaux. Les sous-réseaux permettent d'allouer des adresses IP aux points de terminaison.

8. Facultatif : spécifiez une limite de connexion pour la règle. Cette limite détermine le nombre de points de terminaison qu'AlloyDB peut créer pour cette règle de connexion. Si vous ne spécifiez pas de limite de connexion, il n'y en aura aucune.

9. Cliquez sur Créer une règle.

gcloud

Pour créer une règle de connexion de service, utilisez la commande 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

Remplacez les éléments suivants :

• POLICY_NAME : nom de votre stratégie de connexion de service.
• NETWORK : réseau auquel s'applique cette règle.
• PROJECT_ID : ID du projet ou numéro du projet du réseau VPC. Pour les réseaux VPC partagés, vous devez déployer des règles de connexion de service dans le projet hôte, car ces règles ne sont pas compatibles avec les projets de service.
• REGION : région à laquelle s'applique cette règle. La même règle doit exister pour chaque région dans laquelle vous souhaitez automatiser la connectivité du service.
• SERVICE_CLASS : identifiant de ressource fourni par le producteur de la classe de service. Pour AlloyDB, la classe de service est google-cloud-alloydb.
• SUBNETS : un ou plusieurs sous-réseaux client standard utilisés pour allouer des adresses IP aux points de terminaison Private Service Connect. Ces adresses IP sont automatiquement allouées et renvoyées au pool de sous-réseaux à mesure que des instances de service géré sont créées et supprimées. Les sous-réseaux doivent se trouver dans la même région que la règle de connexion de service. Si plusieurs règles de connexion partagent la même région, vous pouvez réutiliser le même sous-réseau dans ces règles. Vous pouvez fournir plusieurs sous-réseaux dans une liste séparée par des virgules.
• LIMIT : nombre maximal de points de terminaison pouvant être créés à l'aide de cette règle. Si vous ne spécifiez pas de limite, il n'y en aura aucune.
• DESCRIPTION : description facultative de la règle de connexion de service.

• PRODUCER_INSTANCE_LOCATION : indique si la règle automatise les connexions aux instances AlloyDB. Vous pouvez définir cette valeur sur l'une des options suivantes :

  • none (par défaut) : l'instance AlloyDB se trouve dans le même projet que la règle de connexion de service (ou dans les projets connectés en cas de VPC partagé).
  • custom-resource-hierarchy-levels : vous devez définir le chemin d'accès à l'emplacement Resource Manager pour les projets pour lesquels vous souhaitez automatiser la connectivité à l'aide du paramètre allowed-google-producers-resource-hierarchy-level.

• LIST_OF_NODES : définissez ce paramètre si l'emplacement de votre instance de producteur est défini sur custom-resource-hierarchy-levels. Ce paramètre est une liste de projets, de dossiers et d'organisations dans lesquels résident les instances pour lesquelles vous souhaitez automatiser la connectivité. La liste se présente sous la forme projects/PROJECT_ID, folders/FOLDER_ID ou organizations/ORGANIZATION_ID.

Par exemple, la commande suivante crée une règle de connexion de service pour la classe de service
google-cloud-alloydb qui alloue des adresses IP provenant du sous-réseau managed-services. Vous pouvez créer jusqu'à 10 points de terminaison Private Service Connect avec cette règle. Les points de terminaison doivent être créés dans des projets appartenant à la même organisation que l'instance de service géré. L'instance AlloyDB se trouve dans le projet 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. Dans la console Google Cloud , accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur Créer un cluster.

3. Dans le champ ID du cluster, saisissez my-cluster.

4. Saisissez un mot de passe. Notez ce mot de passe, car vous l'utiliserez dans ce guide de démarrage rapide.

5. Conservez la version de base de données par défaut.

6. Sélectionnez la région us-central1 (Iowa).

7. Conservez l'ID d'instance par défaut, my-cluster-primary.

8. Dans Disponibilité zonale, conservez l'option Zone unique. Bien que nous ne recommandions pas d'utiliser une instance à zone unique pour la production, vous allez utiliser une zone unique dans ce guide de démarrage rapide pour minimiser les coûts. Pour en savoir plus, consultez Réduire les coûts en utilisant des instances de base.

9. Sélectionnez le type de machine 2 vCPU, 16 GB.

10. Conservez la connectivité IP privée.

    1. Sélectionnez Private Service Connect (PSC).
    2. Cliquez sur Ajouter un point de terminaison.
    3. Sélectionnez le projet dans lequel vous souhaitez créer le point de terminaison.
    4. Sélectionnez le réseau.
    5. Cliquez sur Vérifier la règle pour obtenir des informations sur la règle de connexion de service.

11. Conservez les paramètres par défaut sous Sécurité du réseau.

12. Ne modifiez pas les options dans Afficher les options avancées.

13. Cliquez sur Créer un cluster. AlloyDB peut mettre plusieurs minutes à créer le cluster et à l'afficher sur la page Présentation du cluster principal.

gcloud

Pour créer le cluster, utilisez la commande gcloud alloydb clusters create.

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

Remplacez les éléments suivants :

• CLUSTER_ID : ID du cluster que vous créez. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.

• PASSWORD : mot de passe à utiliser pour l'utilisateur postgres par défaut.

• REGION_ID : région dans laquelle vous souhaitez placer le cluster.

• PROJECT_ID : ID du projet dans lequel vous souhaitez placer le cluster.

Cette commande lance une opération de longue durée et renvoie un ID d'opération.

Pour créer l'instance AlloyDB, qu'il s'agisse d'une instance principale ou d'un pool de lecture pour utiliser Private Service Connect, exécutez la commande gcloud alloydb instances create. Assurez-vous d'inclure le paramètre --allowed-psc-projects pour spécifier les projets clients pouvant créer des points de terminaison pour se connecter à cette instance.

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

Remplacez les éléments suivants :

• INSTANCE_ID : ID de l'instance que vous créez. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
• CPU_COUNT : nombre de processeurs virtuels souhaité pour l'instance. Les valeurs valides sont les suivantes :
  • 2 : 2 vCPU, 16 Go de RAM
  • 4 : 4 vCPU, 32 Go de RAM
  • 8 : 8 processeurs virtuels, 64 Go de RAM
  • 16 : 16 vCPU, 128 Go de RAM
  • 32 : 32 processeurs virtuels, 256 Go de RAM
  • 64 : 64 vCPU, 512 Go de RAM
  • 96 : 96 processeurs virtuels, 768 Go de RAM
  • 128 : 128 vCPU, 864 Go de RAM
• AVAILABILITY : indique si cette instance doit être à haute disponibilité (HA), avec des nœuds dans plusieurs zones. Les valeurs valides sont les suivantes :
  • REGIONAL : crée une instance HA avec des nœuds actifs et de secours distincts, et un basculement automatique entre eux. Il s'agit de la valeur par défaut, qui convient aux environnements de production.
  • ZONAL : crée une instance de base, contenant un seul nœud et aucune reprise après sinistre automatisée.
• REGION_ID : région dans laquelle vous souhaitez placer l'instance.
• CLUSTER_ID : ID du cluster que vous avez créé précédemment.
• ALLOWED_PROJECT_LIST : liste des ID ou numéros de projet séparés par une virgule pour lesquels vous souhaitez autoriser l'accès à l'instance (par exemple, my-project-1, 12345,my-project-n).
• NETWORK_ATTACHMENT_URI (facultatif) : nom complet de la ressource de l'URI de rattachement de réseau que vous créez pour la connectivité sortante. Par exemple : projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• CONSUMER_NETWORK : chemin d'accès au réseau VPC dans lequel les points de terminaison Private Service Connect doivent être créés. Exemple : projects/my-host-project/global/networks/default. Cette option s'applique lorsque vous créez des points de terminaison automatiquement. Assurez-vous que la règle de connexion de service est créée. Vous pouvez créer la règle avant ou après la création de l'instance.
• CONSUMER_PROJECT : projet dans lequel le point de terminaison Private Service Connect est créé. Si vous utilisez un réseau VPC partagé, il peut s'agir du projet hôte ou du projet de service. Tous les projets que vous spécifiez dans les paramètres de connexion automatique sont automatiquement ajoutés à vos projets autorisés. Si vous le souhaitez, vous pouvez ajouter à votre liste de projets autorisés les projets pour lesquels vous souhaitez créer manuellement des points de terminaison Private Service Connect.

Un cluster secondaire créé pour un cluster principal compatible avec Private Service Connect hérite automatiquement de la configuration Private Service Connect. Pour en savoir plus, consultez Créer un cluster secondaire.

Terraform

Pour créer une instance dans votre cluster de bases de données, utilisez une ressource 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" {}

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

Console

1. Dans la console Google Cloud , accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur Créer un cluster.

3. Dans le champ ID du cluster, saisissez my-cluster.

4. Saisissez un mot de passe. Notez ce mot de passe, car vous l'utiliserez dans ce guide de démarrage rapide.

5. Conservez la version de base de données par défaut.

6. Sélectionnez la région us-central1 (Iowa).

7. Conservez l'ID d'instance par défaut, my-cluster-primary.

8. Dans Disponibilité zonale, conservez l'option Zone unique. Bien que nous ne recommandions pas d'utiliser une instance à zone unique pour la production, vous allez utiliser une zone unique dans ce guide de démarrage rapide pour minimiser les coûts. Pour en savoir plus, consultez Réduire les coûts en utilisant des instances de base.

9. Sélectionnez le type de machine 2 vCPU, 16 GB.

10. Conservez la connectivité IP privée.

    1. Sélectionnez Private Service Connect(PSC).
    2. Cliquez sur Ajouter un point de terminaison.
    3. Sélectionnez le projet dans lequel vous souhaitez créer le point de terminaison.
    4. Sélectionnez le réseau.
    5. Cliquez sur Vérifier la règle pour obtenir des informations sur la règle de connexion de service.

11. Conservez les paramètres par défaut sous Sécurité du réseau.

12. Ne modifiez pas les options dans Afficher les options avancées.

13. Cliquez sur Créer un cluster. AlloyDB peut mettre plusieurs minutes à créer le cluster et à l'afficher sur la page Présentation du cluster principal.

gcloud

Pour créer le cluster, utilisez la commande gcloud alloydb clusters create.

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

Remplacez les éléments suivants :

• CLUSTER_ID : ID du cluster que vous créez. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.

• PASSWORD : mot de passe à utiliser pour l'utilisateur postgres par défaut.

• REGION_ID : région dans laquelle vous souhaitez placer le cluster.

• PROJECT_ID : ID du projet dans lequel vous souhaitez placer le cluster.

Cette commande lance une opération de longue durée et renvoie un ID d'opération.

Pour créer l'instance principale, utilisez la commande 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 \

Remplacez les éléments suivants :

• INSTANCE_ID : ID de l'instance que vous créez. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
• CPU_COUNT : nombre de processeurs virtuels souhaité pour l'instance. Les valeurs valides sont les suivantes :
  • 2 : 2 vCPU, 16 Go de RAM
  • 4 : 4 vCPU, 32 Go de RAM
  • 8 : 8 processeurs virtuels, 64 Go de RAM
  • 16 : 16 vCPU, 128 Go de RAM
  • 32 : 32 processeurs virtuels, 256 Go de RAM
  • 64 : 64 vCPU, 512 Go de RAM
  • 96 : 96 processeurs virtuels, 768 Go de RAM
  • 128 : 128 vCPU, 864 Go de RAM
• AVAILABILITY : indique si cette instance doit être à haute disponibilité (HA), avec des nœuds dans plusieurs zones. Les valeurs valides sont les suivantes :
  • REGIONAL : crée une instance HA avec des nœuds actifs et de secours distincts, et un basculement automatique entre eux. Il s'agit de la valeur par défaut, qui convient aux environnements de production.
  • ZONAL : crée une instance de base, contenant un seul nœud et aucune reprise après sinistre automatisée.
• REGION_ID : région dans laquelle vous souhaitez placer l'instance.
• CLUSTER_ID : ID du cluster que vous avez créé précédemment.
• ALLOWED_PROJECT_LIST : liste des ID ou numéros de projet séparés par une virgule pour lesquels vous souhaitez autoriser l'accès à l'instance (par exemple, my-project-1, 12345,my-project-n).
• NETWORK_ATTACHMENT_URI (facultatif) : nom complet de la ressource de l'URI de rattachement de réseau que vous créez pour la connectivité sortante. Par exemple : projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• CONSUMER_NETWORK : chemin d'accès au réseau VPC à partir duquel les points de terminaison Private Service Connect doivent être créés. Exemple : projects/my-host-project/global/networks/default. Cette option s'applique lorsque vous créez des points de terminaison automatiquement. Assurez-vous que la règle de connexion de service est créée. Vous pouvez créer la règle avant ou après la création de l'instance.
• CONSUMER_PROJECT : projet dans lequel le point de terminaison Private Service Connect est créé. Si vous utilisez un réseau VPC partagé, il peut s'agir du projet hôte ou du projet de service. Tous les projets que vous spécifiez dans les paramètres de connexion automatique sont automatiquement ajoutés à vos projets autorisés. Si vous le souhaitez, vous pouvez ajouter à votre liste de projets autorisés les projets pour lesquels vous souhaitez créer manuellement des points de terminaison Private Service Connect.

Un cluster secondaire créé pour un cluster principal compatible avec Private Service Connect hérite automatiquement de la configuration Private Service Connect. Pour en savoir plus, consultez Créer un cluster secondaire.

Terraform

Pour créer une instance dans votre cluster de bases de données, utilisez une ressource 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" {}

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

Java

Si vous utilisez Private Service Connect pour vous connecter à votre instance AlloyDB, incluez les éléments suivants :

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

Pour en savoir plus sur l'utilisation du point de terminaison Private Service Connect dans les connecteurs de langage Java, consultez le dépôt GitHub.

Python (pg8000)

Si vous utilisez Private Service Connect pour vous connecter à votre instance AlloyDB, incluez les éléments suivants :

  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

Pour en savoir plus sur l'utilisation du point de terminaison Private Service Connect dans les connecteurs de langage Python, consultez le dépôt GitHub.

Python (asyncpg)

Si vous utilisez Private Service Connect pour vous connecter à votre instance AlloyDB, incluez les éléments suivants :

  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

Pour en savoir plus sur l'utilisation du point de terminaison Private Service Connect dans les connecteurs de langage Python, consultez le dépôt GitHub.

Go (pgx)

Si vous utilisez Private Service Connect pour vous connecter à votre instance AlloyDB, incluez les éléments suivants :

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

Pour en savoir plus sur l'utilisation du point de terminaison Private Service Connect dans les connecteurs de langage Go, consultez le dépôt GitHub.

Go (database/sql)

Si vous utilisez Private Service Connect pour vous connecter à votre instance AlloyDB, incluez les éléments suivants :

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

Pour en savoir plus sur l'utilisation du point de terminaison Private Service Connect dans les connecteurs de langage Go, consultez le dépôt GitHub.