コマンド・ライン・インターフェース (CLI) を使用した接続

コマンド・ライン・インターフェース (CLI) から直接 Redis データベースにアクセスします。 CLIは、データベース内で作成されるデータ構造を直接操作し、監視することができる。これは、キースペースとパフォーマンスの管理とモニターや、スクリプトのインストールと変更、といった管理アクティビティーにも役立ちます。

で導入されたユーザー管理機能のために、 redli クライアントをアップデートする必要がある。 Redis. クライアントを更新せずに接続しようとすると、次のようなエラーが表示されます： (error) WRONGPASS invalid username-password pair.

接続ストリング

接続文字列は配置の [概要]ページの [エンドポイント] パネルに表示され、Cloud Databases CLI プラグインや Cloud Databases API からも取得できます。

クライアントが配置に接続するために必要な情報は、[*サービス資格情報]*ページで作成した資格情報の「CLI」セクションにあります。参照用に、接続文字列の構成要素を次の表に示します。

redis /cli接続情報
フィールド名	索引	説明
`Bin`		接続を作成するための推奨バイナリー。この場合は `redli` になります。
`Composed`		デプロイメントへの接続を確立するための構成済みのコマンド。このコマンドは、`Bin` 実行可能プログラムと `Environment` 変数設定を組み合わせ、コマンド・ライン・パラメーターとして `Arguments` を使用します。
`Environment`		環境変数として設定したキー/値のリスト。
`Arguments`	0...	Bin フィールドに示されているコマンドに引数として渡される情報
`Certificate`	Base64	アプリケーションが適切なサーバーに接続していることを確認するために使用される、サービス独自の証明書。 base64 でエンコードされています。
`Certificate`	名前	サービス専有証明書に割り当てられた名前。
`Type`		この接続情報を使用するパッケージのタイプ。この場合は `cli` です。

0... は、1 つの配列にこれらのエントリーが 1 つ以上ある可能性があることを示しています。

`redis-cli` のインストール

redis-cli は、Redis の公式にサポートされているコマンド・ライン・インターフェースです。 redis-cli を使用する場合は、追加の設定手順が必要です。

redis-cli Redis パッケージの一部として提供されるので、まずをローカルにインストールする。 Redis macOS,、 brewをインストールし、 brew install redis。 Linux では、ディストリビューションのパッケージ・マネジャーで最新の Redis パッケージを参照するか、お好みであればソースをダウンロードして自分でビルドしてください。

`redli` のインストール

redli は、オープン・ソースの Redis コマンド・ライン・クライアントです。スタンドアロンで、 redis-cliコマンドライン引数を模倣し、TLS/SSL Redis 接続のサポートを追加する。これは URI 内の rediss: プロトコルを認識し、URI 以外の接続のための --tls フラグをサポートします。これは TLS/SSL で保護された Redis にトンネルなしで接続できます。リリース・ページからダウンロードしてインストールします。

`redli` による接続

ibmcloud cdb deployment-connections コマンドは、クライアント接続の確立に関係するあらゆる処理を行います。例えば、「NewRedis」という名前のデプロイメントに接続するには、以下のコマンドを使用します。

ibmcloud cdb deployment-connections NewRedis --start

または

ibmcloud cdb cxn NewRedis -s

コマンドは admin パスワードの入力を促し、 redli コマンドラインクライアントを実行してデータベースに接続する。

Cloud Databases プラグインをインストールしていない場合は、redli コマンドを使用して Redis データベースに接続します。配置からサービス専有証明書をダウンロードして保存します。そして、「構成された」接続文字列とサービス専有証明書へのパスを与えて、 redli。

redli --uri rediss://admin:$PASSWORD@e6b2c3f8-54a6-439e-8d8a-aa6c4a78df49.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32371/0 --certfile /path/to/redis-cert.pem

redli でサポートされている接続オプションとパラメーターはこの他にもあります。詳しくは、 redli GitHub レポのドキュメントを参照。

サービス独自証明書の使用

Endpoints」 パネルまたはサービス・クレデンシャル接続情報の「 Base64 」フィールドから証明書情報をコピーする。
必要に応じて、Base64 ストリングをテキストにデコードします。
証明書をファイルに保存します (提供される名前、または独自のファイル名を使用できます)。
ドライバーまたはクライアントに証明書へのパスを提供します。

サービス独自証明書のCLIプラグインサポート

CLIプラグインを使用して、デプロイメント用にデコードされた証明書を次のようなコマンドで表示できます：

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

このコマンドは、 Base64 をテキストにデコードする。このコマンドの出力をファイルにコピーして保存し、このファイルのパスをクライアントに提供します。