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. После настройки проверьте вход и журнал приложения.