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

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

如需這些工作更詳細的操作說明，請參閱下列頁面：

啟用 API

啟用下列 API，用於設定服務連線政策、設定共用虛擬私有雲，以及為 Valkey 例項建立 Memorystore。

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。

建立服務連線政策

接下來，您必須為共用虛擬私有雲的主機專案建立服務連線政策，其中定義了政策、網路、區域，以及要為 Valkey 例項提供 Memorystore 的子網路。這項操作通常由網路管理員執行，如果您具備必要角色，可能就具備執行指令的必要權限。

本快速入門導覽課程會使用 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={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 會決定執行個體中的分割區數量。分片數量會決定儲存例項資料的總記憶體容量。如要進一步瞭解執行個體規格，請參閱「執行個體和節點規格」。

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