Документация

Развёртывание с Docker и Docker Compose

Установка dzyam.chat с помощью Docker и Docker Compose

Развёртывание dzyam.chat с помощью Docker и Docker Compose — один из наиболее рекомендуемых способов запуска благодаря простоте и гибкости.

Внимание!

Перед развёртыванием dzyam.chat через Docker необходимо выполнить вход в реестр образов. Без авторизации Docker не сможет скачать образ приложения, и контейнеры не запустятся.

Команду для входа в реестр и логин / пароль можно получить на клиентском портале в разделе Документация после создания клиентского аккаунта.

В этом руководстве вы узнаете, как:

Что получится в результате:

Предварительные требования

Перед началом убедитесь, что выполнены следующие условия:

Шаг 1: Установить Docker, Docker Compose и Git

Это руководство рассчитано на пользователей Linux. Для других ОС и альтернативных способов установки см. официальную документацию Docker и документацию Git.

  1. Необходимы Docker, Docker Compose (Docker Compose v2) и Git. Если их ещё нет, в дистрибутивах Linux их можно установить командами:
curl -L https://get.docker.com | sh # Install Docker
sudo apt install git # Install Git
  1. Чтобы выполнять команды Docker без sudo, добавьте текущего пользователя в группу Docker.
    1. Узнайте имя текущего пользователя:
whoami
  1. Добавьте пользователя в группу docker, при необходимости подставив имя вместо $USER:
sudo usermod -aG docker $USER
  1. Перезагрузите систему, чтобы изменение вступило в силу:
sudo reboot

Когда Docker и Git установлены, можно получить файлы конфигурации dzyam.chat.

Шаг 2: Клонировать официальный репозиторий конфигурации dzyam.chat

Официальный репозиторий rocketchat-compose содержит все файлы конфигурации, необходимые для развёртывания dzyam.chat через Docker Compose.

  1. Клонируйте репозиторий с помощью Git и перейдите в каталог:
git clone --depth 1 https://git.dzyam.chat/dce/dce-compose-files.git

В репозитории есть:

  1. compose.yml — основной файл конфигурации Docker Compose для развёртывания dzyam.chat.
  2. .env.example — пример файла окружения для настройки развёртывания.
  3. Дополнительные конфиги: файлы для базы данных, Traefik (обратный прокси и HTTPS) и инструментов мониторинга.

Не редактируйте файлы compose напрямую. Всю конфигурацию развёртывания можно задать в одном файле .env, который вы создадите на следующем шаге.

Шаг 3: Настроить dzyam.chat

Все параметры развёртывания — версия, домен, обратный прокси, учётные данные мониторинга — задаются переменными в файле .env.

  1. Скопируйте предоставленный пример:
cp .env.example .env

Команда создаёт файл .env, в котором можно задать переменные развёртывания: нужную версию dzyam.chat и URL рабочего пространства.

  1. Откройте файл для редактирования:
nano .env

Пройдите разделы конфигурации ниже, прежде чем сохранять файл. Каждый раздел относится к отдельной области развёртывания.

3a. Задать версию dzyam.chat

Найдите переменную RELEASE и укажите точную версию dzyam.chat, которую хотите развернуть. Полный список стабильных релизов — в Тэги и информация. Например, для dzyam.chat 8.9.1:

RELEASE=8.9.1

Примечание.

В продакшене настоятельно рекомендуется указывать фиксированный номер версии (например, 8.9.1), а не latest. Это защищает от неожиданных проблем из‑за автоматических ломающих обновлений.

Предупреждение.

MongoDB 8.x может не запуститься на Ubuntu 26.04 из‑за проблемы совместимости со стороны MongoDB. Пока используйте Ubuntu 24.04 LTS или другой поддерживаемый выпуск Ubuntu. Подробности — в примечании MongoDB.

3b. Настроить мониторинг

В репозитории есть готовый стек мониторинга: Prometheus собирает метрики, Loki агрегирует журналы, Grafana даёт дашборд для визуализации и того и другого. Это позволяет видеть ключевые метрики, отслеживать производительность и состояние экземпляра dzyam.chat.

Grafana можно открывать либо по URL (например, https://your-domain.com/grafana), либо по поддомену (например, https://grafana.your-domain.com).

Этот вариант удобен для локальной разработки или схем с одним доменом: дашборд Grafana доступен как подкаталог (например, https://your-domain.com/grafana).

Чтобы настроить это, в файле .env:

  1. Можно оставить значения по умолчанию для следующих переменных:
    1. GRAFANA_DOMAIN: оставьте пустой.
    2. GRAFANA_PATH: укажите нужный путь без завершающего слэша (например, /grafana).
GRAFANA_DOMAIN=
GRAFANA_PATH=/grafana
  1. Задайте надёжный пароль пользователя admin Grafana в переменной GRAFANA_ADMIN_PASSWORD:
GRAFANA_ADMIN_PASSWORD=your_secure_password

После развёртывания Grafana будет доступна по адресу https://your-domain.com/grafana.

Доступ к дашборду Grafana через отдельный поддомен рекомендуется для продакшена: точка входа чище и безопаснее.

Чтобы настроить это:

  1. В DNS создайте запись A для нужного поддомена (например, grafana.your-domain.com) и укажите публичный IP сервера.
  2. Задайте переменные Grafana в .env:
    1. GRAFANA_DOMAIN: поддомен дашборда Grafana (например, grafana.your-domain.com).
    2. GRAFANA_PATH: оставьте пустой.
GRAFANA_DOMAIN=grafana.your-domain.com
GRAFANA_PATH=
  1. Задайте надёжный пароль пользователя admin Grafana:
GRAFANA_ADMIN_PASSWORD=your_secure_password

После развёртывания Grafana будет доступна по адресу https://grafana.your-domain.com.

3c. Настроить домен и обратный прокси

Обратный прокси определяет, как пользователи входят в рабочее пространство и защищены ли соединения HTTPS. В репозитории по умолчанию и в качестве рекомендуемого варианта идёт Traefik. Nginx можно использовать как альтернативу, если команда уже работает с ним или есть особые инфраструктурные требования. Выберите один вариант и следуйте только ему.

Traefik интегрируется напрямую с Docker и автоматически выпускает TLS-сертификаты через Let's Encrypt — для большинства развёртываний это более простой выбор.

Локальное развёртывание

Если вы только тестируете dzyam.chat локально и внешний доступ или HTTPS не нужны, оставьте в .env значения по умолчанию:

DOMAIN=localhost
ROOT_URL=http://localhost

После успешного развёртывания рабочее пространство будет доступно по адресу http://localhost:3000.

Продакшен-развёртывание

Примечание. Перед продолжением убедитесь, что запись A домена (или необязательная CNAME) указывает на публичный IP сервера, где запущен Docker. Traefik не сможет выпустить сертификат для домена, до которого не достучаться.

Для публичного и защищённого продакшен-развёртывания обновите в .env следующие переменные:

Поле Описание Пример
DOMAIN Публичный домен. Без https:// и без завершающего слэша. example.com
ROOT_URL Полный URL, по которому пользователи заходят на сервер, включая защищённый протокол (https://). https://example.com
LETSENCRYPT_ENABLED Значение true включает автоматическое получение и продление сертификатов Traefik. true
LETSENCRYPT_EMAIL Действующий адрес электронной почты для продления сертификатов и уведомлений безопасности Let's Encrypt. demo@email.com
TRAEFIK_PROTOCOL Значение https заставляет прокси требовать защищённые соединения. https

Пример конфигурации:

DOMAIN=example.com
ROOT_URL=https://example.com
LETSENCRYPT_ENABLED=true
LETSENCRYPT_EMAIL=demo@email.com
TRAEFIK_PROTOCOL=https

После задания этих переменных можно переходить к необязательным настройкам.

С Nginx dzyam.chat работает локально на порту 3000, а Nginx выступает публичным обратным прокси: обрабатывает HTTPS и перенаправляет трафик на локальный сервис. По сравнению с Traefik здесь больше ручных шагов.

Примечание. Перед продолжением убедитесь, что запись A домена (или необязательная CNAME) указывает на публичный IP сервера, где запущен Docker.

Шаг 1: Привязать dzyam.chat к localhost
  1. В файле .env задайте значения по умолчанию, чтобы dzyam.chat работал локально и Nginx мог проксировать к нему запросы:
DOMAIN=localhost
ROOT_URL=http://localhost
LETSENCRYPT_ENABLED=false
LETSENCRYPT_EMAIL=demo@email.com
TRAEFIK_PROTOCOL=http
  1. Сохраните изменения в .env.
Шаг 2: Получить TLS-сертификат Let's Encrypt

Чтобы получить бесплатный TLS-сертификат Let's Encrypt:

  1. Установите Certbot — клиент сертификатов Let's Encrypt.

Для дистрибутивов на базе Debian (Debian, Ubuntu):

sudo apt update
sudo apt install certbot

Для дистрибутивов на базе RPM (Red Hat, CentOS):

sudo yum install yum-utils
sudo yum install certbot

Команды установки могут отличаться в зависимости от дистрибутива и версии Linux.

  1. Запросите сертификат для домена:
sudo certbot certonly --standalone --email <emailaddress@email.com> -d <domain.com> -d <subdomain.com>

При успехе файлы сертификата окажутся в /etc/letsencrypt/live/<your.domain.com>/. Эти пути вы укажете в конфигурации Nginx ниже.

  1. Подставьте вместо <emailaddress@email.com> и <domain.com> свой адрес электронной почты и домен dzyam.chat.
  2. Если настраиваете Grafana по поддомену, вместо <subdomain.com> укажите поддомен Grafana (например, grafana.your-domain.com); иначе уберите этот параметр.
Шаг 3: Установить и настроить Nginx

Теперь свяжите домен с сервисом dzyam.chat на локальном порту 3000. Nginx станет защищённой публичной точкой входа: будет принимать HTTPS на порту 443 и направлять запросы к локальным сервисам dzyam.chat и Grafana.

  1. Установите веб-сервер Nginx:
sudo apt-get install nginx
  1. Сохраните копию конфигурации по умолчанию для справки:
cd /etc/nginx/sites-available
sudo mv default default.reference
  1. Создайте новую конфигурацию сайта для dzyam.chat:
sudo nano /etc/nginx/sites-available/default
  1. Добавьте конфигурацию Nginx в файл. Выбор конфигурации зависит от того, как вы настроили Grafana в разделе мониторинга.

Если Grafana настроена по пути URL (например, https://your-domain.com/grafana), вставьте следующее:

 server {
     listen 443 ssl;
     server_name <ABC.DOMAIN.COM>;
     ssl_certificate /etc/letsencrypt/live/<ABC.DOMAIN.COM>/fullchain.pem;
     ssl_certificate_key /etc/letsencrypt/live/<ABC.DOMAIN.COM>/privkey.pem;
     ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
     ssl_prefer_server_ciphers on;
     ssl_ciphers 'EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH';
     root /usr/share/nginx/html;
     index index.html index.htm;
     # Make site accessible from http://localhost/
     server_name localhost;
     location / {
         proxy_pass http://localhost:3000/;
         proxy_http_version 1.1;
         proxy_set_header Upgrade $http_upgrade;
         proxy_set_header Connection "upgrade";
         proxy_set_header Host $http_host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto http;
         proxy_set_header X-Nginx-Proxy true;
         proxy_redirect off;
     }
     # Grafana Reverse Proxy
    location /grafana {
        proxy_pass http://localhost:5050/grafana;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https; # Crucial for secure path access
        proxy_set_header X-Nginx-Proxy true;
        proxy_redirect off;
    }
 }
 server {
     listen 80;
     server_name <ABC.DOMAIN.COM>;
     return 301 https://$host$request_uri;
 }

Если Grafana настроена по поддомену (например, https://grafana.your-domain.com), вставьте следующее:

 server {
     listen 443 ssl;
     server_name <ABC.DOMAIN.COM>;
     ssl_certificate /etc/letsencrypt/live/<ABC.DOMAIN.COM>/fullchain.pem;
     ssl_certificate_key /etc/letsencrypt/live/<ABC.DOMAIN.COM>/privkey.pem;
     ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
     ssl_prefer_server_ciphers on;
     ssl_ciphers 'EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH';
     root /usr/share/nginx/html;
     index index.html index.htm;
     # Make site accessible from http://localhost/
     server_name localhost;
     location / {
         proxy_pass http://localhost:3000/;
         proxy_http_version 1.1;
         proxy_set_header Upgrade $http_upgrade;
         proxy_set_header Connection "upgrade";
         proxy_set_header Host $http_host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto http;
         proxy_set_header X-Nginx-Proxy true;
         proxy_redirect off;
     }
 }
server {
    listen 443 ssl;
    server_name <GRAFANA.ABC.DOMAIN.COM>;
     ssl_certificate /etc/letsencrypt/live/<ABC.DOMAIN.COM>/fullchain.pem;
     ssl_certificate_key /etc/letsencrypt/live/<ABC.DOMAIN.COM>/privkey.pem;
    location / {
        proxy_pass http://localhost:5050/; # Note the change here (no /grafana suffix)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
    }
}
server {
     listen 80;
     server_name <ABC.DOMAIN.COM>;
     return 301 https://$host$request_uri;
 }
  1. Замените <ABC.DOMAIN.COM> на имя своего домена.

  2. Замените <GRAFANA.ABC.DOMAIN.COM> на имя поддомена Grafana.

  3. Проверьте синтаксис конфигурации, прежде чем продолжать:

sudo nginx -t

Сообщения «syntax is ok» и «test is successful» подтверждают, что конфигурация корректна. Пока не перезапускайте Nginx — это нужно будет сделать после запуска развёртывания dzyam.chat на шаге 4.

Предупреждение. Если действуют ограничения security group, разрешите TCP/22 с вашего текущего IP для SSH и TCP/443 с того IP, с которого планируете доступ.

3d. Необязательные настройки

Ниже дополнительные параметры, которые не обязательны для запуска, но могут понадобиться в зависимости от инфраструктуры. Их можно добавить в .env до запуска dzyam.chat.

  1. Подключение к внешней MongoDB. По умолчанию стек сам поднимает контейнер MongoDB. Если нужно подключиться к уже существующему экземпляру MongoDB (управляемый сервис вроде MongoDB Atlas или отдельно размещённый набор реплик), задайте MONGO_URL в .env так:
MONGO_URL=mongodb://<user>:<pass>@host1:27017,host2:27017,host3:27017/<databaseName>?replicaSet=<replicaSet>&ssl=true&authSource=admin

Предупреждение.

При использовании внешней MongoDB не включайте compose.database.yml в команду Docker Compose — этот файл запускает встроенный контейнер MongoDB. Добавьте в команду compose.nats.yml, чтобы отдельно запустить NATS.

Полные шаги настройки, включая требования к набору реплик, примеры строк подключения и корректировку команды Compose, см. в Configure External MongoDB for Rocket.Chat.

Шаг 4: Запустить развёртывание dzyam.chat

Перед развёртыванием dzyam.chat через Docker необходимо выполнить вход в реестр образов. Без авторизации Docker не сможет скачать образ приложения, и контейнеры не запустятся.

Команду для входа в реестр и логин / пароль можно получить на клиентском портале в разделе Документация после создания клиентского аккаунта.

Когда файл .env сохранён, запустите развёртывание по инструкциям для того обратного прокси, который вы настроили на шаге 3.

  1. Выполните команду, чтобы скачать все нужные образы Docker (dzyam.chat, MongoDB, Traefik и др.) и запустить контейнеры в фоне:
docker compose \
  -f compose.monitoring.yml \
  -f compose.traefik.yml \
  -f compose.database.yml \
  -f compose.yml \
  -f compose.nats.yml \
  -f docker.yml \
  up -d

Кратко, что делает каждый файл в команде:

  • compose.yml — запускает приложение dzyam.chat.
  • compose.database.yml — запускает и сопровождает встроенную базу MongoDB, на которую dzyam.chat опирается по умолчанию.
  • compose.monitoring.yml — включает мониторинг: Prometheus собирает метрики, Loki — журналы, Grafana визуализирует их на дашбордах.
  • compose.traefik.yml — управляет обратным прокси Traefik: маршрутизация и автоматический выпуск HTTPS-сертификатов Let's Encrypt.
  • compose.nats.yml — запускает NATS, внутренний брокер сообщений для связи сервисов dzyam.chat.
  • docker.yml — конфигурация, специфичная для запуска развёртывания через Docker Compose.
  1. Вернитесь в клонированный каталог dzyam.chat, где лежат файлы compose.
  2. Скачайте нужные образы Docker и запустите сервисы dzyam.chat, явно исключив файл конфигурации Traefik (compose.traefik.yml):
docker compose \
  -f compose.monitoring.yml \
  -f compose.database.yml \
  -f compose.yml \
  -f compose.nats.yml \
  -f docker.yml \
  up -d

Кратко, что делает каждый файл в команде:

  • compose.yml — запускает приложение dzyam.chat.
  • compose.database.yml — запускает и сопровождает встроенную базу MongoDB, на которую dzyam.chat опирается по умолчанию.
  • compose.monitoring.yml — включает мониторинг: Prometheus собирает метрики, Loki — журналы, Grafana визуализирует их на дашбордах.
  • compose.nats.yml — запускает NATS, внутренний брокер сообщений для связи сервисов dzyam.chat.
  • docker.yml — конфигурация, специфичная для запуска развёртывания через Docker Compose.
  1. Когда контейнеры подняты, перезапустите Nginx, чтобы он начал проксировать трафик в dzyam.chat:
sudo systemctl restart nginx

Развёртывание можно упростить, подключая только нужные сервисы. Например, если мониторинг или Traefik не настраивали, эти .yml можно не указывать:

docker compose -f compose.database.yml -f compose.yml -f compose.nats.yml up -d

Чтобы проверить, что все сервисы успешно запустились, выведите список контейнеров:

docker ps -a

У всех сервисов должен быть статус Up. У части вспомогательных сервисов MongoDB статус может быть Exited (0).

Если при развёртывании возникли проблемы, см. ресурсы по журналам и устранению неисправностей:

Шаг 5: Открыть рабочее пространство dzyam.chat

  1. Когда экземпляр dzyam.chat развёрнут, откройте рабочее пространство в браузере для финальной настройки:
  1. При первой загрузке мастер настройки предложит создать первого пользователя-администратора и завершить начальную настройку рабочего пространства.

Доступ к дашборду мониторинга

Дашборд Grafana доступен по URL, соответствующему выбранному способу доступа:

Войдите с учётными данными:

Предупреждение. Пароль GRAFANA_ADMIN_PASSWORD из .env применяется только один раз — при первой настройке контейнера. Чтобы сменить пароль позже, меняйте его непосредственно в настройках пользователя Grafana.

Подробнее о мониторинге метрик и журналов рабочего пространства — в руководстве Monitor Workspace Logs and Metrics.

Шаг 6: Обновить хранилище файлов

По умолчанию dzyam.chat хранит загрузки файлов в GridFS. Дополнительная настройка не нужна, но для продакшена это не лучший вариант: растёт нагрузка на базу и снижается масштабируемость. Настоятельно рекомендуется выделенное объектное хранилище: Amazon S3, Google Cloud Storage (GCS) или MinIO. Подробные инструкции — в руководстве File Uploads.

Обновление dzyam.chat в Docker

Предупреждение.

Обновление образа dzyam.chat не затрагивает данные: они хранятся отдельно в сервисе MongoDB.

Чтобы обновить версию dzyam.chat:

  1. Измените переменную RELEASE в файле .env, указав тег релиза новой версии:
RELEASE=<desired version>

Например, RELEASE=8.9.1.

  1. Из каталога развёртывания (папка с файлами compose и .env) выполните тот же набор файлов compose, с которым изначально поднимали стек, чтобы скачать новый образ и перезапустить контейнер dzyam.chat. Например:
docker compose -f compose.database.yml -f compose.yml up -d

Включите каждый файл compose из исходной команды развёртывания (например, мониторинг или Traefik), иначе эти сервисы выпадут из определения проекта.

Примечание. Подробнее об образах Docker dzyam.chat — в разделе Образы Docker dzyam.chat.

  1. Через несколько минут проверьте, что новый контейнер работает:
docker ps

Должен быть виден новый контейнер dzyam.chat с обновлённым тегом версии.

  1. Перейдите в Управление > Рабочее пространство, чтобы проверить обновлённую версию dzyam.chat и окно её поддержки.

Обновление MongoDB в Docker

Совет.

Если вы используете встроенные образы Bitnami MongoDB, см. сообщение на форуме о переходе на официальный образ MongoDB 8.0, необходимый для dzyam.chat 8.0.

Повышение или понижение версии MongoDB может понадобиться при переходе между мажорными релизами dzyam.chat. Данные рабочего пространства хранятся в отдельном сервисе MongoDB. Обновление контейнера dzyam.chat не меняет сохранённые данные, пока том MongoDB остаётся целым.

В этом разделе описано, как безопасно сменить версию MongoDB для dzyam.chat в Docker — и при обновлении, и при откате.

Предупреждение.

Перед продолжением ознакомьтесь с общими рекомендациями по обновлению MongoDB.

Если вы переходите на более высокую версию MongoDB:

  1. Убедитесь, что образ целевой версии есть на Docker Hub в репозитории mongodb-community-server. Ищите образ с тегом <version>-ubi8.
  2. Задайте или измените переменную MONGODB_VERSION в .env:
MONGODB_VERSION=<version>

Например, MONGODB_VERSION=8.0.

  1. Выполните команду, чтобы скачать новый образ и перезапустить контейнер MongoDB:
docker compose -f  compose.database.yml up -d

Примечание.

Подробнее об образах Docker dzyam.chat — в разделе Образы Docker dzyam.chat.

  1. Через несколько минут проверьте, что новый контейнер работает:
docker ps

Должен быть виден новый контейнер MongoDB с обновлённым тегом версии.

MongoDB не поддерживает прямой откат двоичных файлов, если файлы данных созданы более новой версией. Чтобы безопасно понизить версию, сначала уменьшите Feature Compatibility Version (FCV), и только потом меняйте образ MongoDB. Если не задать FCV до смены двоичных файлов, MongoDB завершится с ошибкой, и контейнер будет постоянно перезапускаться.

Примечание.

Перед продолжением убедитесь, что образ целевой версии есть на Docker Hub в репозитории mongodb-community-server. Ищите образ с тегом <version>-ubi8.

Чтобы понизить версию MongoDB в dzyam.chat:

  1. Перед любыми изменениями создайте полную резервную копию базы:
docker exec <mongo-container_name> sh -c 'mongodump --archive' > db.dump

Замените <mongo-container_name> на текущее имя контейнера MongoDB.

  1. Войдите в контейнер MongoDB:
docker exec -it  <mongo-container_name> bash
  1. Откройте оболочку MongoDB:
mongosh
  1. Переключитесь на базу:
use rocketchat
  1. Проверьте текущую Feature Compatibility Version:
db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })

Возвращённая версия должна совпадать с текущим двоичным файлом MongoDB (например, 8.2).

  1. Установите FCV в версию, до которой собираетесь откатиться:
db.adminCommand({
  setFeatureCompatibilityVersion: "<version>",
  confirm: true
})
  1. Убедитесь, что FCV теперь совпадает с целевой версией:
db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })
  1. Выйдите из оболочки mongo и остановите контейнер MongoDB:
docker compose -f compose.database.yml down
  1. Задайте или измените переменную MONGODB_VERSION в .env:
MONGODB_VERSION=<version>

Например, MONGODB_VERSION=8.0.

  1. Скачайте и запустите контейнер базы:
docker compose -f  compose.database.yml up -d
  1. Через несколько минут убедитесь, что новый контейнер MongoDB работает:
docker ps

Теперь работает новый контейнер MongoDB с обновлённым тегом версии.

Версию MongoDB в контейнере можно дополнительно проверить командой:

docker exec -it <mongo-container_name> mongosh --eval "db.version()"

Задание переменных окружения развёртывания dzyam.chat в Docker

Переменные окружения — дополнительные параметры, влияющие на развёртывание и конфигурацию рабочего пространства. Подробнее — в официальной документации.

Чтобы задать переменную окружения в Docker:

  1. Перейдите в каталог dzyam.chat и откройте файл compose.yml:
nano compose.yml
  1. Добавьте переменную в секцию environment сервиса rocketchat. Например, чтобы переопределить настройку SMTP Host, добавьте:
services:
  rocketchat:
    ...
    environment:
      ...
      OVERWRITE_SETTING_SMTP_Host: "my.smtp.server.com"

Подсказка.

Это та же секция, где задаются ROOT_URL, MONGO_URL и другие переменные.

  1. Перезапустите контейнер dzyam.chat, чтобы применить изменения:
docker compose stop rocketchat
docker compose rm rocketchat
docker compose up -d rocketchat

Полный список доступных переменных окружения — в статье Deployment Environment Variables.

Дополнительные операции

Резервное копирование и восстановление данных MongoDB в Docker

dzyam.chat хранит все данные рабочего пространства в MongoDB. Следуйте командам ниже, чтобы сделать резервную копию и восстановить базу при работе в Docker.

Резервная копия базы MongoDB в Docker

  1. Выведите список контейнеров Docker, чтобы найти имя сервиса MongoDB:
docker ps -a

Предупреждение.

Запомните имя контейнера mongo (например, rocketchat-mongodb-1).

  1. Выполните команду, чтобы выгрузить базу в двоичный файл db.dump:
docker exec <container_name> sh -c 'mongodump --archive' > db.dump

При успехе в текущем каталоге появится файл db.dump.

Восстановление резервной копии MongoDB в Docker

Чтобы восстановить данные, используйте mongorestore внутри контейнера MongoDB, передавая данные из локального файла db.dump.

docker exec -i <container_name> sh -c 'mongorestore --archive' < db.dump

Экспорт во внешнюю базу (например, MongoDB Atlas)

При миграции данных или автономном восстановлении локальный файл db.dump можно использовать напрямую со строкой подключения внешней MongoDB.

mongorestore --uri mongodb+srv://<user>:<password>@cluster0.w2btl.mongodb.net --archive=db.dump

Мониторинг и журналирование развёртывания

Эффективное журналирование помогает следить за состоянием развёртывания dzyam.chat. В этом разделе — журналы dzyam.chat, MongoDB и обратных прокси Traefik или Nginx.

Чтобы проверить статус и журналы контейнеров:

  1. Используйте одну из команд, чтобы посмотреть контейнеры в среде Docker:
docker ps        # Shows currently running containers with details like ID, status, and ports
docker ps -a     # Lists all containers, including stopped ones
docker compose ps  # Lists services managed by Docker Compose

Эти команды помогают найти контейнеры dzyam.chat, MongoDB, Traefik и связанных сервисов.

  1. Когда нужный контейнер или сервис найден, смотрите журналы одной из команд:
docker compose logs -f <service_name>  # Shows realtime logs for a service managed by Docker Compose
docker logs <container_name>       # Displays logs for the specific container
docker logs -f <container_name>    # Shows real-time logs for a container
docker logs --tail 10 <container_name> # Displays the last 10 lines of logs

Примечание.

  • Подставьте вместо <container_name> и <service_name> соответствующие значения.
  • dzyam.chat пишет журналы в stdout, отдельного лог-файла внутри контейнера нет. Система журналирования Docker перехватывает эти записи stdout, и они доступны через команду docker logs.
  1. Чтобы проверить состояние MongoDB, выполните:
docker exec -it <mongodb_container_name> mongosh --eval "db.runCommand({ serverStatus: 1 })"

Команда возвращает подробные сведения о состоянии сервера MongoDB.

Примечание.

Замените <mongodb_container_name> на имя контейнера MongoDB.

  1. Если в качестве обратного прокси используется Nginx, журналы хранятся в контейнере в /var/log/nginx/. Чтобы их посмотреть:
sudo tail -f /var/log/nginx/access.log  # Access logs
sudo tail -f /var/log/nginx/error.log   # Error logs