在共享 VPC 网络上预配实例

本页列出了设置前提条件、在服务项目中预配实例、描述实例和删除实例所需的 gcloud CLI 命令。为了完成这些任务，您应该遵循 请参阅本页各部分中的说明。

如需关于这些任务的更详细指南，请参阅以下页面：

启用 API

启用配置服务连接所需的以下 API 政策、配置共享 VPC、 并创建 Memorystore for Valkey 实例

gcloud

  1. 在服务项目中启用以下 API：

    gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID memorystore.googleapis.com

    将 SERVICE_PROJECT_ID 替换为您的服务项目 ID。

  2. 在宿主项目中启用以下 API：

    gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com

    将 HOST_PROJECT_ID 替换为宿主项目的 ID。

创建服务连接政策

接下来是服务连接政策 必须为政策所在的共享 VPC 的宿主项目创建 定义、网络、区域以及您要预配的子网 Memorystore for Valkey 实例通常，这由您的广告资源网管理员执行，或者如果您拥有必需的角色，则可能拥有运行该命令的必要权限。

本快速入门使用 default 网络和 default 子网。IP 地址 会分配到该区域中的这个默认子网上。

gcloud

  1. 如需创建服务连接政策，请运行 create 命令：

    gcloud network-connectivity service-connection-policies create POLICY_NAME \
  --network=default \
  --project=HOST_PROJECT_ID \
  --region=REGION \
  --service-class=gcp-memorystore \
  --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default

    替换以下内容：

    • POLICY_NAME 是您所需的政策名称。
    • HOST_PROJECT_ID 是宿主项目 ID。
    • REGION 是您要预配 Memorystore for Valkey 实例的区域。

  2. 如需验证政策是否已成功创建，请运行 list 命令：

    gcloud network-connectivity service-connection-policies list \
  --region=REGION \
  --project=HOST_PROJECT_ID

    替换以下内容：

    • HOST_PROJECT_ID 是宿主项目 ID。
    • REGION 是定义服务连接政策的区域。

创建实例

如需在连接到共享 VPC 的服务项目中创建实例，请运行以下命令：

gcloud

gcloud beta memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--psc-auto-connections=network=projects/HOST_PROJECT_ID/global/networks/default,projectId=HOST_PROJECT_ID

替换以下内容：

  • INSTANCE 是实例 ID。
  • SERVICE_PROJECT_ID 是服务项目 ID。

  • REGION 是您要预配实例的区域。

  • NODE_TYPE 是您选择的节点类型。接受的值包括：

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    如需详细了解节点类型和实例配置，请参阅实例和节点规范。

  • SHARD_COUNT 决定了 实例。分片数决定了存储的总内存容量 实例数据。如需详细了解实例规范，请参阅实例和节点规范。

  • REPLICA_COUNT 是您所需的读取副本数量（每个分片）。 接受的值包括 0、1 和 2。

  • HOST_PROJECT_ID 是宿主项目 ID。

描述实例

如需查看实例详情，请运行以下命令：

gcloud

gcloud beta memorystore instances describe INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

替换以下内容：

  • INSTANCE 是实例 ID。
  • SERVICE_PROJECT_ID 是服务项目 ID。
  • REGION 是实例所在的区域。

删除实例

要删除实例，请运行以下命令：

gcloud

gcloud beta memorystore instances delete INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

替换以下内容：

  • INSTANCE 是实例 ID。
  • SERVICE_PROJECT_ID 是服务项目 ID。
  • REGION 是实例所在的区域。