このページでは、Memorystore for Valkey でシングルゾーン インスタンスとマルチゾーン インスタンスを作成する手順について説明します。
始める前に
開始する前に次の手順を完了してください。
- コンソールで、[プロジェクト セレクタ] ページに移動し、Google Cloud プロジェクトを選択または作成します。
Google Cloud注: この手順で作成するリソースをそのまま保持する予定でない場合は、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。
プロジェクト セレクタに移動 - プロジェクトに対して課金が有効になっていることを確認します。プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
Google Cloud CLI をインストールして初期化します。
注: すでに gcloud CLI をインストールしている場合は、
gcloud components updateを実行して、最新バージョンがインストールされていることを確認してください。Memorystore for Valkey の gcloud CLI コマンドを利用するには、少なくとも gcloud CLI バージョン489.0.0が必要です。-
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 インスタンスを作成するネットワークにサービス接続ポリシーが作成されていない場合は、ネットワーキングのガイダンスに沿って作成します。
マルチゾーン インスタンスを作成する
このセクションでは、マルチゾーン インスタンスを作成する手順について説明します。
コンソール
コンソールで、[Memorystore for Valkey] ページに移動します。 Google Cloud
[インスタンスを作成] をクリックします。
[インスタンスに名前を付ける] セクションで、インスタンスの ID を入力します。インスタンス ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。
[リージョン] メニューから、インスタンスのリージョンを選択します。
[**ゾーンの可用性**] セクションで、マルチゾーン インスタンスを作成するため、[**マルチゾーン**] オプションを選択します。
[クラスタモード] セクションで、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらを使用するかを指定します。これらの タイプのインスタンスの詳細については、クラスタモードを有効または無効にするをご覧ください。
[Node Type] セクションで、ノードタイプを選択します。
[インスタンス サイズ] セクションで、インスタンスのシャード数を入力します。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。インスタンスの仕様の詳細については、 インスタンスとノードの仕様をご覧ください。
レプリカを使用してインスタンスを作成する場合は、[レプリカ] セクションでレプリカ数（シャードあたり）を選択します。0 ～ 5 個のレプリカを選択できます。デフォルト値は 1 レプリカです。
[接続を設定] セクションで、アプリケーションがこのインスタンスへの接続に使用できるネットワークを選択します。Memorystore for Valkey の プライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。
インスタンスのセキュリティを強化する場合は、 [Security] セクションで IAM 認証 を有効にするには、[Enable IAM AUTH] チェックボックスをオンにします。
[認証局の管理] セクションで、 [インスタンスごとの CA]、[顧客管理の CA]、または [共有 CA] オプションを選択します。 これらのオプションは、インスタンスの 認証局（CA）モードを表します。CA モードによって、インスタンスのデジタル証明書の発行に使用される CA 階層が決まります。
[顧客管理の CA] オプションを選択した場合は、CA プールを追加する必要があります。CA プールは、共通の証明書発行ポリシーと Identity and Access Management（IAM）ポリシーを持つ複数の CA の集合です。CA プールを使用すると、CA ローテーション管理が容易になり、より高い有効な合計秒間クエリ数（QPS）を実現できます。
CA プールを追加するには、次のいずれかを行います。
別の Google Cloud プロジェクトから CA プールを追加するには、 [別のプロジェクトから CA を追加] チェックボックスをオンにして、テキスト フィールドにプールのリソース IDを入力します。
インスタンスの作成に使用している プロジェクトと同じ Google Cloud プロジェクトにある CA プールを追加するには、 [CA pool] メニューからプールを選択します。
[暗号化] セクションで、次のいずれかのオプションを選択します。
- Google 管理の暗号鍵: Google が鍵を使用してインスタンス内のデータを 暗号化します。これは Google のデフォルトの暗号化です。
Cloud KMS 鍵: Cloud Key Management Service（Cloud KMS）の顧客管理の暗号鍵（CMEK）を、Memorystore for Valkey などの CMEK 統合サービスで使用して、データの暗号化を管理します。
このオプションを選択した場合は、次の操作を行います。
- [鍵管理タイプ] メニューから [Cloud KMS] を選択します。
- [Cloud KMS 鍵の選択] メニューから、CMEK を選択します。
[データ永続性戦略] セクションで、Memorystore for Valkey がインスタンス内のデータを永続化する方法を指定します。使用できる値は、[永続化なし]、 [追加専用ファイル（AOF）] 永続化、 および [メモリ スナップショット] 永続化です。
インスタンスの自動バックアップを有効にする場合は、次の操作を行います 。
- [毎日の自動バックアップ] チェックボックスをオンにします。
- [バックアップの保持日数] フィールドに、Memorystore for Valkey がバックアップを自動的に削除するまでの保持日数を入力します。
1～365日を指定できます。デフォルト値は35日です。 - [時間枠] メニューから、毎日のバックアップの時間を選択します。
[メンテナンス] セクションで、次のいずれかのオプションを選択します。
- デフォルト: Memorystore for Valkey はインスタンスを定期的に更新し、 サービスの信頼性、パフォーマンス、セキュリティ、最新性を確保します。
- カスタム: アプリケーションのニーズに合わせてインスタンスのメンテナンス スケジュールをカスタマイズし、中断を最小限に抑えます。このオプションを選択した場合は、メンテナンスを行う曜日と、メンテナンスの時間枠を開始する時間を指定します。
[バージョンを選択] セクションで、Valkey のバージョンを選択します。使用可能なバージョンは 7.2、8.0、9.0 です。デフォルトのバージョンは 9.0 です。
[インスタンスを作成] をクリックします。
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～5です。NODE_TYPE は、インスタンスに使用する ノードタイプ です。
ENGINE_VERSION は、Memorystore for Valkey インスタンスのバージョンです。このパラメータに使用できる値は、
VALKEY_7_2、VALKEY_8_0、VALKEY_9_0です。値を指定しない場合、デフォルト値はVALKEY_9_0です。SHARD_COUNT によってインスタンス内のシャードの数が決定されます。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。 クラスタモードが無効になっているインスタンスでサポートされるシャードは 1 つのみです。詳細については、 インスタンスとノードの仕様をご覧ください。
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 です。
シングルゾーン インスタンスを作成する
このセクションでは、シングルゾーン インスタンスを作成する手順について説明します。
コンソール
コンソールで、[Memorystore for Valkey] ページに移動します。 Google Cloud
[インスタンスを作成] をクリックします。
[インスタンスに名前を付ける] セクションで、インスタンスの ID を入力します。インスタンス ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。
[リージョン] メニューから、インスタンスのリージョンを選択します。
[ゾーンの可用性] セクションで、次の操作を行います。
[シングルゾーン] オプションを選択します。
[ゾーン] メニューから、Memorystore for Valkey でインスタンスを作成するゾーンを選択します。
[クラスタモード] セクションで、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらを使用するかを指定します。これらの タイプのインスタンスの詳細については、クラスタモードを有効または無効にするをご覧ください。
[Node Type] セクションで、ノードタイプを選択します。
[インスタンス サイズ] セクションで、インスタンスのシャード数を入力します。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。インスタンスの仕様の詳細については、 インスタンスとノードの仕様をご覧ください。
レプリカを使用してインスタンスを作成する場合は、[レプリカ] セクションでレプリカ数（シャードあたり）を選択します。0 ～ 5 個のレプリカを選択できます。デフォルト値は 1 レプリカです。
[接続を設定] セクションで、アプリケーションがこのインスタンスへの接続に使用できるネットワークを選択します。Memorystore for Valkey の プライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。
インスタンスのセキュリティを強化する場合は、 [セキュリティ] セクションで [IAM AUTH を有効にする] チェックボックスをオンにして、[IAM 認証] を有効にします。
[認証局の管理] セクションで、 [インスタンスごとの CA]、[顧客管理の CA]、または [共有 CA] オプションを選択します。 これらのオプションは、インスタンスの 認証局（CA）モードを表します。CA モードによって、インスタンスのデジタル証明書の発行に使用される CA 階層が決まります。
[顧客管理の CA] オプションを選択した場合は、CA プールを追加する必要があります。CA プールは、共通の証明書発行ポリシーと Identity and Access Management（IAM）ポリシーを持つ複数の CA の集合です。CA プールを使用すると、CA ローテーション管理が容易になり、より高い有効な合計秒間クエリ数（QPS）を実現できます。
CA プールを追加するには、次のいずれかを行います。
別の Google Cloud プロジェクトから CA プールを追加するには、 [別のプロジェクトから CA を追加] チェックボックスをオンにして、テキスト フィールドにプールのリソース ID を入力します。
インスタンスの作成に使用している プロジェクトと同じ Google Cloud プロジェクトにある CA プールを追加するには、 [CA pool] メニューからプールを選択します。
[暗号化] セクションで、次のいずれかのオプションを選択します。
- Google 管理の暗号鍵: Google が鍵を使用してインスタンス内のデータを 暗号化します。これは Google のデフォルトの暗号化です。
Cloud KMS 鍵: Cloud Key Management Service（Cloud KMS）の顧客管理の暗号鍵（CMEK）を、Memorystore for Valkey などの CMEK 統合サービスで使用して、データの暗号化を管理します。
このオプションを選択した場合は、次の操作を行います。
- [鍵管理タイプ] メニューから [Cloud KMS] を選択します。
- [Cloud KMS 鍵の選択] メニューから、CMEK を選択します。
[データ永続性戦略] セクションで、Memorystore for Valkey がインスタンス内のデータを永続化する方法を指定します。使用できる値は、[永続化なし]、 [追加専用ファイル（AOF）] 永続化、 および [メモリ スナップショット] 永続化です。
インスタンスの自動バックアップを有効にする場合は、次の操作を行います 。
- [毎日の自動バックアップ] チェックボックスをオンにします。
- [バックアップの保持日数] フィールドに、Memorystore for Valkey がバックアップを自動的に削除するまでの保持日数を入力します。
1～365日を指定できます。デフォルト値は35日です。 - [時間枠] メニューから、毎日のバックアップの時間を選択します。
[メンテナンス] セクションで、次のいずれかのオプションを選択します。
- デフォルト: Memorystore for Valkey はインスタンスを定期的に更新し、 サービスの信頼性、パフォーマンス、セキュリティ、最新性を確保します。
- カスタム: アプリケーションのニーズに合わせてインスタンスのメンテナンス スケジュールをカスタマイズし、中断を最小限に抑えます。このオプションを選択した場合は、メンテナンスを行う曜日と、メンテナンスの時間枠を開始する時間を指定します。
[バージョンを選択] セクションで、Valkey のバージョンを選択します。使用可能なバージョンは 7.2、8.0、9.0 です。デフォルトのバージョンは 9.0 です。
[インスタンスを作成] をクリックします。
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 は、インスタンスに使用する ノードタイプ です。
ENGINE_VERSION は、Memorystore for Valkey インスタンスのバージョンです。このパラメータに使用できる値は、
VALKEY_7_2、VALKEY_8_0、VALKEY_9_0です。値を指定しない場合、デフォルト値はVALKEY_9_0です。SHARD_COUNT によってインスタンス内のシャードの数が決定されます。 シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。選択したモードがクラスタモードが無効の場合、インスタンスに指定できるシャードは 1 つのみです。詳細については、 インスタンスとノードの仕様をご覧ください。
MODE は、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらを作成するかを決定します。このフィールドを省略すると、モードのデフォルトはクラスタモードが有効になります。詳細については、 クラスタモードを有効または無効にするをご覧ください。
ZONE_DISTRIBUTION_CONFIG_MODE は、シングルゾーン インスタンスとマルチゾーン インスタンスのどちらをプロビジョニングするかを選択できる モードです。デフォルトは
multi-zoneです。使用できる値はsingle-zoneとmulti-zoneです。ZONE は、ノードをプロビジョニングするゾーンです。このフラグは、
--zone-distribution-config-mode=がsingle-zoneに設定されている場合にのみ適用されます。