Обзор развертывания Apache Solr на сервере¶
Предварительные требования¶
Для успешного развертывания приложения необходимы следующие параметры и условия:
-
Операционная система: Ubuntu.
-
Права доступа: Права суперпользователя (root) для установки системных пакетов и управления Docker.
-
Порты:
-
3000— внутренний порт приложения. -
443— внешний порт для HTTPS доступа.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | apache-solr |
| Домен | hostkey.in |
| Полный шаблон | apache-solr{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В процессе работы приложения используются следующие директории:
-
/opt/solr/data— основное хранилище данных Solr. -
/opt/solr/data/data— подкаталог для системных конфигураций (включаяsecurity.json). -
/root/nginx— рабочая директория для контейнера прокси-сервера. -
/data/nginx/user_conf.d— директория с конфигурационными файлами Nginx.
Процесс установки приложения¶
Процесс развертывания включает в себя несколько этапов:
-
Подготовка окружения: Создание необходимых директорий для данных Solr и настройка прав доступа (владелец
8983). -
Инициализация безопасности: Размещение конфигурационного файла
security.jsonв директории/opt/solr/data/data/. -
Установка Docker: Установка среды выполнения контейнеров. Если прямой доступ к Docker Hub ограничен, система автоматически настраивает зеркала (например,
https://dh-mirror.gitverse.ru). -
Загрузка образа: Загрузка образа
solr:9. -
Развертывание приложения: Запуск контейнера Solr с пробросом портов и монтированием томов.
-
Первоначальная настройка: Если создается новый файл безопасности, выполняется автоматическая настройка учетных данных через API Solr (установка пароля администратора).
-
Настройка прокси: Развертывание контейнера Nginx с поддержкой SSL через Certbot для обеспечения доступа по HTTPS.
Права доступа и безопасность¶
-
Данные приложения хранятся под пользователем с UID/GID
8983. -
Файл конфигурации безопасности
security.jsonимеет ограниченный доступ (права0640). -
Для работы прокси используется механизм секретов Docker (
nginx_secrets) для защиты SSL-сертификатов.
Базы данных¶
В данном приложении база данных является встроенной частью Apache Solr и хранит данные в директории /opt/solr/data.
Контейнеры Docker и их запуск¶
Основное приложение¶
-
Имя образа:
solr:9 -
Порты:
3000(внутри контейнера, используется режимhost) -
Тома:
/opt/solr/data:/var/solr -
Переменные окружения:
SOLR_PORT=3000 -
Политика перезапуска:
always
Прокси-сервер (Nginx + Certbot)¶
-
Имя образа:
jonasal/nginx-certbot:latest -
Порты: Использует сетевой режим
host. -
Тома:
-
nginx_secrets:/etc/letsencrypt(для сертификатов) -
/data/nginx/user_conf.d:/etc/nginx/user_conf.d(конфигурации доменов) -
Переменные окружения:
CERTBOT_EMAIL=hkadm@hostkey.com -
Политика перезапуска:
unless-stopped
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить следующие действия:
-
Обновить образ контейнера:
-
Перезапустить сервис для применения изменений: