Перейти к содержанию

Обзор развертывания 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: директория с конфигурационными файлами виртуальных хостов.

Процесс установки приложения

Установка выполняется в несколько этапов:

  1. Подготовка окружения: Устанавливается Docker и необходимые системные зависимости.

  2. Создание рабочей среды: Создается пользовательская директория проекта /home/{{ ansible_user }}/opensearch-project и подкаталог для данных с соответствующими правами доступа (UID 1000).

  3. Развертывание контейнеров:

  4. Создается файл docker-compose.yml, определяющий сервисы OpenSearch и Dashboards.

  5. Запускаются контейнеры в фоновом режиме с помощью команды docker compose up -d.

  6. Настройка проксирования:

  7. Подготавливается конфигурация Nginx для работы через SSL.

  8. В конфигурационный файл домена добавляется правило proxy_pass для перенаправления трафика на внутренний порт Dashboards (http://127.0.0.1:5601).

  9. Запускается контейнер прокси-сервера.

Права доступа и безопасность

  • Данные: Директория opensearch-data имеет владельца с UID 1000, что необходимо для корректной работы процесса внутри контейнера 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

Инструкция по обновлению приложения

Для обновления основного приложения необходимо выполнить следующие действия:

  1. Перейти в директорию проекта:

    cd /home/{{ ansible_user }}/opensearch-project
    

  2. Подтянуть новые версии образов и перезапустить контейнеры:

    docker compose pull && docker compose up -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 в директории проекта:

  • Запуск:

    docker compose up -d
    

  • Остановка:

    docker compose down
    

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×