ステップ 1: サブネットグループの作成ステップ 2: クラスターを作成するステップ 3: クラスターへのアクセスの許可ステップ 4: クラスターのノードに接続する

独自の ElastiCache Redis OSS クラスターの設計

以下は、独自の ElastiCache Redis OSS クラスターを設計するために実行する必要がある 1 回限りのアクションです。

ElastiCache のセットアップの詳細については、「ElastiCache のセットアップ」を参照してください。

トピック

ステップ 1: サブネットグループの作成
ステップ 2: クラスターを作成する
ステップ 3: クラスターへのアクセスの許可
ステップ 4: クラスターのノードに接続する

ステップ 1: サブネットグループの作成

クラスターを作成する前に、まずサブネットグループを作成します。キャッシュサブネットグループは、VPC 内でキャッシュクラスターとして指定できるサブネットの集合です。VPC でキャッシュクラスターを起動する場合は、キャッシュサブネットグループを選択する必要があります。次に、ElastiCache ではそのキャッシュサブネットグループを使用して、サブネット内の IP アドレスをクラスター内の各キャッシュノードに割り当てます。

新しいサブネットグループを作成する場合は、使用可能な IP アドレス数に注意してください。サブネットの空き IP アドレス数が非常に少ない場合は、クラスターに追加できるノード数が制約される可能性があります。この問題を解決するために、クラスターのアベイラビリティーゾーンで十分な数の IP アドレスを使用できるように、サブネットグループに 1 つ以上のサブネットを割り当てることができます。その後で、クラスターにノードを追加できます。

以下の手順では、mysubnetgroup (コンソール)および AWS CLIというサブネットグループを作成する方法を示します。

次の手順では、サブネットグループ (コンソール) を作成する方法を示します。

サブネットグループ (コンソール) を作成するには

AWS マネジメントコンソールにサインインし、ElastiCache コンソールを https://console.aws.amazon.com/elasticache/://https://https://https://https://https://https://https://https://https://https://https://https://https://https://https
ナビゲーションリストで [ Subnet Groups] を選択します。
Create Subnet Group を選択します。
Create Subnet Group ウィザードで、次の操作を行います。すべての設定が正しいことを確認したら、[Yes, Create] を選択します。
1. Name ボックスにサブネットグループの名前を入力します。
2. Description ボックスにサブネットグループの説明を入力します。
3. [VPC ID] ボックスで、作成した Amazon VPC を選択します。
4. [Availability Zone] および [Subnet ID] リストで、プライベートサブネットのアベイラビリティーゾーンまたは [Local Zone] と ID を選択し、[Add] を選択します。
表示された確認メッセージで、Close を選択します。

ElastiCache コンソールの [サブネットグループ] のリストに新しいサブネットグループが表示されます。ウィンドウの下部で、サブネットグループを選択して、ウィンドウの下部で詳細 (このグループに関連付けられているすべてのサブネットなど) を確認します。

コマンドプロンプトで、create-cache-subnet-group コマンドを使用してサブネットグループを作成します。

Linux、macOS、Unix の場合:


aws elasticache create-cache-subnet-group \
    --cache-subnet-group-name mysubnetgroup \
    --cache-subnet-group-description "Testing" \
    --subnet-ids subnet-53df9c3a

Windows の場合:


aws elasticache create-cache-subnet-group ^
    --cache-subnet-group-name mysubnetgroup ^
    --cache-subnet-group-description "Testing" ^
    --subnet-ids subnet-53df9c3a

このコマンドでは、次のような出力が生成されます。


{
    "CacheSubnetGroup": {
        "VpcId": "vpc-37c3cd17", 
        "CacheSubnetGroupDescription": "Testing", 
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-53df9c3a", 
                "SubnetAvailabilityZone": {
                    "Name": "us-west-2a"
                }
            }
        ], 
        "CacheSubnetGroupName": "mysubnetgroup"
    }
}

詳細については、 AWS CLI 「」トピックを参照してくださいcreate-cache-subnet-group。

ステップ 2: クラスターを作成する

