使用 Private Service Connect 连接到实例

控制台

1. 在 Google Cloud 控制台中，前往 Private Service Connect 页面。

   前往 Private Service Connect

2. 点击连接政策标签页。

3. 点击 Create connection policy（创建连接政策）。

4. 输入连接政策的名称。

5. 通过执行以下操作指定服务类：

   1. 在 Source service class（来源服务类）字段中，选择 Google 服务。
   2. 从服务类菜单中选择 google-cloud-alloydb，因为 AlloyDB 是连接政策的托管式服务。

6. 在目标端点范围部分中，选择此政策适用的网络和区域。

7. 在政策部分中，从子网菜单中选择一个或多个子网。子网用于为端点分配 IP 地址。

8. 可选：为政策指定连接限制。此限制决定了 AlloyDB 可以为此连接政策创建的端点数量。如果您不指定连接限制，则不受限制。

9. 点击创建政策。

gcloud

如需创建服务连接政策，请使用 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

替换以下内容：

• POLICY_NAME：您的服务连接政策的名称。
• NETWORK：应用此政策的网络。
• PROJECT_ID：VPC 网络项目的 ID 或编号。对于共享 VPC 网络，您必须在宿主项目中部署服务连接政策，因为服务项目不支持这些政策。
• REGION：此政策适用的区域。要自动执行服务连接的每个区域中必须存在相同的政策。
• SERVICE_CLASS：提供方提供的服务类资源标识符。 对于 AlloyDB，服务类为 google-cloud-alloydb。
• SUBNETS：用于为 Private Service Connect 端点分配 IP 地址的一个或多个常规使用方子网。在创建和删除托管式服务实例时，这些 IP 地址会自动分配并返回子网池。子网必须与服务连接政策位于同一区域。如果多个连接政策位于同一区域，则您可以在这些政策中重复使用同一子网。您可以在逗号分隔列表中输入多个子网。
• LIMIT：可以使用此政策创建的端点数上限。如果您不指定限制，则不受限制。
• DESCRIPTION：服务连接政策的可选说明。

• PRODUCER_INSTANCE_LOCATION：指定政策是否自动连接到 AlloyDB 实例。您可以将此值设置为以下任一值：

  • none（默认）：AlloyDB 实例与服务连接政策位于同一项目中（如果是共享 VPC，则位于关联的项目中）。
  • custom-resource-hierarchy-levels：要求您通过 allowed-google-producers-resource-hierarchy-level 参数设置要自动建立连接的项目的 Resource Manager 位置路径。

• LIST_OF_NODES：如果您的生产者实例位置设置为 custom-resource-hierarchy-levels，请设置此参数。此参数是一个项目、文件夹和组织的列表，其中包含您要自动建立连接的实例。此列表采用 projects/PROJECT_ID、folders/FOLDER_ID 或 organizations/ORGANIZATION_ID 格式。

例如，以下命令会为
google-cloud-alloydb 服务类创建服务连接政策，该政策从 managed-services 子网分配 IP 地址。使用此政策，您最多可以创建 10 个 Private Service Connect 端点。您必须在与代管式服务实例位于同一组织的项目中创建端点。 AlloyDB 实例位于 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

控制台

1. 在 Google Cloud 控制台中，前往集群页面。

   转到集群

2. 点击创建集群。

3. 在集群 ID 中，输入 my-cluster。

4. 输入密码。请记下此密码，因为您将在本快速入门中使用它。

5. 保留默认数据库版本。

6. 选择 us-central1 (Iowa) 区域。

7. 保留默认实例 ID my-cluster-primary。

8. 在可用区级可用性部分，保留单个可用区作为所选选项。虽然我们不建议在生产环境中使用单个可用区实例，但您可以在本快速入门中使用单个可用区以尽可能降低成本。如需了解详情，请参阅使用基本实例降低成本。

9. 选择 2 vCPU, 16 GB 机器类型。

10. 保留专用 IP 连接。

    1. 选择 Private Service Connect (PSC)。
    2. 点击添加端点。
    3. 选择要在其中创建端点的项目。
    4. 选择网络。
    5. 点击检查政策，查看服务连接政策信息。

11. 保留网络安全下的默认设置。

12. 请勿在显示高级选项中进行更改。

