Инструкция по установке

Описание

Репозиторий its-theinspection-swarm содержит конфигурации для развертывания проекта The Inspection в режиме Docker Swarm.

Требования

1. ОС: Windows или Linux
2. Docker с инициализированным режимом Swarm
3. Аутентификация в приватных репозиториях на главном узле (docker login)
4. Доступ к Bash shell
5. Python 3 (проверено на версии 9 и выше)

Первоначальное развертывание стека

1. Запустите ./stack init <stack> для начальной настройки стека и паролей.
2. Обновите пароли в ./stacks/<stack>.config.secret.yaml.
3. Обновите конфигурацию в ./stacks/<stack>.config.yaml.
4. Запустите ./stack configure для проверки конфигурации.
5. Запустите ./stack deploy для запуска сервисов.
6. Запустите ./stack status для проверки состояния всех сервисов.
7. Запустите ./stack init_nc для инициализации тенантов и структуры папок в Nextcloud.

8. Запустите ./stack init_files для загрузки шаблонов отчётов и сообщений в Nextcloud.

   Структура папок и процесс загрузки описаны в руководствах Nextcloud и Dagster.

Обновление стека

1. Добавьте или обновите конфигурацию.
2. Запустите ./stack deploy
3. Запустите ./stack status для проверки состояния служб
4. (Дополнительно) Запустите ./stack cleanup, чтобы удалить лишние пароли/конфигурации

5. (Дополнительно) Запустите ./stack configure для проверки изменений без развертывания

   Важно! Некоторые параметры конфигурации невозможно обновить после первоначального развертывания (например, пароли пользователей БД).

Удаление стека

Существуют две команды для удаления текущего стека (указанного в .stack):

• ./stack rm — удалить все тома, кроме данных
• ./stack rm-all — удалить всё, включая тома с данными