OpenSearchクラスタへの接続
このトピックでは、OpenSearchを使用してOCI SearchのOpenSearchクラスタに接続するために必要な前提条件および接続の詳細について説明します。また、クラスタと同じVCNおよびサブネットのVMインスタンスを使用するいくつかの基本的な接続シナリオのステップを説明するウォークスルーも含まれています。
ここに示す情報を使用して、OpenSearchクライアントおよびカスタム検索ソリューションがクラスタからのデータの接続および取込みを可能にします。
OpenSearchによる検索では、クラスタのインスタンスにパッチを適用するか、クラスタをサイズ変更している間、クラスタの検索機能は読取り専用モードですが、メンテナンス・ウィンドウでは書込みモードは無効です。詳細は、クラスタ・パッチ適用およびサイズ変更操作を参照してください。
プライベート・エンドポイント
OpenSearchで検索すると、プライベート・エンドポイントを介してクラスタのクラスタおよびOpenSearchダッシュボードにアクセスできます。このサービスでは、クラスタのプライベート・エンドポイントに接続する2つの方法が提供されます。
- プライベートIP: プライベート・エンドポイントのプライベートIPアドレス。プライベートIPは、クラスタと同じVCNおよびサブネット内のVMインスタンスから接続する場合に使用します。VMインスタンスへのポート転送が構成されているローカル・マシンから接続するときに、プライベートIPを使用することもできます。
- APIエンドポイント: クラスタのプライベート・エンドポイントにアクセスするためにサービスによって提供される完全修飾ドメイン名(FQDN)。OpenSearchクライアント(LogStashやBeatsなど)から接続する場合は、APIエンドポイントを使用します。
詳細は、前提条件を参照してください。
プライベート・エンドポイントでは、トラフィックはインターネットを経由しません。エンドポイントには、クラスタのVCN内からのみアクセスできます。APIエンドポイントがOpenSearchクライアントにアクセスできるようにするには、外部クライアントからエンドポイントにアクセスできるようにするための構成がさらに必要です。たとえば、APIゲートウェイを使用して、パブリックIPアドレスでのアクセスを有効にできます。
前提条件
次に、クラスタへの接続に必要な前提条件のリストを示します
クラスタ接続情報
クラスタの接続情報には、クラスタとの接続および操作に使用するAPIエンドポイントとIPアドレス、およびクラスタのOpenSearchダッシュボードが含まれます。詳細は、プライベート・エンドポイントを参照してください。
すべての接続情報は、コンソールの「クラスタの詳細」ページで確認できます。
2022年9月15日より前に作成されたクラスタへの接続には、証明書をダウンロードする必要があります。これらのクラスタのAPIエンドポイントのドメインは、
oci.oracleiaas.com
です。2022年9月15日以降に作成されたクラスタへの接続には、証明書をダウンロードする追加ステップは必要ありません。これらのクラスタのAPIエンドポイントのドメインは、oci.oraclecloud.com
です。クラスタの詳細の表示
セキュリティ・規則の作成
クラスタおよびクラスタのOpenSearchダッシュボードへの接続を許可するには、クラスタVCNのセキュリティ・ルールを作成する必要があります。
クラスタからデータにアクセスできるようにするには、次のTCPトラフィックのステートフル・イングレス・セキュリティ・ルールを追加する必要があります。
- ソース0.0.0.0/0および任意のソース・ポートからの宛先ポート9200のOpenSearch。
- OpenSearchソース0.0.0.0/0および任意のソース・ポートからの宛先ポート5601のダッシュボード。
これらのルールを使用してセキュリティ・リストを作成することも、クラスタのVCNのデフォルト・セキュリティ・リストに追加することもできます。
オプション1: セキュリティ・リストの作成
オプション2: デフォルト・セキュリティ・リストへのルールの追加
VMインスタンスの作成(オプション)
接続の前提条件の完了後、オプションでVMインスタンスを作成して、いくつかの基本的な接続テストを実行し、前提条件が正しく構成されていること、および正しい接続情報があることを確認できます。VMインスタンスは、クラスタを作成したVCNの同じサブネットに作成します。インスタンスの作成方法については、次のいずれかのトピックを参照してください。
インスタンスが作成されたら、ローカル・マシンからインスタンスに接続します。詳細は、次を参照してください:
クラスタへの接続をテストします
ローカル・マシンからVMインスタンスに接続したら、次のいずれかのコマンドを実行して接続をテストします。
APIエンドポイント・ドメインがoci.oraclecloud.com
(2022年9月15日以降に作成)であるクラスタの場合:
curl https://<cluster_API_endpoint>:9200
このコマンドで渡されるURLは、「クラスタの詳細」ページの「APIエンドポイント」フィールドに指定された値です。前提条件を参照してください。
エンドポイントへの接続が成功すると、次のようなレスポンスが返されます。
{
"name" : "opensearch-master-0",
"cluster_name" : "<cluster_name>",
"cluster_uuid" : "<cluster_UUID>",
"version" : {
"distribution" : "opensearch",
"number" : "1.2.4-SNAPSHOT",
"build_type" : "tar",
"build_hash" : "<build_hash>",
"build_date" : "2022-02-08T16:44:39.596468Z",
"build_snapshot" : true,
"lucene_version" : "8.10.1",
"minimum_wire_compatibility_version" : "6.8.0",
"minimum_index_compatibility_version" : "6.0.0-beta1"
},
"tagline" : "The OpenSearch Project: https://opensearch.org/"
}
クラスタへのデータのプッシュやクラスタへの検索問合せの送信など、テストできるその他のコマンドについては、OCI Search Service with OpenSearchを使用したデータの検索およびビジュアル化チュートリアルを参照してください。
クラスタのOpenSearchダッシュボードへの接続のテスト
OpenSearchダッシュボードに接続するようにポート転送を構成するには、次のステップに従います。
OpenSearchリソース
OpenSearchで検索すると、オープン・ソースのOpenSearch API、OpenSearchダッシュボード、プラグインおよびその他のOpenSearch機能がサポートされます。OpenSearchの操作の詳細は、次の外部リソースを参照してください。