メニュー
Amazon Elasticsearch Service
開発者ガイド (API バージョン 2015-01-01)

ステップ 1: Amazon ES ドメインを作成する

重要

このプロセスは、簡潔なチュートリアルでテストドメインを設定します。本番稼働用ドメインの作成には使用できません。同じプロセスの包括的なバージョンについては、「Amazon Elasticsearch Service ドメインの作成と設定」を参照してください。

Amazon Elasticsearch Service (Amazon ES) ドメインは、HTTP リクエストを AWS に処理するほか、検索対象のインデックス化されたデータ、ドメインのスナップショット、アクセスポリシー、メタデータを処理する Elasticsearch エンジンインスタンスをカプセル化します。Amazon ES コンソール、AWS CLI、または AWS SDK を使用して Amazon ES ドメインを作成することができます。アカウントをまだ持っていない場合は、「AWS へのサインアップ」を参照してください。

Amazon ES ドメイン (コンソール) を作成するには

  1. https://aws.amazon.com にアクセスし、[Sign In to the Console] を選択します。

  2. [Analytics] で、[Elasticsearch Service] を選択します。

  3. [Define domain] ページの [Elasticsearch ドメイン名] で、ドメインの名前を入力します。この入門チュートリアルでは、チュートリアルの後半にある例で、ドメイン名 movies を使用します。

  4. [Version] で、ドメインの Elasticsearch バージョンを選択します。サポートされている最新バージョンの選択をお勧めします。詳細については、「サポートされる Elasticsearch バージョン」を参照してください。

  5. [Next] を選択します。

  6. [Instance count] で、必要なインスタンスの数を選択します。このチュートリアルでは、デフォルト値である 1 を使用します。

  7. [Instance type] で、Amazon ES ドメインのインスタンスタイプを選択します。このチュートリアルには、テスト用に最適な小規模で安価なインスタンスタイプである t2.small.elasticsearch をおすすめします。

  8. ここでは、[専用マスターの有効化] および [ゾーン対応の有効化] のチェックボックスを無視してかまいません。この両方の詳細については、「専用マスターノードについて」と「ゾーン対応の有効化」を参照してください。

  9. [Storage type] で [EBS] を選択します。

    [EBS volume type] ボックスと [EBS volume size] ボックスが表示されます。

    1. [EBS ボリュームタイプ] で、凡庸 (SSD) を選択します。詳細については、「Amazon EBS ボリュームの種類」を参照してください。

    2. [EBS volume size] に、各データノードの外部ストレージのサイズを GB で入力します。このチュートリアルでは、デフォルト値である 10 を使用します。

  10. ここでは、[保存時の暗号化の有効化] を無視してかまいません。この機能の詳細については、「Amazon Elasticsearch Service の保管時のデータの暗号化」を参照してください。

  11. [自動スナップショットの開始時間] ではデフォルト値を使用します。詳細については、「自動スナップショットの設定」を参照してください。

  12. [Next] を選択します。

  13. このチュートリアルでは、分かりやすいように IP ベースのアクセスポリシーを使用します。[アクセスの設定] ページの [ネットワーク構成] セクションで、[パブリックアクセス] を選択します。

  14. ここでは、Kibana 認証は無視してかまいません。この機能の詳細については、「Kibana の Amazon Cognito 認証」を参照してください。

  15. [ドメインアクセスポリシーの設定] で [特定の IP からのドメインへのアクセスを許可] を選択し、「私の IP アドレスは何ですか」を Google で検索して確認できる パブリック IP を入力します。次に、[OK] を選択します。

    パブリックアクセス、VPC アクセスと一般的なアクセスポリシーの詳細については、「Amazon Elasticsearch Service アクセスコントロール」および「Amazon Elasticsearch Service ドメインの VPC サポート」を参照してください。

  16. [次へ] を選択します。

  17. [Review] ページで、ドメイン設定を確認し、[Confirm ] を選択します。

    注記

    新しいドメインの初期化には最大 10 分かかります。ドメインが初期化されると、データをアップロードしてドメインに変更を加えることができます。

Amazon ES ドメイン (AWS CLI) を作成するには

  • Amazon ES ドメインを作成するには、次のコマンドを実行します。

    このコマンドは movies という名前のドメインを Elasticsearch バージョン 6.0 で作成します。これには t2.small.elasticsearchインスタンスタイプから 1 つのインスタンスが指定されます。このインスタンスタイプでは EBS ストレージが必要であるため、10 GB のボリュームを指定しています。最後に、このコマンドは単一の IP アドレスにドメインへのアクセスを制限する IP ベースのアクセスポリシーを適用します。

    コマンドで your_ip_address をお使いのパブリック IP アドレスに置き換えます。この IP アドレスは、「私の IP アドレスは何ですか」をを Google で検索して確認できます。

    aws es create-elasticsearch-domain --domain-name movies --elasticsearch-version 6.0 --elasticsearch-cluster-config InstanceType=t2.small.elasticsearch,InstanceCount=1 --ebs-options EBSEnabled=true,VolumeType=standard,VolumeSize=10 --access-policies '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":"*"},"Action":["es:*"],"Condition":{"IpAddress":{"aws:SourceIp":["your_ip_address"]}}}]}'

注記

ドメインおよびそのリソースの初期化には、約 10 分かかります。初期化が完了すると、インデックスおよび Amazon ES リクエストにドメインのエンドポイントを使用できるようになります。

新しいドメインのステータスのクエリを実行するには、次のコマンドを使用します。

aws es describe-elasticsearch-domain --domain movies

Amazon ES ドメイン (AWS SDK) を作成するには

AWS SDK では (Android および iOS SDK を除く)、CreateElasticsearchDomain アクションも含めて、Amazon ES 設定 API リファレンスで定義されたすべてのアクションがサポートされています。AWS SDK のインストールと使用の詳細については、「AWS Software Development Kits」を参照してください。