インスタンスを作成する

このページでは、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. [インスタンスの名前を指定] セクションに、インスタンスの ID を入力します。インスタンス ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。

4. [リージョン] メニューから、インスタンスのリージョンを選択します。

5. マルチゾーン インスタンスを作成するため、[ゾーンの可用性] セクションで [マルチゾーン] オプションを選択します。

6. [ノードタイプ] セクションで、次のいずれかのノードタイプを選択します。

   • Shared-Core（shared-core-nano）
   • 小（standard-small）
   • 中（highmem-medium）
   • 特大（highmem-xlarge）

7. [クラスタモード] セクションで、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらが必要かを指定します。これらのタイプのインスタンスの詳細については、クラスタ モードを有効または無効にするをご覧ください。

   注: クラスタモードが有効または無効のインスタンスを作成した後に、インスタンスを別のモードに変更することはできません。このモードは水平スケーリングの特性が優れているため、[有効] を選択することをおすすめします。

8. [インスタンス サイズ] セクションに、インスタンスのシャード数を入力します。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。インスタンス仕様の詳細については、インスタンスとノードの仕様をご覧ください。

9. レプリカを使用してインスタンスを作成する場合は、[レプリカ] セクションでレプリカ数（シャードあたり）を選択します。0 ～ 5 個のレプリカを選択できます。デフォルト値は 1 レプリカです。

10. [接続の設定] セクションで、アプリケーションがこのインスタンスへの接続に使用できるネットワークを選択します。Memorystore for Valkey のプライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。

11. インスタンスのセキュリティを強化する場合は、[セキュリティ] セクションで、[IAM AUTH を有効にする] チェックボックスをオンにして IAM 認証を有効にします。

    注: このチェックボックスをオンにすると、Memorystore for Valkey で [転送中の暗号化（TLS）を有効にする] チェックボックスが自動的にオンになり、[認証局の管理] セクションが表示されます。Memorystore for Valkey は、インスタンスからアプリケーションに送信されるときに認証情報が機密情報になるように、認証情報を暗号化します。

12. [認証局の管理] セクションで、[インスタンスごとの CA]、[顧客管理の CA]、[共有 CA] のいずれかのオプションを選択します。これらのオプションは、インスタンスの認証局（CA）モードを表します。CA モードは、インスタンスのデジタル証明書の発行に使用される CA 階層を決定します。

    [顧客管理の CA] オプションを選択した場合は、CA プールを追加する必要があります。CA プールは、共通の証明書発行ポリシーと Identity and Access Management（IAM）ポリシーを持つ複数の CA の集合です。CA プールを使用すると、CA ローテーション管理が容易になり、より高い有効な合計秒間クエリ数（QPS）を実現できます。

    CA プールを追加するには、次のいずれかを行います。

    1. 別の Google Cloud プロジェクトから CA プールを追加するには、[別のプロジェクトから CA を追加] チェックボックスをオンにして、テキスト フィールドにプールのリソース ID を入力します。

    2. インスタンスの作成に使用しているプロジェクトと同じ Google Cloud プロジェクトにある CA プールを追加するには、[CA プール] メニューからプールを選択します。

13. [暗号化] セクションで、次のいずれかのオプションを選択します。

    • Google 管理の暗号鍵: Google が鍵を使用してインスタンス内のデータを暗号化するようにします。これは、Google のデフォルトの暗号化です。

    • Cloud KMS 鍵: Memorystore for Valkey などの CMEK 統合サービスで、Cloud Key Management Service（Cloud KMS）の顧客管理の暗号鍵（CMEK）を使用してデータの暗号化を管理する場合。

      このオプションを選択した場合は、次の操作を行います。

      1. [鍵管理タイプ] メニューで、[Cloud KMS] を選択します。
      2. [Cloud KMS 鍵の選択] メニューから、CMEK を選択します。

14. [データ永続性戦略] セクションで、Memorystore for Valkey がインスタンス内のデータを永続化する方法を指定します。使用できる値は、[永続性なし]、[追加専用ファイル（AOF）の永続性]、[メモリ スナップショットの永続性] です。

15. インスタンスの自動バックアップを有効にする場合は、次の操作を行います。

    1. [自動バックアップを有効にする] チェックボックスをオンにします。
    2. [バックアップを保持する日数] フィールドに、自動的に削除されるまで Memorystore for Valkey でバックアップを保持する日数を入力します。1～365 日の範囲で指定できます。デフォルト値は 35 日です。
    3. [時間枠] メニューから、毎日のバックアップの時刻を選択します。

16. [メンテナンス] セクションで、次のいずれかのオプションを選択します。

    • デフォルト: Memorystore for Valkey は、サービスの信頼性、パフォーマンス、セキュリティ、最新性を確保するために、インスタンスを定期的に更新します。
    • カスタム: アプリケーションのニーズに合わせてインスタンスのメンテナンス スケジュールをカスタマイズし、中断を最小限に抑える場合。このオプションを選択した場合は、メンテナンスを実行する曜日と、メンテナンスの時間枠を開始する時間を指定します。

17. [バージョンの選択] セクションで、Valkey バージョンを選択します。利用可能なバージョンは 7.2、8.0、9.0 です。デフォルトのバージョンは 9.0 です。

    重要: インスタンスのバージョンとして 9.0 を選択した場合、インスタンスを以前のバージョンにダウングレードすることはできません。

18. [インスタンスを作成] をクリックします。

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
  注意: このノードタイプには SLA がないため、開発またはテスト目的でのみ 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_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 です。

単一ゾーン インスタンスを作成する

このセクションでは、単一ゾーン インスタンスを作成する手順について説明します。

重要: 以下の手順を行う前に、始める前におよびネットワークを設定するセクションの手順を完了してください。

コンソール