実稼働用のクラスターを作成する前に、ビジネスニーズに合わせてクラスターをどのように設定するかを検討する必要があります。これらの問題については、ElastiCache でクラスターを準備するセクションで対応します。この「使用開始」の演習では、クラスターモードを無効にしてクラスターを作成し、適用するデフォルトの設定値を受け入れます。

作成するクラスターはライブとなりますが、サンドボックスで実行されるわけではありません。インスタンスを削除するまで、ElastiCache の標準使用料が発生します。ここで説明する演習を一気に完了し、終了時にクラスターを削除すれば、使用料合計はごくわずかです (通常 1 ドル未満です)。ElastiCache の使用料の詳細については、「Amazon ElastiCache」を参照してください。

クラスターは、Amazon VPC サービスに基づいて Virtual Private Cloud (VPC) で起動されます

Redis OSS (クラスターモードが無効) クラスターの作成 (コンソール)

ElastiCache コンソールを使用して Redis OSS (クラスターモードが無効) クラスターを作成するには

にサインイン AWS Management Console し、Amazon ElastiCache コンソールを https://console.aws.amazon.com/elasticache/://https://https://https://https://https://https://https://https://https://https://https://https://https://
右上隅のリストから、このクラスターを起動する AWS リージョンを選択します。
ナビゲーションペインで、[Get started] (開始) を選択します。
[VPC の作成] を選択し、「Virtual Private Cloud (VPC) の作成」のステップに従います。
ElastiCache ダッシュボードページで、[Valkey キャッシュ] または [Redis OSS キャッシュ] を選択します。この演習では、[Redis OSS キャッシュ] を選択してから、[Redis OSS キャッシュを作成] を選択します。
[クラスター設定] で、以下を実行します。
1. [Configure and create a new cluster] (新しいクラスターを設定および作成) を選択します。
2. [Cluster mode] (クラスターモード) で、[Disabled] (無効) を選択します。
3. [Cluster info] (クラスター情報) で、[Name] (名前) の値を入力します。
4. (オプション) [Description] (説明) の値を入力します。
[Location] (場所):
AWS Cloud
[AWS Cloud] (AWS クラウド) の場合、[Multi-AZ] (マルチ AZ) および [Auto-failover] (自動フェイルオーバー) のデフォルト設定を受け入れることをお勧めします。詳細については、「マルチ AZ を使用した ElastiCache for Redis OSS のダウンタイムの最小化」を参照してください。

[Cluster settings] (クラスター設定)

[Engine version] (エンジンバージョン) で、使用可能なバージョンを選択します。

[Port] (ポート) で、デフォルトポート 6379 を使用します。異なるポートを使用する理由がある場合は、そのポート番号を入力します。
[パラメータグループ] で、パラメータグループを選択するか、新しいパラメータグループを作成します。パラメータグループはクラスターのランタイムパラメータを制御します。パラメータグループの詳細については、「Valkey および Redis OSS パラメータ」および「ElastiCache パラメータグループを作成する」を参照してください。

注記
パラメータグループを選択してエンジン設定値を設定すると、そのパラメータグループが Global Datastore 内のすべてのクラスターに適用されます。[パラメータグループ] ページの yes/no [グローバル] 属性は、パラメータグループがグローバルデータストアの一部であるかどうかを示します。

[ノードタイプ] で、下向き矢印 ( ) を選択します。[ノードタイプの変更] ダイアログボックスで、必要なノードタイプの [インスタンスファミリー] の値を選択します。次に、このクラスターで使用するノードタイプを選択し、[保存] を選択します。

詳細については、「ノードサイズの選択」を参照してください。

r6gd ノードタイプを選択すると、データ階層化が自動的に有効になります。詳細については、「ElastiCache のデータ階層化」を参照してください。

[Number of replicas] (レプリケーション数) で、必要なリードレプリカの数を選択します。マルチ AZ を有効にした場合、数値は 1～5 の間である必要があります。

[Connectivity] (接続) で

