Перейти к содержанию

Установка через Docker Compose

Данное руководство поможет развернуть платформу Нимбиус с использованием Docker Compose.

Варианты развертывания

Платформа Нимбиус поддерживает два варианта установки:

  1. Полная контейнеризация – все сервисы, включая базу данных PostgreSQL, работают в контейнерах Docker.
  2. Контейнеризация с внешней БД – сервисы работают в 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

Процедура остановки платформы

Процедуры запуска и остановки платформы состоят из следующих процессов:

  1. Процессы серверной части
    Для запуска необходимо запустить базу данных затем платформу.
    Для остановки необходимо остановить платформу затем базу данных.

  2. Процессы модуля приложения
    Для запуска необходимо запустить контейнер платформы.

    # sudo docker start NIMBIUS_CONTAINER_NAME
    
    Для остановки необходимо остановить контейнер платформы.
    # sudo docker stop NIMBIUS_CONTAINER_NAME
    
    Для проверки работоспособности сервисов подключитесь к консоли контейнера с приложением и введите команду appliance_console.

Обновление продукта

Для изменения конфигурации:

  • измените значения переменных окружения
  • перезапустите сервисы:
    docker-compose down
    docker-compose up -d