Redis コマンドラインインターフェイス (redis-cli) を使用して、ApsaraDB for Redis に接続できます。

redis-cli の概要

redis-cli は、Redis ソフトウェアディストリビューションに含まれるコマンドラインツールです。 redis-cli を使用すると、ApsaraDB for Redis インスタンスに接続し、インスタンスにコマンドを送信してデータを管理できます。

redis-cli を使用すると、Linux 上で動作している ECS インスタンスから Alibaba Cloud イントラネット経由で、またはローカルホストからインターネット経由で ApsaraDB for Redis インスタンスに接続できます。 Alibaba Cloud イントラネットを経由して ApsaraDB for Redis にアクセスする方が、セキュリティとパフォーマンスが高くなります。

インターネット経由でローカルホストから ApsaraDB for Redis インスタンスにアクセスするには、「インターネットの使用」の手順に従ってインターネットエンドポイントを申請する必要があります。 その後、「接続方法」の手順に従ってインスタンスに接続します。

redis-cli のインストール

Linux に redis-cli の入った Redis ソフトウェアディストリビューションをインストールします。 詳細については、『Redis community』をご参照ください。

前提条件

Alibaba Cloud イントラネット経由での接続

  • ECS インスタンスと ApsaraDB for Redis インスタンスの両方のネットワークタイプが VPC である場合、2 つのインスタンスがリージョンの同じ VPC に存在する必要があります。
  • ECS インスタンスと ApsaraDB for Redis インスタンスの両方のネットワークタイプがクラシックネットワークである場合、2 つのインスタンスが同じリージョンに存在する必要があります。
  • ECS インスタンスのプライベート IP アドレスを ApsaraDB for Redis インスタンスのホワイトリストに追加していること。
  • ECS インスタンスに Redis ソフトウェアディストリビューションをインストールしていること。

インターネット経由での接続

  • ApsaraDB for Redis インスタンスにインターネットエンドポイントが存在すること。 詳細については、「インターネットの使用」をご参照ください。
  • ローカルホストのインターネット IP アドレスを ApsaraDB for Redis インスタンスのホワイトリストに追加していること。
  • ローカルホストのオペレーティングシステムが Linux である必要があります。
  • ローカルホストに Redis ソフトウェアディストリビューションをインストールしていること。

注意事項

  • プライベートエンドポイントから ApsaraDB for Redis インスタンスにアクセスする場合、VPC パスワード不要アクセス機能を有効にすると、パスワードなしでインスタンスにアクセスできます。
  • インターネットエンドポイントから ApsaraDB for Redis インスタンスにアクセスする場合、VPC パスワード不要アクセス機能を有効にしても、インスタンスのアクセスにはパスワードが必要です。
  • ApsaraDB for Redis インスタンスに接続するときに発生する可能性のあるエラーを修正する方法の詳細については、「ApsaraDB for Redis の接続問題のトラブルシューティング」をご参照ください。

接続方法

次のコマンドを使用して、ApsaraDB for Redis インスタンスに接続します。

redis-cli -h <host> -p <port> -a <password>
表 1. パラメーター
名称 説明
-h

ApsaraDB for Redis インスタンスのエンドポイントを指定します。

-p

ApsaraDB for Redis インスタンスのサービスポートを指定します。

  • 既定のポート番号は 6379 です。 このポート番号は変更できません。
-a ApsaraDB for Redis インスタンスのパスワードを設定します。 このパラメーターを省略してパスワードを平文で表示しないようにすると、セキュリティを強化できます。 上記のコマンドの実行後に、auth <password> を入力して認証を完了します。 下図は一例です。
図 1. コマンド例