[Network type] (ネットワークタイプ) で、このクラスターがサポートする IP バージョンを選択します。
[Subnet groups] (サブネットグループ) で、このクラスターに適用するサブネットを選択します。ElastiCache はそのキャッシュサブネットグループを使用して、そのサブネット内でノードに関連付けるサブネットおよび IP アドレスを選択します。ElastiCache クラスターでは、デュアルスタックモードで動作するには IPv4 アドレスと IPv6 アドレスの両方が割り当てられたデュアルスタックサブネットが必要であり、IPv6 専用として動作するには IPv6 専用サブネットが必要です。

新しいサブネットグループを作成するときは、そのサブネットグループが属する VPC ID を入力します。

詳細については、以下を参照してください。

ElastiCache でネットワークタイプを選択する.
VPC にサブネットを作成します。

ElastiCache での Local Zones の使用である場合は、ローカルゾーンにあるサブネットを作成または選択する必要があります。

詳細については、「サブネットおよびサブネットグループ」を参照してください。

[Availability zone placements] (アベイラビリティーゾーンの配置) には 2 つのオプションがあります。

[指定なし] – ElastiCache がアベイラビリティーゾーンを選択します。

[アベイラビリティーゾーンの指定] – 各クラスターに対するアベイラビリティーゾーンを指定します。

アベイラビリティーゾーンの指定を選択した場合、クラスターのシャードごとにリストからアベイラビリティーゾーンを選択します。

詳細については、「ElastiCache のリージョンとアベイラビリティーゾーンの選択」を参照してください。

[Next] (次へ) を選択します。
[Redis OSS の詳細設定] の下

[Security] (セキュリティ):

データを暗号化するには、次のオプションがあります。

保管時の暗号化 – ディスクに保存されているデータの暗号化を有効にします。詳細については、「保管時の暗号化」を参照してください。

注記
カスタマーマネージド KMS AWS キーを選択し、そのキーを選択することで、別の暗号化キーを指定できます。詳細については、「AWS KMS のカスタマー管理の CMK の使用」を参照してください。
[転送中の暗号化] – 転送中のデータの暗号化を有効にします。詳細については、「転送中の暗号化」を参照してください。Redis OSS 用の ElastiCache エンジンバージョン 6.0 以降では、転送中の暗号化を有効にすると、次のいずれかのアクセスコントロールオプションを指定するように求められます。

アクセスコントロールなし — これがデフォルトの設定です。これは、クラスターへのユーザーアクセスに制限がないことを示します。
[ユーザーグループのアクセスコントロールリスト] — クラスターにアクセスできるユーザーのセットが定義されているユーザーグループを選択します。詳細については、「コンソールおよび CLI を使用したユーザーグループの管理」を参照してください。
[認証デフォルトユーザー] – Valkey および Redis OSS サーバーの認証メカニズム。詳細については、「AUTH」を参照してください。

[認証] – Redis OSS サーバーの認証メカニズム。詳細については、「AUTH」を参照してください。

注記
3.2.6 以降の Redis OSS バージョン (バージョン 3.2.10 を除く) では、[Redis OSS 認証] のみがオプションとなります。

セキュリティグループ で、このクラスターに必要なセキュリティグループを選択します。セキュリティグループは、クラスターへのネットワークアクセスを制御するためのファイアウォールとして機能します。VPC のデフォルトのセキュリティグループを使用するか、新しいセキュリティグループを作成できます。

VPC セキュリティグループの詳細については、Amazon VPC ユーザーガイドの「VPC のセキュリティグループ」を参照してください。

自動バックアップを定期的にスケジュールする場合は、[自動バックアップの有効化] を選択し、自動バックアップを保持して自動的に削除するまでの日数を入力します。自動バックアップを定期的にスケジュールしない場合は、[自動バックアップを有効化] チェックボックスをオフにします。いずれの場合も、常に手動バックアップを作成するオプションがあります。

バックアップと復元の詳細については、「スナップショットおよび復元」を参照してください。

(オプション) メンテナンスウィンドウを指定します。[メンテナンスウィンドウ] は、ElastiCache がクラスターのシステムメンテナンスを毎週スケジュールする時間の長さ (通常は 1 時間単位) です。ElastiCache がメンテナンスの日時を選択することを許可するか ([No preference] (指定なし))、自分で日時と期間を選択できます ([Specify maintenance window] (メンテナンスウィンドウを指定))。メンテナンスウィンドウを指定 を選択した場合は、リストからメンテナンス期間の Start day、開始時間および期間を選択します。すべての時刻は協定世界時 (UCT) です。

