クラスタを構成する

Memorystore for Redis Cluster は、Redis 構成パラメータのサブセットをサポートしており、これを変更することでクラスタの動作をカスタマイズできます。

構成の変更のためにクラスタを再起動する必要はなく、サービスが中断されることもありません。Memorystore for Redis Cluster は変更をすぐに保存します。クラスタが再起動しても、クラスタは構成の変更を保持します。クラスタを作成したら、変更可能な構成パラメータを更新できます。詳細については、サポートされているクラスタ構成をご覧ください。

始める前に

Google Cloud CLI の最新バージョンがインストールされていることを確認します。既存のインストールを更新するには、gcloud components update コマンドを使用します。

構成パラメータを表示する

構成パラメータを表示するには、gcloud redis clusters describe コマンドを使用します。

gcloud redis clusters describe CLUSTER_ID --region=REGION_ID

次のように置き換えます。

  • CLUSTER_ID: クラスタの ID
  • REGION_ID: クラスタが配置されているリージョン

次に例を示します。

gcloud redis clusters describe my-cluster --region=us-central1

構成パラメータをデフォルト値から変更しない場合、パラメータは出力に表示されません。

クラスタの作成時に構成パラメータを設定する

クラスタの作成時に構成パラメータを設定するには、--redis-config フラグを指定して
gcloud redis clusters create コマンドを使用します。

gcloud redis clusters create CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--network=NETWORK \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--redis-config=CONFIG_NAME=CONFIG_VALUE

次のように置き換えます。

  • CLUSTER_ID: 作成するクラスタの ID。
  • REGION_ID: クラスタを配置するリージョン。
  • PROJECT_ID: プロジェクト ID。
  • NETWORK: クラスタが接続する Virtual Private Cloud(VPC)ネットワークの名前または完全修飾パス。
  • NODE_TYPE: クラスタのノードタイプ。

  • SHARD_COUNT: クラスタ内のシャードの数。シャード数は、クラスタデータを保存するための合計メモリ容量を決定します。

  • CONFIG_NAME: 設定する構成パラメータの名前。

  • CONFIG_VALUE: 設定するパラメータの値。

次に例を示します。

gcloud redis clusters create my-cluster --region=us-east1 --project=my-project --network=projects/my-project/global/networks/default --node-type=redis-highmem-medium --shard-count=3 --redis-config=maxmemory-policy=allkeys-lru

構成パラメータを更新する

既存のクラスタの構成パラメータを更新するには、--update-redis-config フラグを指定して
gcloud redis clusters update コマンドを使用します。

gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--update-redis-config=CONFIG_NAME=CONFIG_VALUE

次のように置き換えます。

  • CLUSTER_ID: クラスタの ID
  • REGION_ID: クラスタが配置されているリージョン
  • PROJECT_ID: プロジェクト ID
  • CONFIG_NAME: 更新する構成パラメータの名前
  • CONFIG_VALUE: パラメータの新しい値

次に例を示します。

gcloud redis clusters update my-cluster --region=us-east1 --project=my-project --update-redis-config=maxmemory-policy=allkeys-lru

更新可能な構成パラメータの詳細については、変更可能な構成パラメータをご覧ください。

構成パラメータをリセットする

構成パラメータをデフォルト値にリセットするには、--remove-redis-config フラグを指定して
gcloud redis clusters update コマンドを使用します。

gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--remove-redis-config=CONFIG_NAME

次のように置き換えます。

  • CLUSTER_ID: クラスタの ID
  • REGION_ID: クラスタが配置されているリージョン
  • PROJECT_ID: プロジェクト ID
  • CONFIG_NAME: デフォルト値にリセットする構成パラメータの名前

次に例を示します。

gcloud redis clusters update my-cluster --region=us-east1 --project=my-project --remove-redis-config=maxmemory-policy