13. 点击创建集群。AlloyDB 可能需要几分钟的时间来创建集群并将其显示在主集群概览页面上。

gcloud

如需创建集群，请使用 gcloud alloydb clusters create 命令。

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

替换以下内容：

• CLUSTER_ID：您所创建的集群的 ID。它必须以小写字母开头，可以包含小写字母、数字和连字符。

• PASSWORD：要用于默认 postgres 用户的密码。

• REGION_ID：您要将集群放置在其中的区域。

• PROJECT_ID：您要将集群放置在其中的项目的 ID。

此命令会启动一个长时间运行的操作，并返回操作 ID。

如需创建 AlloyDB 实例（主实例或读取池）以便使用 Private Service Connect ，请使用 gcloud alloydb instances create 命令。请务必添加 --allowed-psc-projects 参数，以指定哪些使用方项目可以创建端点来连接到此实例。

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

替换以下内容：

• INSTANCE_ID：您所创建的实例的 ID。必须以小写字母开头，可以包含小写字母、数字和连字符。
• CPU_COUNT：您要为实例分配的 vCPU 数量。有效值包括：
  • 2：2 个 vCPU，16 GB RAM
  • 4：4 个 vCPU，32 GB RAM
  • 8：8 个 vCPU，64 GB RAM
  • 16：16 个 vCPU，128 GB RAM
  • 32：32 个 vCPU，256 GB RAM
  • 64：64 个 vCPU，512 GB RAM
  • 96：96 个 vCPU，768 GB RAM
  • 128：128 个 vCPU，864 GB RAM
• AVAILABILITY：表示相应实例是否应具有高可用性 (HA)，即在多个可用区中具有节点。有效值包括：
  • REGIONAL：创建具有单独的活跃节点和备用节点的高可用性实例，并在这两个节点之间实现自动故障切换。这是默认值，适用于生产环境。
  • ZONAL：创建仅包含一个节点且不支持自动故障切换的基本实例。
• REGION_ID：您要将实例放置在其中的区域。
• CLUSTER_ID：您之前创建的集群的 ID。
• ALLOWED_PROJECT_LIST：您要允许访问实例的项目 ID 或项目编号的英文逗号分隔列表，例如 my-project-1,12345,my-project-n。
• NETWORK_ATTACHMENT_URI（可选）：您为出站连接创建的网络连接 URI 的完整资源名称。例如：projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID。
• CONSUMER_NETWORK：需要在其中创建 Private Service Connect 端点的 VPC 网络的路径。例如：projects/my-host-project/global/networks/default。此选项适用于自动创建端点的情况。确保服务连接政策已创建。您可以在创建实例之前或之后创建政策。
• CONSUMER_PROJECT：在其中创建 Private Service Connect 端点的项目。如果您使用的是共享 VPC 网络，则可以是宿主项目或服务项目。 您在自动连接参数中指定的任何项目都会自动添加到允许的项目中。（可选）对于您要在其中手动创建 Private Service Connect 端点的任何项目，您可以将这些项目添加到允许的项目列表中。

为启用了 Private Service Connect 的主集群创建的次要集群会自动继承 Private Service Connect 配置。如需了解详情，请参阅创建辅助集群。

Terraform

如需在数据库集群中创建实例，请使用 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" {}

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。

控制台

1. 在 Google Cloud 控制台中，前往集群页面。

   转到集群

2. 点击创建集群。

3. 在集群 ID 中，输入 my-cluster。

4. 输入密码。请记下此密码，因为您将在本快速入门中使用它。

5. 保留默认数据库版本。

6. 选择 us-central1 (Iowa) 区域。

7. 保留默认实例 ID my-cluster-primary。

8. 在可用区级可用性部分，保留单个可用区作为所选选项。虽然我们不建议在生产环境中使用单个可用区实例，但您可以在本快速入门中使用单个可用区以尽可能降低成本。如需了解详情，请参阅使用基本实例降低成本。

9. 选择 2 vCPU, 16 GB 机器类型。

10. 保留专用 IP 连接。

    1. 选择 Private Service Connect(PSC)。
    2. 点击添加端点。
    3. 选择要在其中创建端点的项目。
    4. 选择网络。
    5. 点击检查政策，查看服务连接政策信息。

11. 保留网络安全下的默认设置。