詳細については、「ElastiCache クラスターメンテナンスの管理」を参照してください。

(オプション) [ログ]:

[ログの形式] の下で、[テキスト] または [JSON] を選択します。
[送信先のタイプ] の下で、[CloudWatch Logs] または [Kinesis Firehose] を選択します。
[ログの送信先] の下で、[新規作成] を選択して CloudWatch Logs ロググループ名または Firehose ストリーム名を入力するか、[既存の選択] を選択してから CloudWatch Logs ロググループ名または Firehose ストリーム名を選択します。

[Tags] (タグ) で、クラスターと他の ElastiCache リソースを管理しやすくするために、タグ形式で各リソースに独自のメタデータを割り当てることができます。詳細については、「ElastiCache リソースのタグ付け」を参照してください。
[次へ] をクリックします。

すべてのエントリと選択を確認し、必要な修正を行います。準備が完了したら、[Create] (作成) を選択します。
On premises
[On premises] (オンプレミス) では、[Auto-failover] (自動フェイルオーバー) を有効のままにしておくことをお勧めします。詳細については、「マルチ AZ を使用した ElastiCache for Redis OSS のダウンタイムの最小化」を参照してください。

クラスターの作成を完了するには、「Outposts の使用」の手順に従います。

クラスターのステータスが [available] になり次第、Amazon EC2 にアクセス権を付与して接続し、使用を開始できます。詳細については、「ステップ 3. クラスターへのアクセスを許可する」および「ステップ 4. クラスターのノードに接続する」を参照してください。

重要

クラスターが使用可能になった後、クラスターがアクティブである間は (実際に使用していない場合でも)、時間に応じた料金が発生します。このクラスターに対する課金を中止するには、クラスターを削除する必要があります。「ElastiCache でのクラスターの削除」を参照してください。

例

次の CLI コードでは、レプリカのない Redis OSS (クラスターモードが無効) キャッシュクラスターを作成します。

Linux、macOS、Unix の場合:


aws elasticache create-cache-cluster \
--cache-cluster-id my-cluster \
--cache-node-type cache.r4.large \
--engine redis \
--num-cache-nodes 1 \
--snapshot-arns arn:aws:s3:::my_bucket/snapshot.rdb

Windows の場合:


aws elasticache create-cache-cluster ^
--cache-cluster-id my-cluster ^
--cache-node-type cache.r4.large ^
--engine redis ^
--num-cache-nodes 1 ^
--snapshot-arns arn:aws:s3:::my_bucket/snapshot.rdb

有効になっているクラスターモードを使用するには、以下のトピックを参照してください。

コンソールを使用するには、「Valkey または Redis OSS (クラスターモードが有効) クラスターの作成 (コンソール)」を参照してください。
を使用するには AWS CLI、「」を参照してくださいValkey または Redis OSS (クラスターモードが有効) クラスターの作成 (AWS CLI)。

ステップ 3: クラスターへのアクセスの許可

このセクションでは、Amazon EC2 インスタンスの起動と接続に慣れていることを前提としています。詳細については、「Amazon EC2 入門ガイド」を参照してください。

すべての ElastiCache クラスターは Amazon EC2 インスタンスからアクセスするように設計されています。最も一般的なシナリオは、同じ Amazon Virtual Private Cloud (Amazon VPC) 内の Amazon EC2 インスタンスから ElastiCache クラスターにアクセスすることであり、それがこの演習でのケースとなります。

デフォルトでは、クラスターへのネットワークアクセスは、クラスターの作成に使用されたアカウントに制限されます。EC2 インスタンスからクラスターに接続するには、EC2 インスタンスにクラスターへのアクセスを許可する必要があります。必要なステップはクラスターを EC2-VPC で起動したか、EC2-Classic で起動したかによって異なります。

