在共享 VPC 网络上预配实例

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

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

• 网络
• 创建实例
• 列出实例
• 删除集群

启用 API

启用以下 API，这些 API 用于配置服务连接政策、配置共享 VPC 和创建 Memorystore for Redis Cluster 实例。

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 redis.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 Redis Cluster 实例。通常由您的网络管理员完成。不过，如果您被分配了运行该命令所需的角色，也可以执行此操作。

本快速入门使用 default 网络和 default 子网。

gcloud

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

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

   替换以下内容：

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

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

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

   替换以下内容：

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

创建实例

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

gcloud

gcloud redis clusters create INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--network=projects/HOST_PROJECT_ID/global/networks/default

替换以下内容：

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

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

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

  • redis-shared-core-nano
  • redis-standard-small
  • redis-highmem-medium
  • redis-highmem-xlarge
  注意：我们建议您仅将 redis-shared-core-nano 节点类型用于开发或测试目的。如果您在生产环境中运行 Memorystore for Redis Cluster，建议使用 redis-standard-small、redis-highmem-medium 或 redis-highmem-xlarge 节点类型。如需详细了解这些节点类型，请参阅选择节点类型。

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

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

• HOST_PROJECT_ID 是宿主项目 ID。

描述实例

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

gcloud

gcloud redis clusters describe INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

替换以下内容：

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

删除实例

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

gcloud

gcloud redis clusters delete INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

替换以下内容：

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