在 AlloyDB 集群中创建读取池实例

本页面介绍了如何在 AlloyDB for PostgreSQL 集群中创建读取池实例。

准备工作

  • 您使用的 Google Cloud 项目必须已启用才能访问 AlloyDB。
  • 您必须在所使用的 Google Cloud 项目中拥有以下 IAM 角色之一：
    • roles/alloydb.admin（AlloyDB Admin 预定义 IAM 角色）
    • roles/owner（Owner 基本 IAM 角色）
    • roles/editor（Editor 基本 IAM 角色）

    如果您不拥有上述任何角色，请与组织管理员联系以申请访问权限。

创建读取池实例

控制台

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

    转到集群

  2. 在资源名称列中点击相应集群。

  3. 转到集群中的实例部分，然后点击添加读取池。

  4. 配置读取池实例：

    1. 在读取池实例 ID 字段中，输入读取池实例的 ID。

    2. 在节点数字段中，输入节点数。

      读取池实例中的节点数决定了实例的总计算容量。

    3. 选择以下机器系列之一：

      • C4A（基于 Google Axion 的机器系列）
      • N2（基于 x86 的机器系列）。这是默认的机器系列。

    4. 选择机器类型。

      • C4A 支持 1、4、8、16、32、48、64 和 72 种机器类型或形式。
      • N2 支持 2、4、8、16、32、64、96 和 128 种机器类型或形式。

      如需详细了解如何使用基于 C4A Axion 的机器系列（包括 1 个 vCPU 机器类型），请参阅使用基于 C4A Axion 的机器系列时的注意事项。

      1. 可选：如需通过公共互联网连接您的应用和客户端，请在公共 IP 连接中点击启用公共 IP。启用公共 IP 可能需要进行额外配置，以确保连接安全。如需了解详情，请参阅使用公共 IP 进行连接。

      默认情况下，专用 IP 始终处于启用状态。如需了解详情，请参阅启用专用服务访问通道。

      1. 可选：如需启用和使用托管式连接池，请勾选托管式连接池下的启用托管式连接池复选框。如需了解详情，请参阅配置托管式连接池。

      2. 选择您的网络安全设置。为确保您的数据安全，我们建议您通过 AlloyDB 连接器使用 mTLS 加密，或使用 SSL 加密。

      更改安全设置时，您的实例仍可用，但现有的不合规连接将舍弃。

    5. 可选：为实例设置自定义标志。对于每个标志，请按照以下步骤操作：

      1. 点击高级配置选项。
      2. 点击添加数据库标志。
      3. 从新增数据库标志列表中选择一个标志。
      4. 为标志提供值。
      5. 点击完成。

  5. 点击添加读取池。

gcloud

如需使用 gcloud CLI，您可以安装并初始化 Google Cloud CLI，也可以使用 Cloud Shell。

使用 gcloud alloydb instances create 命令创建读取池实例。

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --read-pool-node-count=NODE_COUNT \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID

替换以下内容：

  • INSTANCE_ID：您要创建的实例的 ID。必须以小写字母开头，可以包含小写字母、数字和连字符。

  • NODE_COUNT：实例中的节点数。 指定 1 到 20（含）之间的数字。请注意，集群中所有读取池实例的节点数不能超过 20 个。

  • REGION_ID：您希望实例所在的区域。

  • CLUSTER_ID：您希望放置实例的集群的 ID。

  • CPU_COUNT：您希望实例拥有的 vCPU 数量。

    • 您必须指定 cpu_count 或 machine_type。
    • 如果仅提供 cpu_count，则会创建具有以下规范的 N2 实例：
      • 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
    • 如果同时提供了 machine_type 和 cpu_count，则 cpu_count 值必须与 machine_type 中指定的 vCPU 数量保持一致。例如，如果 machine_type 为 n2-highmem-4，则必须将 cpu_count 设置为 4。

  • MACHINE_TYPE：实例的机器类型。

    • 对于基于 C4A Axion 的机器系列，以下是有效值：

      • c4a-highmem-1
      • c4a-highmem-4-lssd
      • c4a-highmem-8-lssd
      • c4a-highmem-16-lssd
      • c4a-highmem-32-lssd
      • c4a-highmem-48-lssd
      • c4a-highmem-64-lssd
      • c4a-highmem-72-lssd

    • 对于 N2 机器系列，以下是有效值：

      • n2-highmem-2
      • n2-highmem-4
      • n2-highmem-8
      • n2-highmem-16
      • n2-highmem-32
      • n2-highmem-64
      • n2-highmem-96
      • n2-highmem-128

    • 将 machine_type 和 cpu_count 结合使用时，cpu_count 和 machine_type 中的值必须匹配。例如，如果 machine_type 为 n2-highmem-4，则必须将 cpu_count 设置为 4。

  • PROJECT_ID：集群所在项目的 ID。

如需为已启用 Private Service Connect 的集群创建读取池实例，请添加 --allowed-psc-projects 标志以设置要允许访问该实例的项目 ID 或 [项目编号](/resource-manager/docs/creating-managing-projects#identifying_projects) 的英文逗号分隔列表，例如“my-project-1, 12345,my-project-n”。

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --allowed-psc-projects=ALLOWED_PROJECT_LIST

替换以下内容：

  • ALLOWED_PROJECT（可选）：您要允许访问实例的项目 ID 或项目编号的英文逗号分隔列表，例如“my-project-1, 12345,my-project-n”。如果您的集群使用 Private Service Connect 作为连接到实例的方法，您必须设置允许的项目或编号列表。

如需在读取池实例中启用托管式连接池，请将 --enable-connection-pooling 标志添加到 gcloud alloydb instances create 命令中：

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --enable-connection-pooling

如需为启用了公共 IP 的集群创建读取池实例，请添加 --assign-inbound-public-ip=ASSIGN_IPV4 参数。

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --assign-inbound-public-ip=ASSIGN_IPV4

（可选）您可以将 CIDR 地址块的英文逗号分隔列表（例如 64.233.160.0/16）传递给 --authorized-external-networks 参数，以在实例上设置已获授权的外部网络。

后续步骤