建立執行個體

本頁面提供建立 Memorystore for Valkey 執行個體的操作說明。

事前準備

請先完成以下操作說明:

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

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


    前往專案選取器
  2. 請確認您已為專案啟用計費功能。瞭解如何檢查專案是否已啟用計費功能
  3. 安裝初始化 Google Cloud CLI。

    注意:如果您先前已安裝 gcloud CLI,請執行 gcloud components update,確認您使用的是最新版本。您必須使用至少 gcloud CLI 版本 489.0.0,才能存取 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 執行個體)頁面上,針對新執行個體選取所需設定。

    • 在「Instance name」(執行個體名稱) 下方輸入執行個體 ID。執行個體 ID 只能使用小寫英文字母、數字和連字號。開頭也必須是英文字母,且在其區域中不得重複。
      • 例如 my-instance-1
    • 在「選擇地區」下方,選取執行個體的地區。
    • 在「Node Type」(節點類型) 下方,選取「node type」(節點類型)
    • 在「模式」下方,選擇「啟用叢集模式」或「停用叢集模式」
    • 在「Instance size」(執行個體大小) 下方,定義執行個體的 shard 數量。分割區數量會決定用於儲存執行個體資料的總記憶體容量。已停用叢集模式的執行個體只支援一個 shard。詳情請參閱「執行個體和分割區規格」。
    • 如果您想建立含有備用資源的執行個體,請在「備用資源」下方輸入所需的備用資源數量 (每個區塊)。可接受的值為「No Replica」、「1 Replica」和「2 Replicas」。使用 Google Cloud 控制台時,預設值為 1 個複本。
    • 在「Set up connection」(設定連線) 下方,選取所需網路。如要進一步瞭解 Memorystore for Valkey 的私人網路,請參閱「網路」。
    • 如要啟用 IAM 驗證,請選取「啟用 IAM 驗證」
    • 如要啟用傳輸中加密功能,請選取「啟用傳輸層安全標準 (TLS)」
    • 在「Choose version」下方,選取 Valkey 版本。預設為 Valkey 7.2 版。
  4. 按一下 [Create Instance] (建立執行個體) 按鈕。

gcloud

如要為 Valkey 建立 Memorystore,請執行 create 指令:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints=connections=[{pscAutoConnection={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 是您想要的備用資源數量 (每個資料分割)。可接受的值為 012

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

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

    如要進一步瞭解節點類型和執行個體設定,請參閱「執行個體和節點規格」。

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

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

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

例如:

已啟用叢集模式的範例


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints=connections=[{pscAutoConnection={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={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={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 是您選擇的備用資源數量 (每個資料分割)。可接受的值為 012

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

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

    如要進一步瞭解節點類型和執行個體設定,請參閱「執行個體和節點規格」。

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

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

  • MODE 會決定是否應啟用或停用叢集模式。如果省略這個欄位,模式預設為啟用叢集模式。詳情請參閱「啟用及停用叢集模式」。

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

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