最も一般的ユースケースは、EC2 インスタンスにデプロイされたアプリケーションが同じ VPC のクラスターに接続する必要がある場合です。同じ VPC 内の EC2 インスタンスとクラスター間のアクセスを管理する方法として最も簡単なのは、次の方法です。

クラスターの VPC セキュリティグループを作成します。このセキュリティグループは、クラスターインスタンスへのアクセスを制限するのに使用できます。例えば、クラスターを作成したときに割り当てたポートと、クラスターにアクセスするのに使用する IP アドレスを使用して TCP へのアクセスを許可する、このセキュリティグループのカスタムルールを作成できます。

Redis OSS クラスターとレプリケーショングループのデフォルトのポートは 6379 です。

重要
Amazon ElastiCache セキュリティグループは、Amazon Virtual Private Cloud (VPC) 環境で実行されていないクラスターのみに適用されます。Amazon Virtual Private Cloud で実行している場合、[セキュリティグループ ] はコンソールのナビゲーションペインでは使用できません。
ElastiCache ノードを Amazon VPC で実行している場合は、Amazon VPC セキュリティグループでクラスターへのアクセスを制御します。これは、ElastiCache セキュリティグループとは異なります。Amazon VPC で ElastiCache を使用する方法については、「Amazon VPC と ElastiCache のセキュリティ」を参照してください。
EC2 インスタンス (ウェブサーバーとアプリケーションサーバー) 用の VPC セキュリティグループを作成します。このセキュリティグループは、必要に応じて VPC のルーティングテーブルを介してインターネットから EC2 インスタンスへのアクセスを許可できます。例えば、ポート 22 経由で EC2 インスタンスへの TCP アクセスを許可するルールをこのセキュリティグループに設定できます。
EC2 インスタンス用に作成したセキュリティグループからの接続を許可するクラスターのセキュリティグループで、カスタムルールを作成します。これは、セキュリティグループのメンバーにクラスターへのアクセスを許可します。

注記

ElastiCache での Local Zones の使用の使用を予定している場合、これが有効になっていることを確認します。そのローカルゾーンにサブネットグループを作成すると、VPC はそのローカルゾーンに拡張され、VPC はそのサブネットを他のアベイラビリティーゾーンのサブネットとして扱います。関連するすべてのゲートウェイとルートテーブルが自動的に調整されます。

他のセキュリティグループからの接続を許可する VPC セキュリティグループでルールを作成するには

AWS マネジメントコンソールにサインインし、「https://https://console.aws.amazon.com/vpc.com で Amazon VPC コンソールを開きます。
ナビゲーションペインで、[Security Groups] を選択してください。
クラスターインスタンスに使用するセキュリティグループを選択または作成します。インバウンドルール で、インバウンドルールの編集 を選択し、ルールの追加 を選択します。このセキュリティグループは、他のセキュリティグループのメンバーへのアクセスを許可します。
Type で Custom TCP Rule を選択します。
1. Port Range ポートには、クラスター作成時に使用したポートを指定します。
  
  Redis OSS クラスターとレプリケーショングループのデフォルトのポートは 6379 です。
2. ソース ボックスに、セキュリティグループの ID の入力を開始します。リストから、Amazon EC2 インスタンスに使用するセキュリティグループを選択します。
終了したら、保存を選択します。

アクセスを有効にしたので、次のセクションで説明するように、ノードに接続する準備が整いました。

別の Amazon VPC、別の AWS リージョン、または企業ネットワークから ElastiCache クラスターにアクセスする方法については、以下を参照してください。

ステップ 4: クラスターのノードに接続する

続行する前に、「ステップ 3: クラスターへのアクセスの許可」を完了します。

このセクションでは、Amazon EC2 インスタンスが作成済みであり、このインスタンスに接続できることを前提としています。これを行う手順については、「Amazon EC2 入門ガイド」を参照してください。

Amazon EC2 インスタンスは、許可されている場合にのみクラスターノードに接続できます。

ノードのエンドポイントを見つける

クラスターが利用可能な状態であり、クラスターへのアクセスを許可されている場合は、Amazon EC2 インスタンスにログインしてクラスターに接続できます。そのためには、最初にエンドポイントを確認する必要があります。