1. Google Cloud コンソールで、[Memorystore for Valkey] ページに移動します。

   Memorystore for Valkey

2. [インスタンスを作成] をクリックします。

3. [インスタンスの名前を指定] セクションに、インスタンスの ID を入力します。インスタンス ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。

4. [リージョン] メニューから、インスタンスのリージョンを選択します。

5. [ゾーンの可用性] セクションで、次の操作を行います。

   1. [シングルゾーン] オプションを選択します。

   2. [ゾーン] メニューから、Memorystore for Valkey でインスタンスを作成するゾーンを選択します。

6. [ノードタイプ] セクションで、次のいずれかのノードタイプを選択します。

   • Shared-Core（shared-core-nano）
   • 小（standard-small）
   • 中（highmem-medium）
   • 特大（highmem-xlarge）

7. [クラスタモード] セクションで、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらが必要かを指定します。これらのタイプのインスタンスの詳細については、クラスタ モードを有効または無効にするをご覧ください。

   注: クラスタモードが有効または無効のインスタンスを作成した後に、インスタンスを別のモードに変更することはできません。このモードは水平スケーリングの特性が優れているため、[有効] を選択することをおすすめします。

8. [インスタンス サイズ] セクションに、インスタンスのシャード数を入力します。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。インスタンス仕様の詳細については、インスタンスとノードの仕様をご覧ください。

9. レプリカを使用してインスタンスを作成する場合は、[レプリカ] セクションでレプリカ数（シャードあたり）を選択します。0 ～ 5 個のレプリカを選択できます。デフォルト値は 1 レプリカです。

10. [接続の設定] セクションで、アプリケーションがこのインスタンスへの接続に使用できるネットワークを選択します。Memorystore for Valkey のプライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。

11. インスタンスのセキュリティを強化する場合は、[セキュリティ] セクションで、[IAM AUTH を有効にする] チェックボックスをオンにして IAM 認証を有効にします。

    注: このチェックボックスをオンにすると、Memorystore for Valkey で [転送中の暗号化（TLS）を有効にする] チェックボックスが自動的にオンになり、[認証局の管理] セクションが表示されます。Memorystore for Valkey は、インスタンスからアプリケーションに送信されるときに認証情報が機密情報になるように、認証情報を暗号化します。

12. [認証局の管理] セクションで、[インスタンスごとの CA]、[顧客管理の CA]、[共有 CA] のいずれかのオプションを選択します。これらのオプションは、インスタンスの認証局（CA）モードを表します。CA モードは、インスタンスのデジタル証明書の発行に使用される CA 階層を決定します。

    [顧客管理の CA] オプションを選択した場合は、CA プールを追加する必要があります。CA プールは、共通の証明書発行ポリシーと Identity and Access Management（IAM）ポリシーを持つ複数の CA の集合です。CA プールを使用すると、CA ローテーション管理が容易になり、より高い有効な合計秒間クエリ数（QPS）を実現できます。

    CA プールを追加するには、次のいずれかを行います。

    1. 別の Google Cloud プロジェクトから CA プールを追加するには、[別のプロジェクトから CA を追加] チェックボックスをオンにして、テキスト フィールドにプールのリソース ID を入力します。

    2. インスタンスの作成に使用しているプロジェクトと同じ Google Cloud プロジェクトにある CA プールを追加するには、[CA プール] メニューからプールを選択します。

13. [暗号化] セクションで、次のいずれかのオプションを選択します。

    • Google 管理の暗号鍵: Google が鍵を使用してインスタンス内のデータを暗号化するようにします。これは、Google のデフォルトの暗号化です。

    • Cloud KMS 鍵: Memorystore for Valkey などの CMEK 統合サービスで、Cloud Key Management Service（Cloud KMS）の顧客管理の暗号鍵（CMEK）を使用してデータの暗号化を管理する場合。

      このオプションを選択した場合は、次の操作を行います。

      1. [鍵管理タイプ] メニューで、[Cloud KMS] を選択します。
      2. [Cloud KMS 鍵の選択] メニューから、CMEK を選択します。

14. [データ永続性戦略] セクションで、Memorystore for Valkey がインスタンス内のデータを永続化する方法を指定します。使用できる値は、[永続性なし]、[追加専用ファイル（AOF）の永続性]、[メモリ スナップショットの永続性] です。

15. インスタンスの自動バックアップを有効にする場合は、次の操作を行います。

    1. [自動バックアップを有効にする] チェックボックスをオンにします。
    2. [バックアップを保持する日数] フィールドに、自動的に削除されるまで Memorystore for Valkey でバックアップを保持する日数を入力します。1～365 日の範囲で指定できます。デフォルト値は 35 日です。
    3. [時間枠] メニューから、毎日のバックアップの時刻を選択します。

16. [メンテナンス] セクションで、次のいずれかのオプションを選択します。

    • デフォルト: Memorystore for Valkey は、サービスの信頼性、パフォーマンス、セキュリティ、最新性を確保するために、インスタンスを定期的に更新します。
    • カスタム: アプリケーションのニーズに合わせてインスタンスのメンテナンス スケジュールをカスタマイズし、中断を最小限に抑える場合。このオプションを選択した場合は、メンテナンスを実行する曜日と、メンテナンスの時間枠を開始する時間を指定します。

17. [バージョンの選択] セクションで、Valkey バージョンを選択します。利用可能なバージョンは 7.2、8.0、9.0 です。デフォルトのバージョンは 9.0 です。

    重要: インスタンスのバージョンとして 9.0 を選択した場合、インスタンスを以前のバージョンにダウングレードすることはできません。

18. [インスタンスを作成] をクリックします。

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
  注意: このノードタイプには SLA がないため、開発またはテスト目的でのみ 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_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 に設定されている場合にのみ適用されます。