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

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

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

• 網路
• 建立執行個體
• 列出執行個體
• 刪除叢集

啟用 API

啟用下列 API，以便設定服務連結政策、設定 Shared 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 Cluster 執行個體的 Shared VPC 虛擬私有雲網路、區域和子網路主專案，建立服務連線政策。通常是由網路管理員執行。不過，如果您已獲派必要角色，也可以執行這項指令。

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

建立執行個體

如要在附加至 Shared 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 節點類型用於開發或測試，因為這個節點類型沒有服務水準協議。如果您在正式環境中執行 Memorystore for Redis Cluster，建議使用其他節點類型。

• SHARD_COUNT 會決定執行個體中的 shard 數量。分片數量會決定儲存叢集資料的總記憶體容量。如要進一步瞭解叢集規格，請參閱「叢集和節點規格」。

• REPLICA_COUNT 是讀取備用資源的數量 (每個分片)。可接受的值為 0-5。

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