Valkey または Redis OSS (クラスターモードが無効) クラスターのエンドポイントを検索する (コンソール)

Redis OSS (クラスターモードが無効) クラスターに 1 つのみのノードがある場合、ノードのエンドポイントは読み取りと書き込みの両方に使用されます。クラスターに複数のノードがある場合は、プライマリエンドポイント、リーダーエンドポイント、ノードエンドポイントの 3 種類のエンドポイントがあります。

プライマリエンドポイントは、常にクラスターのプライマリノードに解決される DNS 名です。プライマリエンドポイントは、リードレプリカのプライマリロールへの昇格など、クラスターに対する変更の影響を受けません。書き込みアクティビティの場合、アプリケーションをプライマリエンドポイントに接続することをお勧めします。

リーダーエンドポイントは、エンドポイントへの着信接続を ElastiCache for Redis OSS クラスター内のすべてのリードレプリカ間で均等に分割します。アプリケーションがいつ接続を作成するか、アプリケーションが接続をどのように (再) 利用するかなどの追加要因によって、トラフィックの分散が決定されます。レプリカが追加または削除されても、読み込みエンドポイントはリアルタイムでクラスターの変更に対応します。ElastiCache for Redis OSS クラスターの複数のリードレプリカを異なるアベイラ AWS ビリティーゾーン (AZ) に配置して、リーダーエンドポイントの高可用性を確保できます。

注記

リーダーエンドポイントはロードバランサーではありません。これは、ラウンドロビン方式でレプリカノードの 1 つの IP アドレスに解決される DNS レコードです。

読み取りアクティビティの場合、アプリケーションはクラスター内のいずれのノードにも接続できます。プライマリエンドポイントとは異なり、ノードエンドポイントは特定のエンドポイントに解決されます。レプリカの追加または削除など、クラスターに変更を加えた場合は、アプリケーションでノードエンドポイントを更新する必要があります。

Redis OSS (クラスターモードが無効) クラスターのエンドポイントを検索するには

にサインイン AWS Management Console し、ElastiCache コンソールを https://console.aws.amazon.com/elasticache/://https://https://https://https://https://https://https://https://https://https://https://https://http
ナビゲーションペインで、[Redis OSS キャッシュ] を選択します。

クラスター画面には、既存の Valkey または Redis OSS サーバーレスキャッシュ、Redis OSS (クラスターモードが無効) クラスターと Redis OSS (クラスターモードが有効) クラスターを含むリストが表示されます。Redis OSS (クラスターモードが無効) クラスターの作成 (コンソール) のセクションで作成したものを選択します。
クラスターのプライマリエンドポイントやリーダーエンドポイントを検索するには、クラスターの名前 (ラジオボタンではない) を選択します。

Redis OSS (クラスターモードが無効) クラスターのプライマリエンドポイントとリーダーエンドポイント

クラスターに 1 つのみのノードがある場合、プライマリエンドポイントはないため、次のステップに進むことができます。
Redis OSS (クラスターモードが無効) クラスターにレプリカノードがある場合は、クラスターの名前を選択してから [ノード] タブを選択して、クラスターのレプリカノードエンドポイントを検索できます。

ノードの画面では、クラスター内のプライマリとレプリカの各ノードがそのエンドポイントと共に表示されます。

Redis OSS (クラスターモードが無効) クラスターのノードエンドポイント
エンドポイントをクリップボードにコピーするには:
1. 一度に 1 つのみ、コピーするエンドポイントを見つけます。
2. エンドポイントアドレスのすぐ前にあるコピーアイコンを選択します。
エンドポイントがクリップボードにコピーされます。エンドポイントを使用してノードに接続する方法については、「ノードに接続する」を参照してください。

Redis OSS (クラスターモードが無効) プライマリエンドポイントは以下のようになります。転送時の暗号化が有効かどうかによって違いがあります。

転送時の暗号化が無効


clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port
			
redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379

転送時の暗号化が有効


master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port

master.ncit.ameaqx.use1.cache.amazonaws.com:6379

エンドポイントを見つける方法の詳細については、実行中のエンジンとクラスターの該当するトピックを参照してください。

