本頁面提供建立 Memorystore for Valkey 執行個體的操作說明。
事前準備
請先完成以下操作說明:
- 在 Google Cloud 控制台的專案選取器頁面中,選取或建立 Google Cloud 專案。
注意:如果您不打算保留在這項程序中建立的資源,請建立新專案,不要選取現有專案。這樣在完成這些步驟後,您就可以刪除專案,並移除與該專案相關聯的所有資源。
前往專案選取器 - 請確認您已為專案啟用計費功能。瞭解如何檢查專案是否已啟用計費功能。
注意:如果您先前已安裝 gcloud CLI,請執行
gcloud components update
,確認您使用的是最新版本。您必須使用至少 gcloud CLI 版本489.0.0
,才能存取 Memorystore for Valkey 的 gcloud CLI 指令。-
啟用 Memorystore for Valkey API
Memorystore for Valkey -
啟用 Network Connectivity API
Network Connectivity API -
啟用 Service Consumer Management API
Service Consumer Management API
其他事前準備
- 您必須在 Google Cloud 所用專案中具備下列其中一個 IAM 角色:
roles/memorystore.admin
(Memorystore 管理員預先定義的 IAM 角色)roles/owner
(擁有者基本 IAM 角色)roles/editor
(編輯者基本 IAM 角色)
設定網路
請參閱「網路連線」頁面,判斷是否需要設定服務連線政策。
如果您要建立 Valkey 執行個體的網路尚未建立服務連線政策,請按照網路指南建立政策。
建立執行個體
控制台
前往 Google Cloud 控制台的「Memorystore for Valkey」頁面。
點選「建立執行個體」。
在「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 版。
- 在「Instance name」(執行個體名稱) 下方輸入執行個體 ID。執行個體 ID 只能使用小寫英文字母、數字和連字號。開頭也必須是英文字母,且在其區域中不得重複。
按一下 [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 是您想要的備用資源數量 (每個資料分割)。可接受的值為
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。詳情請參閱「執行個體和節點規格」。
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 是您選擇的備用資源數量 (每個資料分割)。可接受的值為
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。詳情請參閱「執行個體和節點規格」。
MODE 會決定是否應啟用或停用叢集模式。如果省略這個欄位,模式預設為啟用叢集模式。詳情請參閱「啟用及停用叢集模式」。
ZONE_DISTRIBUTION_CONFIG_MODE 模式可讓您選擇要佈建單一可用區執行個體還是多可用區執行個體。預設為多區域。可接受的值為
single-zone
和multi-zone
。ZONE 是您要佈建節點的區域。只有在
--zone-distribution-config-mode=
設為single-zone
時,才能使用這個旗標。