Как начать работать с Managed Service for Elasticsearch

Чтобы начать работу с сервисом:

1. Создайте кластер.
2. Настройте группы безопасности.
3. Подключитесь к кластеру.
4. Подключитесь к Kibana.

Перед началом работыПеред началом работы

1. Войдите в консоль управления или зарегистрируйтесь, если вы еще не зарегистрированы.

2. Если у вас еще нет каталога, создайте его:

   1. В консоли управления в списке слева выберите нужное облако.

   2. Справа сверху нажмите кнопку Создать каталог.

   3. Введите имя каталога. Требования к имени:

      • длина — от 3 до 63 символов;
      • может содержать строчные буквы латинского алфавита, цифры и дефисы;
      • первый символ — буква, последний — не дефис.

   4. (Опционально) Введите описание каталога.

   5. Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.

   6. Нажмите кнопку Создать.

3. Подключаться к кластеру Elasticsearch можно как изнутри, так и извне Yandex Cloud:

   • Чтобы подключиться изнутри Yandex Cloud, создайте виртуальную машину на основе Linux в той же сети, что и кластер.

   • Чтобы подключиться к кластеру из интернета, запросите публичный доступ к хостам с ролью Data node при создании кластера.

Создайте кластерСоздайте кластер

1. В консоли управления выберите каталог, в котором нужно создать кластер.

2. Выберите сервис Managed Service for Elasticsearch.

3. Нажмите кнопку Создать кластер. Процесс подробно рассмотрен в разделе Создание кластера.

4. Задайте параметры кластера.

   Чтобы получить доступ к веб-интерфейсу Kibana, запросите публичный доступ:

   1. В блоке Хосты измените настройки хоста с ролью Data node, нажав значок для хоста.
   2. Выберите опцию Публичный доступ.
   3. Нажмите кнопку Сохранить.

   Публичный доступ можно запросить для одного или нескольких хостов с ролью Data node. После создания кластера станет доступно подключение к Kibana, расположенной на этих хостах. Может потребоваться дополнительная настройка групп безопасности для того, чтобы можно было подключаться к кластеру.

   Совет

   Kibana можно воспользоваться, даже если публичный доступ к хостам запросить невозможно (например, из соображений безопасности). Для этого настройте проксирование соединений через виртуальную машину в Yandex Compute Cloud, которая находится в той же сети, что и кластер. Подробнее см. в разделе Подключение к кластеру.

5. Нажмите кнопку Создать.

6. Дождитесь, когда кластер будет готов к работе: его статус на панели Managed Service for Elasticsearch сменится на Creating и далее — на Alive. Это может занять некоторое время.

Настройте группы безопасностиНастройте группы безопасности

Настройте группы безопасности для облачной сети так, чтобы был разрешен весь необходимый трафик между кластером и хостом, с которого выполняется подключение.

Подключитесь к кластеруПодключитесь к кластеру

Предполагается, что все перечисленные ниже шаги выполняются на Linux.

Чтобы подключиться к кластеру:

1. Установите SSL-сертификат:

   Linux (Bash)/macOS (Zsh)

   Windows (PowerShell)

   mkdir -p ~/.elasticsearch && \
   wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
        --output-document ~/.elasticsearch/root.crt && \
   chmod 0600 ~/.elasticsearch/root.crt
   

   Сертификат будет сохранен в файле ~/.elasticsearch/root.crt.

   mkdir $HOME\.elasticsearch; curl.exe -o $HOME\.elasticsearch\root.crt https://storage.yandexcloud.net/cloud-certs/CA.pem
   

   Сертификат будет сохранен в файле $HOME\.elasticsearch\root.crt.

2. Подключитесь к кластеру с помощью утилиты cURL:

   curl \
       --user <имя_пользователя>:<пароль> \
       --cacert ~/.elasticsearch/root.crt \
       --request GET 'https://c-<идентификатор_кластера_Elasticsearch>.rw.mdb.yandexcloud.net:9200/'
   

   Для подключения нужно использовать имя пользователя и пароль, которые были заданы при создании кластера.

   При успешном подключении будет выведено похожее сообщение:

   {
     "name" : "....mdb.yandexcloud.net",
     "cluster_name" : "...",
     "cluster_uuid" : "...",
     ...
     "tagline" : "You Know, for Search"
   }
   

Подключитесь к KibanaПодключитесь к Kibana

1. Подключитесь с помощью браузера к веб-интерфейсу Kibana.

   Для подключения:

   1. Установите SSL-сертификат в хранилище доверенных корневых сертификатов браузера (инструкция для Mozilla Firefox).

   2. Перейдите в браузере по адресу https://<FQDN_публично_доступного_хоста_Elasticsearch_с_ролью_Data_node>.

      О том, как получить FQDN хоста, см. инструкцию.

   3. Введите имя пользователя и пароль, которые были заданы при создании кластера.

2. Загрузите в Elasticsearch один или несколько наборов тестовых данных с помощью Kibana:

   1. На приветственном экране Kibana нажмите кнопку Try our sample data.
   2. Добавьте данные из одного или нескольких наборов данных, нажав кнопку Add data для нужного набора.

3. Исследуйте данные с помощью Kibana и Elasticsearch, нажав кнопку View data для интересующего набора данных.

Подробнее о работе с Kibana см. в документации Elasticsearch.

Что дальшеЧто дальше

• Изучите концепции сервиса.
• Узнайте подробнее о создании кластера и подключении к кластеру.