在共用虛擬私有雲網路上佈建執行個體

本頁列出設定必要條件、在服務專案中佈建執行個體、說明執行個體，以及刪除執行個體時所需的 gcloud CLI 指令。如要完成這些工作，請按照本頁面各節的指示操作。

如需這些工作的詳細指引，請參閱下列頁面：

啟用 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。

建立服務連線政策

接著，為共用虛擬私有雲網路、區域和子網路的主專案建立服務連線政策，您要在這些位置佈建 Memorystore for Redis 叢集執行個體。通常是由網路管理員完成。不過，如果您獲派必要角色，也可以執行這項指令。

本快速入門導覽課程會使用 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 是定義服務連線政策的地區。

建立執行個體

如要在附加至共用虛擬私有雲網路的服務專案中建立執行個體，請執行下列指令：

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 決定執行個體中的 shard 數量。資料分割數量會決定儲存叢集資料的總記憶體容量。如要進一步瞭解叢集規格，請參閱叢集和節點規格。

  • 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 是執行個體所在的區域。