Обзор развертывания OpenSearch на сервере¶
Предварительные требования¶
Для успешного развертывания приложения требуются следующие условия:
-
Операционная система: Ubuntu.
-
Права доступа: Пользователь с правами
sudo(по умолчанию используется основной пользователь системы). -
Порты:
-
9200/tcp: для взаимодействия с API OpenSearch. -
9600/tcp: для HTTP интерфейса узла. -
5601/tcp: для доступа к панели управления Dashboards. -
443/tcp: внешний доступ через HTTPS (через прокси).
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | opensearch |
| Домен | hostkey.in |
| Полный шаблон | opensearch{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные директории, используемые в системе:
-
/home/{{ ansible_user }}/opensearch-project: рабочая директория проекта, содержащая конфигурацию Docker Compose и данные. -
/home/{{ ansible_user }}/opensearch-project/opensearch-data: хранилище данных OpenSearch (владелец1000:1000). -
/root/nginx: директория для управления прокси-сервером Nginx. -
/data/nginx/user_conf.d: директория с конфигурационными файлами виртуальных хостов.
Процесс установки приложения¶
Установка выполняется в несколько этапов:
-
Подготовка окружения: Устанавливается Docker и необходимые системные зависимости.
-
Создание рабочей среды: Создается пользовательская директория проекта
/home/{{ ansible_user }}/opensearch-projectи подкаталог для данных с соответствующими правами доступа (UID1000). -
Развертывание контейнеров:
-
Создается файл
docker-compose.yml, определяющий сервисы OpenSearch и Dashboards. -
Запускаются контейнеры в фоновом режиме с помощью команды
docker compose up -d. -
Настройка проксирования:
-
Подготавливается конфигурация Nginx для работы через SSL.
-
В конфигурационный файл домена добавляется правило
proxy_passдля перенаправления трафика на внутренний порт Dashboards (http://127.0.0.1:5601). -
Запускается контейнер прокси-сервера.
Права доступа и безопасность¶
-
Данные: Директория
opensearch-dataимеет владельца с UID1000, что необходимо для корректной работы процесса внутри контейнера Docker. -
Безопасность API: Для доступа к кластеру требуется аутентификация (логин/пароль).
-
Проксирование: Внешний доступ осуществляется через защищенное соединение HTTPS.
Базы данных¶
OpenSearch функционирует как поисковый движок и хранилище данных, работающее в режиме одного узла (single-node). Данные хранятся локально в директории ./opensearch-data относительно файла docker-compose.yml.
Контейнеры Docker и их запуск¶
Приложение использует следующие контейнеры:
OpenSearch Node
-
Имя образа:
opensearchproject/opensearch:2.17.0 -
Порты:
9200,9600 -
Тома (volumes):
./opensearch-data:/usr/share/opensearch/data -
Переменные окружения:
-
discovery.type=single-node -
bootstrap.memory_lock=true -
OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m
OpenSearch Dashboards
-
Имя образа:
opensearchproject/opensearch-dashboards:2.17.0 -
Порты:
5601 -
Переменные окружения:
OPENSEARCH_HOSTS=["https://opensearch-node1:9200"]
Nginx Proxy (Certbot)
-
Имя образа:
jonasal/nginx-certbot:latest -
Сеть:
host -
Тома (volumes):
-
nginx_secrets:/etc/letsencrypt -
/data/nginx/user_conf.d:/etc/nginx/user_conf.d
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить следующие действия:
-
Перейти в директорию проекта:
-
Подтянуть новые версии образов и перезапустить контейнеры:
Расположение конфигурационных файлов и данных¶
| Тип | Путь |
|---|---|
| Docker Compose файл | /home/{{ ansible_user }}/opensearch-project/docker-compose.yml |
| Данные OpenSearch | /home/{{ ansible_user }}/opensearch-project/opensearch-data |
| Конфигурация Nginx (прокси) | /data/nginx/user_conf.d/{prefix}{Server_ID_from_Invapi}.hostkey.in.conf |
Доступные порты для подключения¶
-
443: HTTPS (внешний доступ к панели Dashboards). -
9200: API OpenSearch. -
5601: Интерфейс Dashboards (локально).
Запуск, остановка приложения¶
Управление контейнерами осуществляется через Docker Compose в директории проекта:
-
Запуск:
-
Остановка: