Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Подготовка среды с нуля
  6. Redis в контейнере

Redis в контейнере

Redis хранит рабочие данные кэша BPMSoft. Для Ubuntu его можно запустить на том же сервере, что и приложение. Для новой установки Windows Server используйте отдельный узел Ubuntu 24.04 с Docker. WSL 2 подходит для локального теста, при котором владелец дистрибутива запускает его после перезагрузки Windows.

Docker на отдельном Linux-узле

На Ubuntu 24.04 с правом sudo установите Docker и Compose. Команда включает службу Docker и проверяет наличие Compose.

sudo apt-get update
sudo apt-get install -y docker.io docker-compose-v2 openssl
sudo systemctl enable --now docker
sudo docker compose version

Для удалённого Redis используйте выделенный приватный интерфейс. До запуска настройте сетевой экран на разрешение TCP 6379 только с узла BPMSoft. Для контейнерного порта проверяйте фильтрацию именно опубликованного трафика Docker или используйте внешний сетевой экран. На одном узле оставьте привязку к loopback.

Docker в WSL 2 для тестового Windows-стенда

На Windows Server 2022 в PowerShell от имени администратора включите WSL и установите Ubuntu 24.04. В виртуальной машине для WSL 2 потребуется вложенная виртуализация. Выполните запрошенную перезагрузку и завершите первый запуск Ubuntu под учётной записью, которая будет запускать этот дистрибутив.

wsl --install -d Ubuntu-24.04
wsl -l -v

Ожидается версия 2. Если система не находит имя дистрибутива, получите список через wsl --list --online и выберите Ubuntu 24.04. В Ubuntu WSL проверьте ps -p 1 -o comm=. Если это не systemd, добавьте в существующий /etc/wsl.conf через sudoedit:

[boot]
systemd=true

Из PowerShell выполните wsl --terminate Ubuntu-24.04, снова откройте дистрибутив и выполните в терминале Ubuntu команды установки Docker и Compose из первого раздела. В конфигурации ниже оставьте 127.0.0.1. В Windows для Redis укажите 127.0.0.1:6379 и проверьте доступность порта командой Test-NetConnection 127.0.0.1 -Port 6379. Сохраните стандартное перенаправление localhost в WSL и убедитесь, что порт свободен в Windows.

После перезагрузки Windows откройте WSL под владельцем дистрибутива и в терминале Ubuntu выполните sudo systemctl is-active docker и sudo docker compose -f /opt/bpmsoft-cache/compose.yaml ps. На Windows повторите Test-NetConnection 127.0.0.1 -Port 6379, затем откройте BPMSoft и проверьте отсутствие ошибок Redis в журнале приложения. Для стенда, который должен запускаться без входа администратора, выберите самостоятельный Linux-узел.

Создайте конфигурацию Redis

На узле Redis откройте Bash и выполните sudo -i. Команды создают закрытый каталог для новой установки и записывают в него случайный пароль. Если каталог уже существует, остановитесь и проверьте, используется ли он действующим контейнером.

(
  set -eu
  umask 077
  mkdir -m 700 /opt/bpmsoft-cache
  cd /opt/bpmsoft-cache
  openssl rand -hex 32 > app_password
)

В /opt/bpmsoft-cache создайте один файл compose.yaml. Compose передаёт Redis пароль через файл, а контейнер при запуске создаёт временную конфигурацию с правом чтения для пользователя Redis. Том data сохраняет состояние при пересоздании контейнера. Публикация порта по умолчанию ограничена локальным адресом.

name: bpmsoft-cache
services:
  cache:
    image: redis:7.2.11
    restart: unless-stopped
    entrypoint: ["/bin/sh", "-ec"]
    command:
      - |
        umask 077
        config=$$(mktemp /tmp/redis.XXXXXXXX)
        password=$(cat /run/secrets/redis_password)
        test "$${#password}" -eq 64
        case "$$password" in *[!0-9a-f]*) exit 1 ;; esac
        printf 'bind 0.0.0.0\nport 6379\nappendonly yes\nrequirepass %s\n' "$$password" > "$$config"
        chown redis:redis "$$config"
        exec docker-entrypoint.sh redis-server "$$config"
    secrets:
      - redis_password
    ports:
      - "127.0.0.1:6379:6379"
    volumes:
      - data:/data
secrets:
  redis_password:
    file: ./app_password
volumes:
  data:

Последовательность $$ передаёт символ доллара оболочке внутри контейнера. Пароль берётся из app_password при каждом запуске, поэтому в Compose его вводить не нужно. Параметр appendonly yes включает запись изменений в постоянный том.

Если Redis находится на отдельном Linux-узле, замените первый IP на его приватный адрес после настройки сетевых ограничений. Для WSL 2 оставьте loopback. Этот профиль использует пароль и изолированную сеть. Для соединения между узлами без доверенного защищённого транспорта сначала настройте защищённый канал.

Запустите и проверьте

В закрытом каталоге с правами root выполните команды. Они проверяют синтаксис, запускают контейнер и показывают состояние.

cd /opt/bpmsoft-cache
docker compose config --quiet && docker compose up -d
docker compose ps
docker compose logs --tail 30 cache

Для изолированной сети заранее перенесите образ через docker save и docker load по подготовке Ubuntu. Передайте пароль из файла app_password по защищённому каналу и укажите его в подключении BPMSoft. После настройки проверьте вход и журнал приложения.

Был ли данный материал полезен вам? Да Нет