インスタンスの作成

このページでは、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 インスタンスを作成するネットワークにサービス接続ポリシーが作成されていない場合は、ネットワーキングのガイダンスに沿って作成します。

インスタンスの作成

コンソール

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

    Memorystore for Valkey

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

  3. [Valkey インスタンスの作成] ページで、新しいインスタンスに必要な構成を選択します。

    • [インスタンスの名前を指定] にインスタンス ID を入力します。インスタンス ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。
      • 例: my-instance-1。
    • [リージョンを選択] で、インスタンスのリージョンを選択します。

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

      • 共有コア（shared-core-nano）
      • 小（standard-small）
      • 中（highmem-medium）
      • 特大（highmem-xlarge）

    • [モード] で、[クラスタモード有効] または [クラスタモード無効] を選択します。

    • [インスタンス サイズ] で、インスタンスのシャード数を定義します。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。クラスタモードが無効になっているインスタンスでサポートされるシャードは 1 つのみです。詳細については、インスタンスとシャードの仕様をご覧ください。

    • レプリカを使用してインスタンスを作成する場合は、[レプリカ] にレプリカ数（シャードあたり）を入力します。有効な値は、レプリカなし、1 レプリカ、2 レプリカ、3 レプリカ、4 レプリカ、5 レプリカです。

    • [接続の設定] で、ネットワークを選択します。Memorystore for Valkey のプライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。

    • IAM 認証を有効にする場合は、[IAM AUTH を有効にする] を選択します。

    • 転送中の暗号化を有効にする場合は、[Transport Layer Security（TLS）を有効にする] を選択します。

    • [Choose version] で、Valkey のバージョンを選択します。デフォルトは Valkey バージョン 7.2 です。

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

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 は、選択したノードタイプです。次の値が利用できます。

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

  • ENGINE_VERSION は、選択した Valkey エンジン バージョンです。指定できる値は VALKEY_7_2 と VALKEY_8_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 です。

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

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

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

  • ENGINE_VERSION は、選択した Valkey エンジン バージョンです。指定できる値は VALKEY_7_2 と VALKEY_8_0 です。

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

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

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

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