Перейти к основному контенту

Установка «всё-в-одном» на Linux через Docker Compose

В результате на одном Linux-сервере будут развернуты Клавдий, локальный PostgreSQL и локальный Solr.

Используйте этот вариант для первого автономного сервера Клавдия, если PostgreSQL и Solr не требуется выносить во внешнюю инфраструктуру.

{{ВИДЕО}}

Перед началом

Выполните {{ССЫЛКА:install.preflight|Чек-лист (!) перед установкой}}.

Убедитесь, что сервер имеет доступ к реестру образов и серверу установочных файлов. Для закрытого контура используйте {{ССЫЛКА:install.offline|Установку в изолированной сети}}.

Запустите установщик

Загрузите установочный сценарий:

wget -qO /tmp/klvd-install.sh https://klvd.ru/public/install.sh

Запустите его с правами администратора:

sudo bash /tmp/klvd-install.sh

Не передавайте сценарий напрямую в bash через конвейер команд. Установщик использует интерактивный терминал для выбора параметров.

Выберите автономную установку

В установщике выберите создание нового автономного сервера Клавдия.

Укажите:

  1. каталог установки;
  2. роли узла;
  3. каталоги для журналов и данных хранилища;
  4. каталог поискового индекса;
  5. остальные параметры, которые запросит установщик.

Для новой установки установщик создаёт параметры локальной PostgreSQL, секретный ключ кластера и самоподписанный сертификат.

{{СКРИНШОТ}}

Дождитесь запуска контейнеров

После завершения установки на сервере должны работать:

  • контейнер klvd-node;
  • контейнер PostgreSQL;
  • контейнер Solr.

Установщик создаёт рабочие файлы в выбранном каталоге установки.

Файл или каталог Назначение
.env параметры запуска и подключения
secrets/ пароли, ключ кластера и сертификат
state.ini состояние выполнения установщика
docker-compose.yml описание контейнеров установки
klvd-psql утилита доступа к базе данных

Не удаляйте каталог secrets/ и не заменяйте секретный ключ кластера после начала эксплуатации без отдельной процедуры ротации.

Проверьте, что веб-интерфейс доступен

Откройте в браузере:

https://<адрес-сервера>:8001

Должна открыться страница входа Клавдия.

При использовании автоматически созданного самоподписанного сертификата браузер может вывести предупреждение о доверии к сертификату. Замените сертификат перед вводом системы в промышленную эксплуатацию.

{{СКРИНШОТ}}

Проверка результата

Проверьте:

  • страница входа открывается по HTTPS;
  • контейнер klvd-node запущен;
  • PostgreSQL запущен;
  • Solr запущен.

Полную проверку компонентов выполните после первого входа.

Если установка не завершилась

Повторно запустите тот же установочный сценарий:

sudo bash /tmp/klvd-install.sh

Установщик использует файл state.ini и пропускает уже выполненные этапы.

Если повторный запуск не устранил ошибку, перейдите к {{ССЫЛКА:maintenance.troubleshooting|Диагностике проблем}}.

Что дальше

Выполните {{ССЫЛКА:install.first-start|Первый вход и смену пароля администратора}}.

Связанные материалы

  • {{ССЫЛКА:install.choose-topology|Выбор схемы установки}};
  • {{ССЫЛКА:install.preflight|Чек-лист (!) перед установкой}};
  • {{ССЫЛКА:reference.env|Параметры запуска Docker Compose}};
  • {{ССЫЛКА:maintenance.update|Обновление системы}}.

Навигация по книге

  • Следующая статья: {{ССЫЛКА:install.join-node|Добавление Linux-узла в существующий кластер}}