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

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

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

啟用 API

啟用下列 API，以便設定服務連線政策、設定共用 VPC，以及建立 Memorystore for Valkey 執行個體。

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。

建立服務連線政策

接著，您必須為共用虛擬私有雲的主專案建立服務連線政策，並定義政策、網路、區域和子網路，以便佈建 Memorystore for Valkey 執行個體。通常是由網路管理員執行，如果您具有必要角色，可能也有權限執行指令。

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

建立執行個體

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

gcloud

gcloud memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"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 會決定執行個體中的 shard 數量。分片數量會決定儲存執行個體資料的總記憶體容量。如要進一步瞭解執行個體規格，請參閱「執行個體和節點規格」。

  • REPLICA_COUNT 是所需的唯讀備用資源數量 (每個分片)。可接受的值為 0、1 和 2。

  • HOST_PROJECT_ID 是主專案 ID。

描述執行個體

如要查看執行個體詳細資料，請執行下列指令：

gcloud

gcloud memorystore instances describe INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

更改下列內容：

  • INSTANCE 是執行個體 ID。
  • SERVICE_PROJECT_ID 是服務專案 ID。
  • REGION 是執行個體所在的區域。

刪除執行個體

如要刪除執行個體，請執行下列指令：

gcloud

gcloud memorystore instances delete INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

更改下列內容：

  • INSTANCE 是執行個體 ID。
  • SERVICE_PROJECT_ID 是服務專案 ID。
  • REGION 是執行個體所在的區域。