diff --git a/ops/F2-5-MATRIX-INTEGRATION-REPORT.md b/ops/F2-5-MATRIX-INTEGRATION-REPORT.md new file mode 100644 index 0000000..3b8995c --- /dev/null +++ b/ops/F2-5-MATRIX-INTEGRATION-REPORT.md @@ -0,0 +1,19 @@ +# Отчет по задаче: F2-5 Интеграция с Matrix Sprint + +**Статус:** DONE +**Дата завершения:** 2026-10-07 + +## 1. Выполненные работы +1. Runbook: Добавлен services/matrix/runbook.md с командами для Synapse/Coturn +2. Healthcheck: Создан /opt/remediation-api/check_matrix_health.sh для мониторинга API +3. Интеграция с ботом: Перезапуск CT 155 через Remediation API работает корректно +4. Двусторонняя связь: Задача моста (mautrix-telegram) вынесена в отдельный спринт + +## 2. Артефакты +- /root/buryan-infra/services/matrix/runbook.md +- /opt/remediation-api/check_matrix_health.sh +- ops/F2-5-MATRIX-INTEGRATION-REPORT.md + +## 3. Следующие шаги +- Настройка алертинга из Uptime Kuma при падении healthcheck +- Реализация Telegram-Matrix Bridge (отдельный спринт) diff --git a/services/matrix/runbook.md b/services/matrix/runbook.md index 3f03072..439e50b 100644 --- a/services/matrix/runbook.md +++ b/services/matrix/runbook.md @@ -1,10 +1,23 @@ -# Runbook: Matrix Synapse (CT 104) +# Runbook: Matrix Synapse & Coturn (CT 155) -## 1. Check status -pct exec 104 -- systemctl status matrix-synapse +## 1. Проверка статуса сервисов +pct exec 155 -- docker ps | grep -E 'synapse|coturn' +pct exec 155 -- systemctl status matrix-synapse -## 2. View logs -pct exec 104 -- journalctl -u matrix-synapse -n 50 --no-pager +## 2. Проверка здоровья (Healthcheck) +curl -s http://192.168.1.155:8008/_matrix/client/versions +curl -s https://matrix.buryans.ru/.well-known/matrix/server -## 3. Restart service -pct exec 104 -- systemctl restart matrix-synapse +## 3. Просмотр логов (последние 50 строк) +pct exec 155 -- journalctl -u matrix-synapse -n 50 --no-pager +pct exec 155 -- docker logs matrix-synapse --tail 50 + +## 4. Перезапуск сервисов +# Используйте Telegram-бота: /runbook matrix -> [Перезапустить] +# Или вручную (мягкий перезапуск): +pct exec 155 -- docker restart matrix-synapse + +## 5. Частые проблемы +- Ошибки федерации: Проверьте порт 8448 на фаерволе и DNS записи +- Высокая нагрузка CPU/RAM: Проверьте размер БД PostgreSQL (CT 151) +- Проблемы с звонками: Проверьте статус контейнера coturn