建立執行個體

本頁說明如何在 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. 在「Name your instance」(為執行個體命名) 專區中，輸入執行個體的 ID。執行個體 ID 只能使用小寫英文字母、數字和連字號。開頭須為英文字母，且在所屬區域中不得重複。

4. 從「Region」(地區) 選單中，選取執行個體的地區。

5. 在「可用區可用性」部分，選取「多區域」選項，因為您要建立多區域執行個體。

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

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

7. 在「叢集模式」部分，指定要啟用叢集模式或停用叢集模式。如要進一步瞭解這些執行個體類型，請參閱「啟用及停用叢集模式」。

   注意： 建立啟用叢集模式或停用叢集模式的執行個體後，就無法將執行個體變更為另一種模式。建議選取「已啟用」，因為這個模式的水平擴充特性較佳。

8. 在「Instance size」(執行個體大小) 部分中，輸入執行個體的 shard 數量。分片數量決定了儲存執行個體資料的總記憶體容量。如要進一步瞭解執行個體規格，請參閱執行個體和節點規格。

9. 如要建立具備副本的執行個體，請在「副本」部分選取副本數量 (每個分片)。您可以選取 0 到 5 個副本。預設值為 1 個副本。

10. 在「設定連線」部分中，選取應用程式可用來連線至這個執行個體的網路。如要進一步瞭解 Memorystore for Valkey 的私人網路，請參閱「網路」。

11. (選用) 如要提高執行個體的安全性，請在「安全性」部分中，選取「啟用 IAM AUTH」核取方塊，啟用 IAM 驗證。

    注意： 如果選取這個核取方塊，Memorystore for Valkey 會自動選取「啟用傳輸中資料加密 (TLS)」核取方塊。因此，Memorystore for Valkey 會加密您的憑證，確保憑證從執行個體傳輸至應用程式時受到保護。

12. 在「資料保留策略」部分，指定您希望 Memorystore for Valkey 如何保留執行個體中的資料。可接受的值為「No persistence」(不保留)、「Append Only File (AOF) persistence」(僅附加檔案保留)，以及「Memory Snapshot persistence」(記憶體快照保留)。

13. (選用) 如要為執行個體啟用自動備份，請按照下列步驟操作：

    1. 勾選「每日自動備份」核取方塊。
    2. 在「保留備份的天數」欄位中，輸入您希望 Memorystore for Valkey 保留備份的天數，系統會在期限過後自動刪除備份。你可以指定 1 到 365 天。預設值為 35 天。
    3. 從「時間範圍」選單中，選取每日備份的時間。

14. 在「選擇版本」部分，選取 Valkey 版本。可用版本包括 7.2、8.0 和 9.0 (預先發布版)。預設版本為 8.0 版。

    重要事項： 如果選取 9.0 做為執行個體的版本，就無法將執行個體降級為較舊的版本。

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

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 是 Memorystore for Valkey 執行個體的版本。這個參數可接受的值為 VALKEY_7_2、VALKEY_8_0 和 VALKEY_9_0 (預覽版)。如未指定值，預設值為 VALKEY_8_0。

  重要事項： 如果將執行個體版本指定為 VALKEY_9_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。

建立單一可用區執行個體

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

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

控制台

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

   Memorystore for Valkey

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

3. 在「Name your instance」(為執行個體命名) 專區中，輸入執行個體的 ID。執行個體 ID 只能使用小寫英文字母、數字和連字號。開頭須為英文字母，且在所屬區域中不得重複。

4. 從「Region」(地區) 選單中，選取執行個體的地區。

5. 在「可用區可用性」部分，執行下列操作：

   1. 選取「單一可用區」選項。

   2. 從「Zone」(區域) 選單中，選取要讓 Memorystore for Valkey 建立執行個體的區域。

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

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

7. 在「叢集模式」部分，指定要啟用叢集模式或停用叢集模式。如要進一步瞭解這些執行個體類型，請參閱「啟用及停用叢集模式」。

   注意： 建立啟用叢集模式或停用叢集模式的執行個體後，就無法將執行個體變更為另一種模式。建議選取「已啟用」，因為這個模式的水平擴充特性較佳。

8. 在「Instance size」(執行個體大小) 部分中，輸入執行個體的 shard 數量。分片數量決定了儲存執行個體資料的總記憶體容量。如要進一步瞭解執行個體規格，請參閱執行個體和節點規格。

9. 如要建立具備副本的執行個體，請在「副本」部分選取副本數量 (每個分片)。您可以選取 0 到 5 個副本。預設值為 1 個副本。

10. 在「設定連線」部分中，選取應用程式可用來連線至這個執行個體的網路。如要進一步瞭解 Memorystore for Valkey 的私人網路，請參閱「網路」。

11. (選用) 如要提高執行個體的安全性，請在「安全性」部分中，選取「啟用 IAM AUTH」核取方塊，啟用 IAM 驗證。

    注意： 如果選取這個核取方塊，Memorystore for Valkey 會自動選取「啟用傳輸中資料加密 (TLS)」核取方塊。因此，Memorystore for Valkey 會加密您的憑證，確保憑證從執行個體傳輸至應用程式時受到保護。

12. 在「資料保留策略」部分，指定您希望 Memorystore for Valkey 如何保留執行個體中的資料。可接受的值為「No persistence」(不保留)、「Append Only File (AOF) persistence」(僅附加檔案保留)，以及「Memory Snapshot persistence」(記憶體快照保留)。

13. (選用) 如要為執行個體啟用自動備份，請按照下列步驟操作：

    1. 勾選「每日自動備份」核取方塊。
    2. 在「保留備份的天數」欄位中，輸入您希望 Memorystore for Valkey 保留備份的天數，系統會在期限過後自動刪除備份。你可以指定 1 到 365 天。預設值為 35 天。
    3. 從「時間範圍」選單中，選取每日備份的時間。

14. 在「選擇版本」部分，選取 Valkey 版本。可用版本包括 7.2、8.0 和 9.0 (預先發布版)。預設版本為 8.0 版。

    重要事項： 如果選取 9.0 做為執行個體的版本，就無法將執行個體降級為較舊的版本。

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

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 是 Memorystore for Valkey 執行個體的版本。這個參數可接受的值為 VALKEY_7_2、VALKEY_8_0 和 VALKEY_9_0 (預覽版)。如未指定值，預設值為 VALKEY_8_0。

  重要事項： 如果將執行個體版本指定為 VALKEY_9_0，就無法將執行個體降級為舊版。

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

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

  注意： 建立啟用叢集模式或停用叢集模式的執行個體後，就無法將執行個體變更為另一種模式。建議您建立啟用叢集模式的執行個體，因為這類執行個體的資源調度特性較佳。

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

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