Инструкции

Что такое Mattermost Mattermost — платформа для корпоративных коммуникаций, которая позволяет собрать рабочее общение в одном месте и структурировать его по командам, проектам и темам. Можно воспринимать Mattermost как решение для организаций, которым важно самостоятельно контролировать корпоративные данные. Есть версия, которую можно развернуть на собственной инфраструктуре и хранить сообщения, файлы и служебную информацию во внутреннем контуре. В общем, если предъявляются повышенные требования к информационной безопасности, то этот мессенджер может как раз подойти. Подготовка инфраструктуры Mattermost имеет довольно скромные требования для малых и средних команд: до 1 000 пользователей достаточно 1 vCPU и 2 GB RAM; до 2 000 — потребуются 2 vCPU и 4 GB RAM; свыше 2 000 — предлагается использовать Enterprise Edition и инсталляцию из нескольких серверов. В качестве внешних зависимостей Mattermost требует любой популярный дистрибутив Linux и СУБД PostgreSQL 14.0 или выше. Мы рассмотрим развертывание Mattermost для маленькой команды и будем использовать один виртуальный сервер. Так как 1 vCPU и 2 GB RAM нужны для самого Mattermost, а сервер также должен вмещать СУБД, то разумным выбором кажется конфигурация 2 vCPU и 4 GB RAM. Заказ облачного сервера. Заходим в панель управления Selectel, выбираем Продукты → Облачные серверы → Создать сервер. Возьмем 2 vCPU, 4 GB RAM, 40 GB NVMe и Ubuntu 24.04 в Санкт-Петербурге. Когда вся информация заполнена, нажимаем Создать сервер. После создания в карточке сервера появится инструкция по подключению. Проверяем. Mattermost — это платформа для человеческого общения, поэтому сразу же создаем доменную запись для созданного сервера. Например, chat.example.com. Купить новый домен или делегировать существующий можно не выходя из панели управления Selectel. Развертывание Mattermost В документации Mattermost указаны три способа развертывания. Mattermost Kubernetes Operator — развертывание в Kubernetes, со всеми удобствами контейнерной платформы. Linux — установка непосредственно в операционную систему. Простое, но надежное решение, если Kubernetes не используется или не является предпочительным. Docker — запуск в самостоятельных контейнерах возможен, но не рекомендован для использования в реальных проектах, только для тестирования. Мы рассмотрим вариант установки Mattermost в операционную систему. Такой способ и проще, и вместе с тем рекомендован для полноценного использования. Для развертывания необходимо пройти несколько простых шагов, установив четыре компонента: фаервол; СУБД для хранения данных; обратный прокси, который возьмет на себя задачу обеспечения HTTPS; непосредственно Mattermost. Приступим. Установка UFW Сперва защитим виртуальную машину. Фаервол логично подключать в самом начале. Во-первых, он автоматически «прикроет» административные порты, которые могут открываться по умолчанию при установке ПО. Во-вторых, ошибка в конфигурации фаервола может привести к потере доступа к виртуальной машине, а в начале пути такая ошибка стоит дешевле. Затем разрешаем SSH, HTTP, HTTPS и выбираем политику по умолчанию: не пускать. Отлично, защита настроена. Продолжаем. Установка PostgreSQL PostgreSQL уже есть в стандартных репозиториях Ubuntu. На момент написания статьи актуальная версия — 18, а менеджер пакетов устанавливает 16‑ю. Впрочем, этого достаточно, так как минимальное требование — 14‑я или новее. Теперь нужно подготовить базу для Mattermost. Открываем psql: Вводим команды SQL: Обратите внимание, что mmuser-password — это пароль пользователя к базе данных. Он используется исключительно в качестве примера и читаемости. При установке нужно сгенерировать новый надежный пароль и хранить его в тайне. На этом установка базы данных завершена. Установка nginx Nginx — это легковесный веб-сервер и обратный прокси. В нашем примере он возьмет на себя задачи поддержки HTTPS, а также логирования запросов. В больших инсталляциях nginx также обеспечивает балансирование нагрузки между несколькими серверами Mattermost. Как и ранее, nginx доступен в стандартных репозиториях Ubuntu, но там устаревшая версия, поэтому добавляем официальный APT-репозиторий. Убеждаемся, что ключ содержит отпечаток: 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62 Проверим подлинность репозитория, получив информацию о скачанном GPG‑ключе без его фактической установки в систему: Убедившись в совпадении ключа, добавляем репозиторий в список источников. Устанавливаем nginx. По умолчанию в nginx есть заглушка, на которой можно протестировать работоспособность. Открываем файл /etc/nginx/conf.d/default.conf и редактируем директиву server_name. Было: Стало: Теперь запускаем nginx: Проверяем, что заглушка доступна по указанному домену. Заглушка nginx. Веб-сервер отдает страницу, но браузер подсвечивает, что подключение не защищено, то есть используется открытый HTTP вместо шифрованного HTTPS. Исправим. Подключение SSL для домена Устанавливаем certbot — программу, которая создает сертификаты Let’s Encrypt для доменов. Установим дополнительно плагин для nginx, что позволит подключить к нему HTTPS за меньшее количество действий. Обратите внимание, что домен, на который выписывается сертификат, должен быть указан в файлах конфигурации nginx. Мы уже это сделали, поэтому просто выписываем сертификат. В процессе работы программа уточнит email-адрес (обязательно), спросит согласие с условиями сервиса (обязательно) и поинтересуется желанием поделиться почтовым адресом с партнерами (опционально). Выглядит это так: Еще раз заходим на chat.example.com и видим, что подключение защищено. Программу certbot удалять не нужно, так как она автоматически продлевает сертификат, срок которого истекает через три месяца. Теперь можем перейти к установке главного компонента. Установка Mattermost Как и в случае с nginx, необходимо добавить официальный APT-репозиторий. Затем устанавливаем mattermost. Mattermost устанавливается в /opt/mattermost и создает пользователя mattermost, а также одноименную группу. Однако, сервис не стартует по умолчанию и не ожидает запуска базы данных. Редактируем файл /lib/systemd/system/mattermost.service и в конец секции добавляем следующие строки: Затем даем команду перечитать systemd-юниты: Теперь настраиваем Mattermost. Сперва копируем стандартый файл конфигурации: А затем редактируем /opt/mattermost/config/config.json. Изменяем следующие значения: SqlSettings.DriverName — имя драйвера для подключения к СУБД, указываем postgres; SqlSettings.DataSource — строка подключения к базе данных, в нашем случае postgres://mmuser:mmuser-password@127.0.0.1:5432/mattermost?sslmodedisable&connect_timeout10; ServiceSettings.SiteURL — домен, на котором развернут сервис, https://chat.example.com. SupportSettings.SupportEmail — адрес, на который пользователи могут обратиться в случае проблем. Запускаем Mattermost. Теперь, когда Mattermost работает, он слушает все подключения на порту 8065. К счастью, настроенный фаервол ограничивает подключения из интернета и ничего непоправимого не случилось. Осталось подружить Mattermost и nginx. Открываем /etc/nginx/conf.d/default.conf, добавляем upstream, указывающий на наш mattermost и заменяем директивы location. После правок файл должен выглядеть так: Перезагружаем файл конфигурации nginx: Теперь Mattermost ждет нас! Настройка Mattermost Стартовое окно Mattermost. При первом запуске Mattermost предложит зарегистрироваться. Заполняем почту, ник и пароль. Первому пользователю также будет предложено назвать организацию, выбрать интеграции с инструментами разработки и скопировать ссылку для приглашения коллег. Обучение Mattermost. Обратите внимание, что первый зарегистрировавшийся пользователь будет иметь права администратора, так что после настройки nginx не затягивайте с регистрацией. В верхнем правом углу есть меню, из которого можно попасть в «админ-панель» — «System console». В этом меню можно: управлять лицензией; администрировать пользователями и каналами; добавлять интеграции; настраивать параметры Mattermost. Именно на этом моменте заканчивается общая инструкция и начинается тонкая настройка под свои нужды. Заключение Mattermost — это хороший инструмент для корпоративного общения, подходящий для маленьких коллективов. Простая развертываемость на собственной инфраструктуре и небольшое потребление ресурсов делают его отличным решением с маленькими затратами.

Инструкции

Зарегистрируйтесь в панели управления