建立執行個體

本頁說明如何建立 Memorystore for Valkey 執行個體。

事前準備

完成「事前準備」說明：

  1. 在 Google Cloud 控制台的專案選取器頁面中，選取或建立 Google Cloud 專案。

    注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。這樣在完成這些步驟之後，您就可以刪除專案，並移除與該專案相關聯的所有資源。


    前往專案選取器
  2. 請確認您已為專案啟用計費功能。瞭解如何檢查專案是否已啟用計費功能。

  3. 安裝並初始化 Google Cloud CLI。

    注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。您必須使用至少 489.0.0 版的 gcloud CLI，才能存取 Memorystore for Valkey gcloud CLI 指令。

  4. 啟用 Memorystore for Valkey API
    Memorystore for Valkey
  5. 啟用 Network Connectivity API
    Network Connectivity API
  6. 啟用 Service Consumer Management API
    Service Consumer Management API

其他事前準備

  • 您必須在使用的 Google Cloud 專案中具備下列其中一個 IAM 角色：
    • roles/memorystore.admin (Memorystore 管理員預先定義的 IAM 角色)
    • roles/owner (擁有者基本 IAM 角色)
    • roles/editor (編輯者基本 IAM 角色)

設定網路

請參閱「網路」頁面，判斷是否需要設定服務連線政策。

如果尚未為要建立 Valkey 執行個體的網路建立服務連線政策，請按照「網路」指南建立政策。

建立執行個體

控制台

  1. 前往 Google Cloud 控制台的「Memorystore for Valkey」頁面。

    Memorystore for Valkey

  2. 點選「建立執行個體」。

  3. 在「Create a Valkey instance」(建立 Valkey 執行個體) 頁面上，針對新執行個體選取所需設定。

    • 在「為執行個體命名」下方輸入執行個體 ID。執行個體 ID 只能使用小寫英文字母、數字和連字號。開頭必須是英文字母，而且在所屬區域中不得重複。
      • 例如 my-instance-1。
    • 在「選擇區域」下方，選取執行個體的區域。

    • 在「節點類型」部分，選取下列其中一種節點類型：

      • 共用核心 (shared-core-nano)
      • 小 (standard-small)
      • 中 (highmem-medium)
      • 超大 (highmem-xlarge)

    • 在「模式」下方，選取「已啟用叢集模式」或「已停用叢集模式」。

    • 在「執行個體大小」下方，定義執行個體的 shard 數量。資料分割數量會決定儲存執行個體資料的記憶體總容量。已停用叢集模式的執行個體只支援一個 shard，詳情請參閱「執行個體和分片規格」。

    • 如要建立含有副本的執行個體，請在「副本」下方輸入所需的副本數量 (每個分片)。可接受的值為「沒有副本」、「1 個副本」和「2 個副本」。使用 Google Cloud 控制台時，預設值為 1 個副本。

    • 在「設定連線」下方選取所需網路。如要進一步瞭解 Memorystore for Valkey 的私有網路，請參閱「網路」。

    • 如要啟用 IAM 驗證，請選取「啟用 IAM 驗證」。

    • 如要啟用傳輸中加密，請選取「啟用傳輸層安全標準 (TLS)」。

    • 在「選擇版本」下方，選取 Valkey 版本。預設版本為 Valkey 7.2。

  4. 按一下 [Create Instance] (建立執行個體) 按鈕。

gcloud

如要建立 Memorystore for Valkey 執行個體，請執行 create 指令：

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--mode=MODE

更改下列內容：

  • INSTANCE 是要建立的 Memorystore for Valkey 執行個體 ID。執行個體 ID 長度必須介於 1 至 63 個字元之間，而且只能使用小寫英文字母、數字或連字號。但開頭必須是小寫英文字母，結尾則須為小寫英文字母或數字。

  • REGION_ID 是您希望執行個體所在的地區。

  • PROJECT_ID 是您要建立執行個體的專案 ID。

  • NETWORK_ID 是您要用於建立執行個體的網路 ID。

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

  • NODE_TYPE 是您選擇的節點類型。可接受的值如下：

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

  • ENGINE_VERSION 是您選擇的 Valkey 引擎版本。可接受的值為 VALKEY_7_2 和 VALKEY_8_0。

  • SHARD_COUNT 決定執行個體中的 shard 數量。資料分割數量會決定儲存執行個體資料的記憶體總容量。已停用叢集模式的執行個體只支援一個 shard，詳情請參閱「執行個體和節點規格」。

  • MODE 判斷執行個體是否已啟用叢集模式。如果省略這個欄位，執行個體預設會啟用叢集模式。詳情請參閱「啟用及停用叢集模式」。

例如：

已啟用叢集模式範例


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--mode=cluster

已停用叢集模式的範例


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--mode=cluster-disabled

預設會停用傳輸中加密，授權網路為 default。

建立單一可用區執行個體

本節說明如何建立單一區域執行個體。

gcloud

如要建立單一區域執行個體，請執行 create 指令：

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--mode=MODE

更改下列內容：

  • INSTANCE 是您要建立的 Memorystore for Valkey 執行個體 ID。執行個體 ID 的長度須介於 1 至 63 個字元之間，而且只能使用小寫英文字母、數字或連字號。但開頭必須是小寫英文字母，結尾則須為小寫英文字母或數字。

  • REGION_ID 是您希望執行個體所在的地區。

  • PROJECT_ID 是您要建立執行個體的專案 ID。

  • NETWORK_ID 是您要用於建立執行個體的網路 ID。

  • REPLICA_COUNT 是您選擇的副本數量 (每個分片)。可接受的值為 0、1 和 2。

  • NODE_TYPE 是您選擇的節點類型。可接受的值如下：

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

  • ENGINE_VERSION 是您選擇的 Valkey 引擎版本。可接受的值為 VALKEY_7_2 和 VALKEY_8_0。

  • SHARD_COUNT 決定執行個體中的 shard 數量。資料分割數量會決定儲存執行個體資料的總記憶體容量。如果選取的模式為「已停用叢集模式」，則執行個體只能指定一個 shard。詳情請參閱「執行個體和節點規格」。

  • MODE 決定執行個體應啟用或停用叢集模式。如果省略這個欄位，模式預設為「已啟用叢集模式」。詳情請參閱「啟用及停用叢集模式」。

  • ZONE_DISTRIBUTION_CONFIG_MODE 模式可供您選擇要佈建單一可用區執行個體或多可用區執行個體。預設為多區域。可接受的值為 single-zone 和 multi-zone。

  • ZONE 是您要佈建節點的區域。只有在 --zone-distribution-config-mode= 設為 single-zone 時，這個旗標才適用。