12. 请勿在显示高级选项中进行更改。

13. 点击创建集群。AlloyDB 可能需要几分钟的时间来创建集群并将其显示在主集群概览页面上。

gcloud

如需创建集群，请使用 gcloud alloydb clusters create 命令。

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

替换以下内容：

• CLUSTER_ID：您所创建的集群的 ID。它必须以小写字母开头，可以包含小写字母、数字和连字符。

• PASSWORD：要用于默认 postgres 用户的密码。

• REGION_ID：您要将集群放置在其中的区域。

• PROJECT_ID：您要将集群放置在其中的项目的 ID。

此命令会启动一个长时间运行的操作，并返回操作 ID。

如需创建主实例，请使用 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 \

替换以下内容：

• INSTANCE_ID：您所创建的实例的 ID。必须以小写字母开头，可以包含小写字母、数字和连字符。
• CPU_COUNT：您要为实例分配的 vCPU 数量。有效值包括：
  • 2：2 个 vCPU，16 GB RAM
  • 4：4 个 vCPU，32 GB RAM
  • 8：8 个 vCPU，64 GB RAM
  • 16：16 个 vCPU，128 GB RAM
  • 32：32 个 vCPU，256 GB RAM
  • 64：64 个 vCPU，512 GB RAM
  • 96：96 个 vCPU，768 GB RAM
  • 128：128 个 vCPU，864 GB RAM
• AVAILABILITY：表示相应实例是否应具有高可用性 (HA)，即在多个可用区中具有节点。有效值包括：
  • REGIONAL：创建具有单独的活跃节点和备用节点的高可用性实例，并在这两个节点之间实现自动故障切换。这是默认值，适用于生产环境。
  • ZONAL：创建仅包含一个节点且不支持自动故障切换的基本实例。
• REGION_ID：您要将实例放置在其中的区域。
• CLUSTER_ID：您之前创建的集群的 ID。
• ALLOWED_PROJECT_LIST：您要允许访问实例的项目 ID 或项目编号的英文逗号分隔列表，例如 my-project-1,12345,my-project-n。
• NETWORK_ATTACHMENT_URI（可选）：您为出站连接创建的网络连接 URI 的完整资源名称。例如：projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID。
• CONSUMER_NETWORK：需要在其中创建 Private Service Connect 端点的 VPC 网络的路径。例如：projects/my-host-project/global/networks/default。此选项适用于自动创建端点的情况。确保服务连接政策已创建。您可以在创建实例之前或之后创建政策。
• CONSUMER_PROJECT：在其中创建 Private Service Connect 端点的项目。如果您使用的是共享 VPC 网络，则可以是宿主项目或服务项目。 您在自动连接参数中指定的任何项目都会自动添加到允许的项目中。（可选）对于您要在其中手动创建 Private Service Connect 端点的任何项目，您可以将这些项目添加到允许的项目列表中。

为启用了 Private Service Connect 的主集群创建的次要集群会自动继承 Private Service Connect 配置。如需了解详情，请参阅创建辅助集群。

Terraform

如需在数据库集群中创建实例，请使用 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" {}

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。

Java

如果您使用 Private Service Connect 连接到 AlloyDB 实例，请添加以下内容：

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

如需详细了解如何在 Java 语言连接器中使用 Private Service Connect 端点，请参阅 GitHub 代码库。

Python (pg8000)

如果您使用 Private Service Connect 连接到 AlloyDB 实例，请添加以下内容：

  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

如需详细了解如何在 Python 语言连接器中使用 Private Service Connect 端点，请参阅 GitHub 代码库。

Python (asyncpg)

如果您使用 Private Service Connect 连接到 AlloyDB 实例，请添加以下内容：

  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

如需详细了解如何在 Python 语言连接器中使用 Private Service Connect 端点，请参阅 GitHub 代码库。

Go (pgx)

如果您使用 Private Service Connect 连接到 AlloyDB 实例，请添加以下内容：

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

如需详细了解如何在 Go 语言连接器中使用 Private Service Connect 端点，请参阅 GitHub 代码库。

Go (database/sql)

如果您使用 Private Service Connect 连接到 AlloyDB 实例，请添加以下内容：

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

如需详细了解如何在 Go 语言连接器中使用 Private Service Connect 端点，请参阅 GitHub 代码库。