在共享 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

  • 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 是实例所在的区域。