インスタンスを作成する

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

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
  注意: このノードタイプには 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_8_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

Cluster Mode Disabled の例

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

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
  注意: このノードタイプには 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_8_0 です。

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

• SHARD_COUNT によってインスタンス内のシャードの数が決定されます。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。選択したモードがクラスタモードが無効になっている場合、インスタンスに指定できるシャードは 1 つのみです。詳細については、インスタンスとノードの仕様をご覧ください。

• MODE は、インスタンスをクラスタモード有効にするか、クラスタモード無効にするかを決定します。このフィールドを省略すると、モードはデフォルトでクラスタモード有効になります。詳細については、クラスタ モードを有効または無効にするをご覧ください。

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

• ZONE_DISTRIBUTION_CONFIG_MODE は、シングルゾーン インスタンスとマルチゾーン インスタンスのどちらをプロビジョニングするかを選択できるモードです。デフォルトはマルチゾーンです。指定できる値は single-zone、multi-zone です。

• ZONE は、ノードをプロビジョニングするゾーンです。このフラグは、--zone-distribution-config-mode= が single-zone に設定されている場合にのみ適用されます。