建立執行個體

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

事前準備

完成「事前準備」的指示：

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

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

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

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

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

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 執行個體的網路建立服務連線政策，請按照「網路」指南建立政策。

建立執行個體

重要事項：按照本程序中的步驟操作前，請先完成「事前準備」和「設定網路」一節中的步驟。

如果您建立含有副本的執行個體，且要建立執行個體的地區中，有單一可用區無法使用，則 Memorystore for Valkey 會在該地區的可用區中建立執行個體。這項區域分配作業是暫時性的。無法使用的區域恢復運作後，Memorystore for Valkey 會重新分配執行個體的節點，確保節點平均分布在各個區域。

如果您建立的執行個體沒有副本，且單一可用區無法使用，則 Memorystore for 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 數量會決定儲存執行個體資料的記憶體總容量。已停用叢集模式的執行個體只支援一個 shard，詳情請參閱「執行個體和分片規格」。

   • 如要建立含有副本的執行個體，請在「副本」下方輸入副本數量 (每個分片)。可接受的值為「No Replica」(無副本)、「1 Replica」(1 個副本)、「2 Replicas」(2 個副本)、「3 Replicas」(3 個副本)、「4 Replicas」(4 個副本) 和「5 Replicas」(5 個副本)。

     注意： 每個執行個體最多可建立五個副本。

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

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

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

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

4. 按一下「建立執行個體」按鈕。

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

注意： 您只能在 Memorystore for Valkey 的支援區域中建立執行個體。

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

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

• REPLICA_COUNT 是備用資源數量 (每個分片)。可接受的值為 0-5。

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

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  注意：我們建議您僅將 shared-core-nano 節點類型用於開發或測試用途，因為這個節點類型沒有服務水準協議。如果您在正式環境中執行 Memorystore for Valkey，建議使用 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-5。

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

  • shared-core-nano
  • standard-small
  • highmem-medium
  • highmem-xlarge
  注意：我們建議您僅將 shared-core-nano 節點類型用於開發或測試用途，因為這個節點類型沒有服務水準協議。如果您在正式環境中執行 Memorystore for Valkey，建議使用 standard-small、highmem-medium 或 highmem-xlarge 節點類型。如要進一步瞭解這些節點類型，請參閱「選擇節點類型」一文。

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

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

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

  注意： 建立啟用叢集模式或停用叢集模式的執行個體後，就無法將執行個體變更為另一種模式。建議您建立已啟用叢集模式的執行個體，因為這類執行個體具有更出色的擴充特性。

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

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