在共享 VPC 网络上预配实例

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

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

启用 API

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

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 的宿主项目（其中定义了政策）、网络、区域以及您要为 Valkey 实例预配 Memorystore 的子网创建服务连接政策。通常，这由您的广告资源网管理员执行，或者如果您拥有必需的角色，则可能拥有运行该命令的必要权限。

本快速入门使用 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=SERVICE_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 是实例所在的区域。