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

本頁列出設定必要條件、在服務專案中佈建執行個體、說明執行個體,以及刪除執行個體所需的 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 是所需的唯讀備用資源數量 (每個分片)。可接受的值為 012

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