在 VPC 网络上预配实例

本页面列出了在标准 VPC 网络上设置前提条件、预配实例、描述实例和删除实例所需的 gcloud CLI 命令。如需了解如何在共享 VPC 网络上执行这些任务，请参阅在共享 VPC 网络上预配实例。为了完成这些任务，您应按照本页面各部分中的说明操作。

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

启用 API

首先，请启用本部分中的 API。由于 Memorystore for Valkey 使用 Private Service Connect 服务连接自动化功能来自动连接实例，因此需要这些 API。如需了解详情，请参阅网络。

如需启用 API，请运行以下命令：

gcloud

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

替换以下内容：

  • PROJECT_ID 是项目 ID。

创建服务连接政策

您必须为要预配 Memorystore for Valkey 实例的项目、网络和区域创建服务连接政策。服务连接政策可让您授权 gcp-memorystore 服务类在定义该政策的区域和该政策指定的子网中，在提供方 VPC 网络和使用方 VPC 网络之间创建 Private Service Connect 连接。

如需查看创建服务关联政策所需的权限，请参阅所需的角色。

本快速入门使用 default 网络和 default 子网。系统会在该区域的此默认子网中为您的实例分配 IP 地址。

如需创建服务连接政策，请运行以下命令：

gcloud

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

替换以下内容：

  • POLICY_NAME 是您要使用的政策名称。
  • PROJECT_ID 是项目 ID。
  • REGION 是您要预配 Memorystore for Valkey 实例的区域。

验证服务连接政策的创建

运行 list 命令，验证政策是否已成功创建：

gcloud

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

替换以下内容：

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

创建实例

如需创建实例，请运行 create 命令：

gcloud

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

替换以下内容：

  • INSTANCE 是实例 ID。

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

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

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

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

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

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

  • PROJECT_ID 是您要在其中创建实例的项目的 ID。

  • NETWORK_ID 是您要用于创建实例的网络的 ID。

描述实例

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

gcloud

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

替换以下内容：

  • INSTANCE 是实例 ID。
  • PROJECT_ID 是项目 ID。
  • REGION 是实例所在的区域。

删除实例

如需删除实例，请运行 delete 命令：

gcloud

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

替换以下内容：

  • INSTANCE 是实例 ID。
  • PROJECT_ID 是项目 ID。
  • REGION 是实例所在的区域。