vbev.dev/CHANGELOG.md

Changelog

Все заметные изменения в инфраструктурном репозитории описываются в этом файле.

Формат ведется вручную на русском языке. В changelog попадают изменения, которые влияют на состав сервисов, версии Docker images, деплой, backup/restore, переменные окружения, секреты и эксплуатационные правила.

Будущие изменения

Пока нет.

2026-09-06

Добавлено

• Добавлен общий PostgreSQL service db на postgres:16-alpine.
• Добавлен Matrix homeserver msg на matrixdotorg/synapse:v1.160.0.
• Добавлен браузерный Matrix-клиент msg-web на vectorim/element-web:v1.12.27.
• Добавлены шаблоны runtime-конфигов:
  • config/synapse/homeserver.yaml.template;
  • config/element/config.json.template.
• Добавлен идемпотентный PostgreSQL init script ops/postgres/init-services.sh для создания/обновления service users/databases.
• Добавлены Docker secrets для generated runtime-конфигов:
  • synapse_homeserver_config;
  • element_config.

Изменено

• Deploy workflow теперь подготавливает Matrix/Element config secrets из Gitea variables/secrets в шаге Prepare configs.
• Deploy workflow теперь создает на сервере generated config secrets в secrets/, а не хранит отдельную runtime-директорию config/.
• Deploy workflow теперь перед запуском всего стека поднимает db и выполняет PostgreSQL initialization через временный postgres:16-alpine контейнер, передавая ops/postgres/init-services.sh через SSH stdin.
• .env.example оставлен только для переменных, которые напрямую использует Compose runtime; Matrix-переменные перенесены в documented Gitea variables.
• Обновлены README.md и AGENTS.md под новые service aliases db, msg и msg-web.

Конфигурация

• Добавлены Gitea variables:
  • MATRIX_SERVER_NAME;
  • MATRIX_PUBLIC_BASEURL;
  • ELEMENT_WEB_URL.
• Добавлены Gitea secrets:
  • POSTGRES_ADMIN_PASSWORD;
  • SYNAPSE_POSTGRES_PASSWORD;
  • SYNAPSE_REGISTRATION_SHARED_SECRET.
• Добавлены runtime secret files:
  • secrets/postgres_admin_password.txt;
  • secrets/synapse_postgres_password.txt;
  • secrets/synapse_homeserver_config.yaml;
  • secrets/element_config.json.

Эксплуатация

• Для msg и msg-web нужно настроить proxy hosts в Nginx Proxy Manager:
  • matrix.example.com -> http://msg:8008;
  • chat.example.com -> http://msg-web:80.
• MATRIX_SERVER_NAME нужно выбрать до первого запуска Matrix homeserver, так как он становится частью Matrix ID пользователей.
• Регистрация в Synapse закрыта; пользователей нужно создавать вручную через register_new_matrix_user.
• Generated config files в secrets/ считаются sensitive, но должны оставаться читаемыми для Docker Compose file secrets.
• В AGENTS.md добавлено правило обновлять CHANGELOG.md при заметных изменениях инфраструктуры, деплоя, переменных, секретов и эксплуатационных правил.

2026-08-23

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

• Добавлен CHANGELOG.md с историей заметных изменений по git history с начала репозитория.

2026-08-22

Изменено

• Зафиксирована версия Vaultwarden: vaultwarden/server:1.37.1 вместо vaultwarden/server:latest.
• Deploy workflow теперь выполняет docker compose pull перед docker compose up -d --remove-orphans.
• В README.md добавлено правило фиксировать версии stateful-сервисов и обновлять их отдельным изменением после просмотра release notes и backup.

Исправлено

• Восстановлена совместимость Vaultwarden с актуальным расширением Bitwarden для браузера. Старый backend 1.36.0 не загружал хранилище в новом расширении.

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

• Добавлен README.md с описанием сервисов, переменных, секретов, локальных операций, данных, деплоя и правил сопровождения.
• Добавлен AGENTS.md с инструкциями для AI-агентов и автоматизации в этом репозитории.

2026-07-26

Добавлено

• Добавлены сервисы RustDesk:
  • sup-hbbs для ID/rendezvous server;
  • sup-hbbr для relay server.
• Для Nginx Proxy Manager открыты порты RustDesk: 21116/tcp, 21116/udp, 21117/tcp.
• Добавлена переменная RUSTDESK_DOMAIN в .env.example и deploy workflow.

2026-07-06

Добавлено

• Добавлен healthcheck для git-runner через endpoint http://127.0.0.1:9101/healthz.

2026-07-05

Изменено

• Backup-шаг deploy workflow стал опциональным через Gitea variable DEPLOY_BACKUP_ENABLED.
• Режим dry-run для деплоя вынесен в Gitea variable DEPLOY_DRY_RUN_ENABLED.

2026-07-04

Добавлено

• Deploy workflow переведен на полноценный Gitea Actions процесс:
  • checkout репозитория;
  • нормализация имени ref/branch;
  • настройка SSH-клиента;
  • создание удаленного docker-compose-<ref>.yml;
  • создание .env и файлов в secrets/;
  • запуск Compose на сервере;
  • Telegram-уведомления и отправка deploy log.
• Добавлен workflow для проверки Telegram deploy bot.
• Добавлен .env.example с базовыми переменными окружения.
• Добавлен backup data/ перед деплоем с хранением архивов в backups/.

Изменено

• DEPLOY_DIRECTORY перенесен из secrets в Gitea variables.
• Backup выполняется через sudo, чтобы избежать ошибок прав доступа к runtime-данным.
• Исправлена передача пароля в sudo при backup.
• Удален временный demo workflow и неиспользуемый action для экранирования Telegram-сообщений.
• Идеи по развитию вынесены из репозитория в wiki.

2026-06-16

Добавлено

• Создан начальный Docker Compose стек:
  • prx на jc21/nginx-proxy-manager:2.15.1;
  • pwd на vaultwarden/server:latest;
  • mon на henrygd/beszel;
  • mon-agent на henrygd/beszel-agent;
  • cld на nextcloud:30.0.6;
  • git на docker.gitea.com/gitea:1.26.2.
• Добавлены bind mounts в data/ для persistent-данных сервисов.
• Добавлены Docker secrets для Vaultwarden и Beszel.
• Добавлена сеть Compose vbevdev.
• Добавлен .gitignore для локальных данных, секретов, .env, .vscode и .DS_Store.
• Добавлен сервис git-runner на gitea/act_runner:latest.
• Добавлен healthcheck для git и зависимость git-runner от здорового git.
• Добавлен черновой deploy workflow для Gitea Actions.