Установка через Docker Compose
Данное руководство поможет развернуть платформу Нимбиус с использованием Docker Compose.
Варианты развертывания¶
Платформа Нимбиус поддерживает два варианта установки:
- Полная контейнеризация – все сервисы, включая базу данных PostgreSQL, работают в контейнерах Docker.
- Контейнеризация с внешней БД – сервисы работают в Docker, база данных размещается на внешнем сервере.
Требования к среде контейнеризации¶
Убедитесь, что ваша инфраструктура соответствует следующим требованиям:
Минимальные системные требования:
- Платформа Нимбиус: 4 ГБ RAM, 5 ГБ дискового пространства
- PostgreSQL в Docker: 6 ГБ RAM, 15 ГБ дискового пространства
Инструменты:
- Docker
- Docker Compose
Содержимое дистрибутива¶
??? Дистрибутив Нимбиус для Docker имеет следующую структуру:
/nimbius-docker/ │── services/ │ ├── nimbius-billing/ │ ├── nimbius-httpd/ │ ├── nimbius-memcached/ │ ├── nimbius-postgresql/ (если используется внутренняя БД) │ │── docker-compose.yml (основной файл конфигурации) │── .env (переменные окружения для конфигурации) │── certificates/ (SSL-сертификаты)
Подготовка к установке¶
Установка Docker и Docker Compose¶
Проверьте установку Docker и Docker Compose:
docker --version
docker-compose --version
Клонирование репозитория¶
Клонируйте репозиторий:
git clone https://github.com/nimbius/docker-compose.git
cd docker-compose
Настройка конфигурации¶
🔹 Перейдите в директорию с проектом и внесите изменения перед запуском образов:
cd /docker/nimbius
# Правим .env:
# правим теги образов *_IMAGE_TAG=latest на последний релизный (напр. release-2.13.0)
# меняем PUBLIC_IP на ip адрес хостовой машины (на которой работает докер)
🔹 Используйте внешние переменные среды для управления секретами и конфигурацией:
-
Для встроенной PostgreSQL (по умолчанию):
export POSTGRES_ENABLED=true export POSTGRES_DB=vmdb_production export POSTGRES_USER=your-db-user export POSTGRES_PASSWORD=your-db-password
-
Для внешней базы данных:
export POSTGRES_ENABLED=false export EXTERNAL_DB_HOST=your-db-host export EXTERNAL_DB_PORT=5432 export EXTERNAL_DB_NAME=vmdb_production export EXTERNAL_DB_USER=your-db-user export EXTERNAL_DB_PASSWORD=your-db-password
🔹 Настройте доменное имя и ключ шифрования:
export APPLICATION_DOMAIN=your.domain.com
export ENCRYPTION_KEY=your-encryption-key
Настройка сертификатов¶
Скопируйте пользовательские SSL-сертификаты в папку:
nimbius/
├── data
├── certs
├── your-cert.crt
└── your-key.key
Установка платформы¶
Запустите контейнеры с помощью Docker Compose:
docker-compose up -d
Процесс может занять несколько минут.
Проверка работы платформы Нимбиус¶
🔹 Проверьте статус контейнеров:
docker-compose ps
Все контейнеры должны иметь статус Up. При проблемах просмотрите логи:
docker-compose logs [имя-контейнера]
🔹 Сервис доступен по адресу
https://<FQDN>:8443
🔹 Сервис «Keycloak» доступен по адресу
https://<FQDN>:7788
Процедура остановки платформы¶
Процедуры запуска и остановки платформы состоят из следующих процессов:
-
Процессы серверной части
Для запуска необходимо запустить базу данных затем платформу.
Для остановки необходимо остановить платформу затем базу данных. -
Процессы модуля приложения
Для запуска необходимо запустить контейнер платформы.Для остановки необходимо остановить контейнер платформы.# sudo docker start NIMBIUS_CONTAINER_NAME
Для проверки работоспособности сервисов подключитесь к консоли контейнера с приложением и введите команду# sudo docker stop NIMBIUS_CONTAINER_NAME
appliance_console
.
Обновление продукта¶
Для изменения конфигурации:
- измените значения переменных окружения
- перезапустите сервисы:
docker-compose down docker-compose up -d