Установка через 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