このページでは、Memorystore for Redis Cluster インスタンスを作成、管理する方法について説明します。
始める前に
- Google Cloud コンソールの [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
注: この手順で作成するリソースをそのまま保持する予定でない場合は、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。
プロジェクト セレクタに移動 - プロジェクトに対して課金が有効になっていることを確認します。プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
Google Cloud CLI をインストールして初期化します。
注: すでに gcloud CLI をインストールしている場合は、
gcloud components update
を実行して、最新バージョンがインストールされていることを確認してください。Memorystore for Redis Cluster の gcloud CLI コマンドを利用するには、少なくとも gcloud CLI バージョン431.0.0
が必要です。-
Memorystore for Redis API を有効にする。
Memorystore for Redis -
Compute Engine API を有効にする
Compute Engine -
Resource Manager API を有効にする
Resource Manager -
Network Connectivity API を有効にする
Network Connectivity API -
Service Consumer Management API を有効にする
Service Consumer Management API
その他の前提条件
- Memorystore for Redis Cluster の限定公開プレビューにアクセスするには、使用しているプロジェクトが許可リストに登録されている必要があります。使用しているプロジェクトが Memorystore エンジニアリング チームによって許可リストに登録されていない場合は、
memorystore-cluster-feedback@google.com
までメールでご連絡ください。 - インスタンスを作成するには、正しいサービス接続ポリシーが必要です。詳しくは、ネットワーキングをご覧ください。
- 使用している Google Cloud プロジェクトに、次のいずれかの IAM ロールが必要です。
roles/redis.admin
(Memorystore 管理者の IAM 事前定義ロール)roles/owner
(オーナーの基本 IAM ロール)roles/editor
(編集者の基本 IAM ロール)
インスタンスを作成する
コンソール
Google Cloud コンソールで [Memorystore for Redis Cluster] ページに移動します。
[CREATE CLUSTER] をクリックします。
[Redis クラスタ インスタンスの作成] ページで、新しいインスタンスに必要な構成を選択します。
- インスタンスの [クラスタ ID] を確認します。クラスタ ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。
- 例:
my-instance-1
。
- 例:
- インスタンスの [リージョン] を選択します。
- [クラスタサイズ] で、クラスタの 13 GB シャードの数を定義します。シャード数は、クラスタデータを保存するための合計メモリ容量を決定します。クラスタ仕様の詳細については、クラスタとシャードの仕様をご覧ください。
- リードレプリカを選択しない場合、この値の範囲は 3 ~ 250 シャードです。
- ノードあたり 1 つのリードレプリカを選択した場合、この値は 3 ~ 125 シャードの範囲になります。
- ノードごとに 2 つのリードレプリカを選択した場合、この値は 3 ~ 83 シャードの範囲になります。
- リードレプリカを使用してインスタンスを作成する場合は、[リードレプリカ] に目的のレプリカ数(シャードあたり)を入力します。有効な値は、リードレプリカ 1 個、リードレプリカ 1 個、リードレプリカ 2 個です。Google Cloud コンソールを使用する場合、デフォルト値は 1 リードレプリカです。
- [プライベート ネットワーキングの設定] で、目的のネットワークを選択します。Memorystore for Redis クラスタのプライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。
- 転送中の暗号化を有効にする場合は、[Transport Layer Security(TLS)を有効にする] を選択します。
- インスタンスの [クラスタ ID] を確認します。クラスタ ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。
[クラスタを作成] ボタンをクリックします。
gcloud
Memorystore for Redis Cluster インスタンスを作成するには、create
コマンドを実行します。
gcloud alpha redis clusters create INSTANCE_ID \ --region=REGION_ID \ --network=NETWORK \ --replica-count=REPLICA_COUNT \ --shard-count=SHARD_COUNT
以下を置き換えます。
INSTANCE_ID は、作成する Memorystore for Redis Cluster インスタンスの ID です。インスタンス ID は 1〜63 文字にする必要があり、小文字、数字、ハイフンのみ使用できます。先頭は英小文字に、末尾は英小文字または数字にする必要があります。
REGION_ID は、インスタンスを配置するリージョンです。
NETWORK は、インスタンスの作成に使用されるネットワークです。形式
projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID
を使用する必要があります。ここで使用するネットワーク ID は、サービス接続ポリシーで使用されるネットワーク ID と一致する必要があります。それ以外の場合、create
操作は失敗します。REPLICA_COUNT は、必要なリードレプリカ数(シャードあたり)です。指定できる値は
0
、1
、2
です。SHARD_COUNT は、インスタンス内の 13 GB シャードの数を決定します。シャード数は、クラスタデータを格納するためのメモリの合計容量を決定します。クラスタ仕様の詳細については、クラスタとシャードの仕様をご覧ください。
- シャード数は、選択したリードレプリカの数に応じて 3 ~ 250 の範囲で設定できます。
- 0 個のリードレプリカ – 最大シャード数が 250
- 1 個のリードレプリカ – 最大シャード数は 125
- 2 つのリードレプリカ – 最大シャード数は 83
- シャード数は、選択したリードレプリカの数に応じて 3 ~ 250 の範囲で設定できます。
次に例を示します。
gcloud alpha redis clusters create my-instance \ --region=us-central1 \ --network=projects/my-project-335118/global/networks/default \ --replica-count=2 \ --shard-count=8
デフォルトでは、転送中の暗号化は無効で、承認済みネットワークは default
です。
インスタンスの一覧を取得する
コンソール
インスタンスの一覧を表示するには、Google Cloud コンソールの [Memorystore for Redis Cluster] ページに移動します。
gcloud
既存の Memorystore for Redis Cluster インスタンスを表示するには、list
コマンドを実行します。
gcloud alpha redis clusters list \ --region=REGION_ID \
以下を置き換えます。
- REGION_ID はインスタンスが配置されているリージョンです。
次に例を示します。
gcloud alpha redis clusters list \ --region=us-central1 \
インスタンスの詳細情報を表示
コンソール
Google Cloud コンソールで [Memorystore for Redis Cluster] ページに移動します。
クラスタ ID をクリックします。
gcloud
インスタンスの詳細を表示するには、describe
コマンドを実行します。
gcloud alpha redis clusters describe INSTANCE_ID \ --region=REGION
以下を置き換えます。
- INSTANCE_ID は、インスタンスの ID です。
- REGION_ID はインスタンスが配置されているリージョンです。 次に例を示します。
gcloud alpha redis clusters describe my-instance \ --region=us-central1
クラスタの削除
コンソール
Google Cloud コンソールで [Memorystore for Redis Cluster] ページに移動します。
クラスタ ID をクリックします。
[削除] ボタンをクリックします。
クラスタ ID を入力します。
[削除] ボタンをクリックします。
gcloud
gcloud alpha redis clusters delete CLUSTER_ID \ --region=REGION_ID
次に例を示します。
gcloud alpha redis clusters delete my-cluster \ --region=us-central1