Быстрый старт установки

Для быстрого запуска OpenSearch и OpenSearch Dashboards используйте контейнеры Docker. Полное руководство по установке доступно в разделе Установка и обновление OpenSearch.

Предварительные требования:

• Установите Docker и Docker Compose на локальную машину

Запуск кластера

1. Настройка системы
   Перед запуском рекомендуется:

   • Отключить подкачку памяти для повышения производительности:

     sudo swapoff -a
     

   • Увеличить максимальное количество memory maps:

     sudo vi /etc/sysctl.conf
     

     Добавьте строку:

     vm.max_map_count=262144
     

     Примените изменения:

     sudo sysctl -p
     

2. Получение файла конфигурации
   Загрузите образец docker-compose.yml:

   • Через cURL:

     curl -O https://raw.githubusercontent.com/opensearch-project/documentation-website/3.1/assets/examples/docker-compose.yml
     

   • Через wget:

     wget https://raw.githubusercontent.com/opensearch-project/documentation-website/3.1/assets/examples/docker-compose.yml
     

3. Запуск кластера
   Перейдите в директорию с файлом и выполните:

   docker compose up -d
   

   Проверьте статус контейнеров:

   docker compose ps
   

   Ожидаемый вывод:

   NAME                    COMMAND                  SERVICE                 STATUS              PORTS
   opensearch-dashboards   "./opensearch-dashbo…"   opensearch-dashboards   running             0.0.0.0:5601->5601/tcp
   opensearch-node1        "./opensearch-docker…"   opensearch-node1        running             0.0.0.0:9200->9200/tcp, 9300/tcp, 0.0.0.0:9600->9600/tcp, 9650/tcp
   opensearch-node2        "./opensearch-docker…"   opensearch-node2        running             9200/tcp, 9300/tcp, 9600/tcp, 9650/tcp
   

4. Проверка работы
   Выполните тестовый запрос к API:

   curl https://localhost:9200 -ku admin:ВАШ_ПАРОЛЬ
   

   Успешный ответ:

   {
     "name": "opensearch-node1",
     "cluster_name": "opensearch-cluster",
     "version": {
       "distribution": "opensearch",
       "number": "2.6.0"
     },
     "tagline": "The OpenSearch Project: https://opensearch.org/"
   }
   

5. Доступ к Dashboards
   Откройте в браузере:
   http://localhost:5601/
   Логин: admin
   Пароль: указан в OPENSEARCH_INITIAL_ADMIN_PASSWORD файла docker-compose.yml

Примечания:

• Для безопасности отключается проверка хоста (-k) при использовании демо-сертификатов
• Все команды предполагают работу в Linux-окружении
• Пароль администратора задаётся при первом запуске

Распространённые проблемы

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

Необходимость прав sudo для Docker команд

Проблема:
Требуется использовать sudo для выполнения Docker команд.

Решение:
Добавьте пользователя в группу docker:

sudo usermod -aG docker $USER

Подробнее: Post-installation steps for Linux

Ошибка: “-bash: docker-compose: command not found”

Ситуация:
При использовании Docker Desktop.

Решение:
Используйте команду без дефиса:

docker compose

См. документацию Docker Compose

Ошибка: “docker: ‘compose’ is not a docker command”

Ситуация:
При использовании Docker Engine.

Решение:
Установите Docker Compose отдельно и используйте команду с дефисом:

docker-compose

Ошибка: “max virtual memory areas vm.max_map_count [65530] is too low”

Симптомы:
В логах сервиса появляется сообщение:

opensearch-node1 | ERROR: [1] bootstrap checks failed
opensearch-node1 | [1]: max virtual memory areas vm.max_map_count [65530] is too low...

Решение:
Увеличьте значение vm.max_map_count (см. раздел “Важные системные настройки”):

sudo sysctl -w vm.max_map_count=262144

Альтернативные способы установки

Помимо Docker, OpenSearch можно установить:

• На различные дистрибутивы Linux
• На Windows

Полные руководства: Установка и обновление OpenSearch

Дальнейшее изучение

После успешного развёртывания кластера рекомендуется изучить:

1. Плагин безопасности
2. Конфигурация OpenSearch
3. Установка плагинов

Следующие шаги

Ознакомьтесь с разделом Взаимодействие с OpenSearch, чтобы узнать как отправлять запросы в систему.