ElastiCache での接続エンドポイントの検索
Valkey または Redis OSS (クラスターモードが有効) クラスターのエンドポイントを検索する (コンソール)—クラスターの設定エンドポイントが必要です。
エンドポイントの検索 (AWS CLI)
エンドポイントの検索 (ElastiCache API)

これで、必要なエンドポイントがわかったので、EC2 インスタンスにログインし、クラスターまたはレプリケーショングループに接続できます。次の例では、valkey-cli ユーティリティを使用して、クラスターに接続します。valkey-cli の最新バージョンでは、暗号化/認証が有効なクラスターを接続するための SSL/TLS もサポートしています。

次の例では、Amazon Linux および Amazon Linux 2 を実行している Amazon EC2 インスタンスを使用しています。他の Linux ディストリビューションでの valkey-cli のインストールとコンパイルの詳細については、ご使用のオペレーティングシステムのドキュメントを参照してください。

注記

このプロセスでは、計画外の使用のみの、valkey-cli ユーティリティを使用した接続のテストをカバーしています。サポートされるクライアントのリストについては、「Valkey ドキュメント」を参照してください。ElastiCache で AWS SDKs「」を参照してくださいチュートリアル: Python と ElastiCache の開始方法。

クラスターモードが無効な非暗号化クラスターへの接続

次のコマンドを実行してクラスターに接続し、[primary-endpoint] と [ポート番号] をクラスターのエンドポイントとポート番号に置き換えます。(Valkey および Redis OSS のデフォルトポートは 6379 です。)
```
src/valkey-cli -h primary-endpoint -p port number
```
次のようなコマンドプロンプトが表示されます。
```
primary-endpoint:port number
```
これで Valkey および Redis OSS コマンドを実行できるようになりました。
```
set x Hello
OK

get x
"Hello"
```

クラスターモードが有効の非暗号化クラスターへの接続

次のコマンドを実行してクラスターに接続し、[configuration-endpoint] と [ポート番号] をクラスターのエンドポイントとポート番号に置き換えます。(Valkey および Redis OSS のデフォルトポートは 6379 です。)
```
src/valkey-cli -h configuration-endpoint -c -p port number
```
注記
上記のコマンドで、-c オプションを指定すると、-ASK および -MOVED リダイレクトが続くクラスターモードが有効になります。

次のようなコマンドプロンプトが表示されます。
```
configuration-endpoint:port number
```
これで Valkey および Redis OSS コマンドを実行できるようになりました。リダイレクトは、-c オプションを使用して有効にしたために発生します。リダイレクトが有効でない場合、このコマンドは MOVED エラーを返します。MOVED エラーの詳細については、「cluster specification」を参照してください。
```
set x Hi
-> Redirected to slot [16287] located at 172.31.28.122:6379
OK
set y Hello
OK
get y
"Hello"
set z Bye
-> Redirected to slot [8157] located at 172.31.9.201:6379
OK
get z
"Bye"
get x
-> Redirected to slot [16287] located at 172.31.28.122:6379
"Hi"
```

暗号化/認証が有効なクラスターへの接続

デフォルトでは、valkey-cli は Valkey および Redis OSS への接続時に暗号化されていない TCP 接続を使用します。オプション BUILD_TLS=yes により、前の「コマンドラインアクセスをダウンロードしてセットアップする」セクションで示されたように、valkey-cli コンパイル時に SSL/TLS を有効にします。AUTH の有効化はオプションです。ただし、AUTH を有効にするために、転送時の暗号化を有効にする必要があります。ElastiCache の暗号化と認証の詳細については、「ElastiCache の転送時の暗号化 (TLS)」を参照してください。

注記

valkey-cli でオプション --tls を使用して、クラスターモードが有効および無効の両方の暗号化されたクラスターに接続できます。クラスターに AUTH トークンが設定されている場合は、オプション -a を使用して AUTH パスワードを指定します。

以下の例では、[cluster-endpoint] と [ポート番号] をクラスターのエンドポイントとポート番号に置き換えてください。(Redis OSS のデフォルトポートは 6379 です。)

クラスターモードが無効の暗号化されたクラスターに接続する

次の例では、暗号化および認証が有効のクラスターに接続します。


src/valkey-cli -h cluster-endpoint --tls -a your-password -p port number

次の例では、暗号化のみが有効なクラスターに接続します。


src/valkey-cli -h cluster-endpoint --tls -p port number

クラスターモードが有効の暗号化されたクラスターへの接続

次の例では、暗号化および認証が有効のクラスターに接続します。


src/valkey-cli -c -h cluster-endpoint --tls -a your-password -p port number

次の例では、暗号化のみが有効なクラスターに接続します。


src/valkey-cli -c -h cluster-endpoint --tls -p port number

クラスターに接続した後、暗号化されていないクラスターに対して、前の例に示されているように Valkey または Redis OSS コマンドを実行できます。

valkey-cli または Redis-cli の代替

クラスターがクラスターモード有効ではなく、valkey-cli または redis-cli コンパイルを行わずに、短いテストのためにクラスターに接続する必要がある場合、telnet または openssl を使用できます。以下のコマンド例では、[cluster-endpoint] と [ポート番号] をクラスターのエンドポイントとポート番号に置き換えてください。(Redis OSS のデフォルトポートは 6379 です。)

次の例では、暗号化および/または認証が有効のクラスターモードが無効のクラスターに接続します。


openssl s_client -connect cluster-endpoint:port number

クラスターにパスワードが設定されている場合は、まずクラスターに接続します。接続後、次のコマンドを使用してクラスターを認証してから、Enter キーを押します。次の例では、[your-password] をクラスターのパスワードに置き換えます。


Auth your-password

次の例では、暗号化または認証が有効ではないクラスターモードが無効のクラスターに接続します。


telnet cluster-endpoint port number

Valkey または Redis OSS CLI を使用して、EC2 Windows インスタンスからクラスターに接続するには、valkey-cli パッケージをダウンロードし、valkey-cli.exe を使用して EC2 Windows インスタンスから Valkey または Redis OSS クラスターに接続する必要があります。

次の例では、valkey-cli ユーティリティを使用して、暗号化が有効ではなく、Valkey または Redis OSS を実行しているクラスターに接続します。Valkey と使用可能なコマンドの詳細については、Valkey ウェブサイトの「Valkey commands」を参照してください。

valkey-cli を使用して、暗号化が有効になっていない Valkey または Redis OSS クラスターに接続するには

選択した接続ユーティリティを使用して、Amazon EC2 インスタンスに接続します。Amazon EC2 インスタンスに接続する方法については、「Amazon EC2 入門ガイド」を参照してください。
リンク https://github.com/microsoftarchive/redis/releases/download/win-3.0.504/Redis-x64-3.0.504.zip をコピーしてインターネットブラウザに貼り付け、GitHub の利用可能なリリース (https://github.com/microsoftarchive/redis/releases/tag/win-3.0.504) から Redis OSS クライアントの zip ファイルをダウンロードします。

zip ファイルを目的のフォルダ/パスに展開します。

コマンドプロンプトを開き、Valkey ディレクトリに移動して、コマンド c:\Valkey>valkey-cli -h Valkey_Cluster_Endpoint -p 6379 を実行します。

以下に例を示します。
```
c:\Valkey>valkey-cli -h cmd.xxxxxxx.ng.0001.usw2.cache.amazonaws.com -p 6379
```

Valkey または Redis OSS コマンドを実行します。

これで、クラスターに接続され、以下のような Valkey または Redis OSS コマンドを実行できます。


set a "hello"          // Set key "a" with a string value and no expiration
OK
get a                  // Get value for key "a"
"hello"
get b                  // Get value for key "b" results in miss
(nil)				
set b "Good-bye" EX 5  // Set key "b" with a string value and a 5 second expiration
"Good-bye"
get b                  // Get value for key "b"
"Good-bye"
                       // wait >= 5 seconds
get b
(nil)                  // key has expired, nothing returned
quit                   // Exit from valkey-cli

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

独自の ElastiCache (Valkey) クラスターの設計

クラスターの削除