Mattermost - это платформа для обмена мгновенными сообщениями с открытым исходным кодом, самостоятельная альтернатива Slack. Он написан на Golang и React и может использовать MySQL или PostgreSQL в качестве базы данных. Mattermost объединяет все ваши командные коммуникации и предоставляет различные функции, включая обмен файлами, индивидуальные и групповые сообщения, пользовательские смайлики, видеозвонки и многое другое. В этом руководстве мы покажем вам, как развернуть Mattermost на сервере CentOS 7 и настроить Nginx в качестве обратного прокси-сервера SSL.

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

• Вы вошли как пользователь с привилегиями sudo .
• У вас есть доменное имя, указывающее на IP-адрес вашего сервера. Мы будем использовать linuxize-test.com.
• У вас установлен Nginx
• У вас установлен сертификат SSL для вашего домена. Вы можете установить бесплатный SSL-сертификат Let's Encrypt, следуя этому руководству.

Создать базу данных MySQL 

Мы будем использовать MariaDB 10.3 в качестве базы данных. Маттермост не будет работать с MariaDB версии 5.5.

Если на вашем сервере не установлен MariaDB 10.3, вы можете проверить это руководство .

Войдите в оболочку MySQL:

mysql -u root -p

    И выполните следующие команды, чтобы создать новую базу данных и пользователя для нашей установки Mattermost:

create database mattermost;GRANT ALL ON mattermost.* TO mattermost@localhost IDENTIFIED BY 'P4ssvv0rD';

Создать нового пользователя системы 

Чтобы создать нового пользователя и группу с именем mattermost, которые будут запускать установку Mattermost, выполните следующую команду:

sudo useradd -U -M -d /opt/mattermost mattermost

Установите сервер Mattermost 

На момент написания этой статьи последняя стабильная версия Mattermost - это версия 5.4.0. Прежде чем перейти к следующему шагу, вы должны проверить страницу загрузки Mattermost, чтобы увидеть, доступна ли более новая версия.

    Загрузите архив с помощью следующей команды curl :

sudo curl -L https://releases.mattermost.com/5.4.0/mattermost-5.4.0-linux-amd64.tar.gz -o /tmp/mattermost.tar.gz

    После завершения загрузки распакуйте архив и переместите его в opt каталог:

sudo tar zxf /tmp/mattermost.tar.gz -C /opt

    Создайте каталог для хранения файлов:

sudo mkdir /opt/mattermost/data

Измените владельца каталога на mattermost пользователя:

sudo chown -R mattermost: /opt/mattermost

    Откройте config.json файл в текстовом редакторе :

sudo nano /opt/mattermost/config/config.json

    Установите драйвер базы данных на mysql, введите имя базы данных и пароль пользователя базы данных, которые мы создали ранее в этом руководстве:

...
"SqlSettings": {
    "DriverName": "mysql",
    "DataSource": "mattermost:P4ssvv0rD@tcp(localhost:3306)/mattermost?charset=utf8mb4,utf8&readTimeout=30s&writeTimeout=30s",
    "DataSourceReplicas": [],
...

Чтобы протестировать нашу установку и убедиться, что все работает, прежде чем создавать модуль systemd и настраивать обратный прокси-сервер с Nginx, мы запустим сервер Mattermost.

Перейдите в /opt/mattermost каталог и запустите сервер:

cd /opt/mattermostsudo -u mattermost bin/mattermost

Вывод должен показать, что сервер Mattermost прослушивает порт 8065 :

{"level":"info","ts":1540921243.6797202,"caller":"app/plugin.go:100","msg":"Starting up plugins"}
{"level":"info","ts":1540921244.3483207,"caller":"app/server.go:88","msg":"Starting Server..."}
{"level":"info","ts":1540921244.3488805,"caller":"app/server.go:148","msg":"Server is listening on [::]:8065"}
{"level":"info","ts":1540921244.3620636,"caller":"app/web_hub.go:75","msg":"Starting 2 websocket hubs"}
{"level":"info","ts":1540921244.451155,"caller":"jobs/workers.go:63","msg":"Starting workers"}
{"level":"info","ts":1540921244.456804,"caller":"jobs/schedulers.go:68","msg":"Starting schedulers."}

    Теперь вы можете остановить сервер Mattermost CTRL+C и перейти к следующим шагам.

Создать системный блок

Чтобы запустить наш экземпляр Mattermost в качестве службы, мы создадим в mattermost.service каталоге файл модуля /etc/systemd/system/  со следующим содержимым:

[Unit]
Description=Mattermost
After=network.target nss-lookup.target mariadb.service

[Service]
Type=notify
WorkingDirectory=/opt/mattermost
User=mattermost
SyslogIdentifier=mattermost
ExecStart=/opt/mattermost/bin/mattermost
TimeoutStartSec=3600
LimitNOFILE=49152

[Install]
WantedBy=multi-user.target

Сообщите systemd, что мы создали новый файл модуля, и запустите службу Mattermost, выполнив:

sudo systemctl daemon-reloadsudo systemctl start mattermost

    Теперь мы можем проверить статус сервиса с помощью следующей команды:

sudo systemctl status mattermost

● mattermost.service - Mattermost
   Loaded: loaded (/etc/systemd/system/mattermost.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2018-10-30 17:44:46 UTC; 3s ago
 Main PID: 25959 (mattermost)
   CGroup: /system.slice/mattermost.service
           └─25959 /opt/mattermost/bin/mattermost

    Наконец, включите службу Mattermost для автоматического запуска во время загрузки:

sudo systemctl enable mattermost

Настройте обратный прокси с Nginx 

Если вы следовали нашим инструкциям по установке Nginx на CentOS 7 и защите Nginx с помощью руководств Let's Encrypt на CentOS 7, у вас уже должен быть установлен и настроен Nginx с SSL-сертификатом. Теперь нам нужно только создать новый блок сервера для нашей установки Mattermost.
   

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=mattermost_cache:10m max_size=3g inactive=120m use_temp_path=off;

upstream mattermost_backend {
  server 127.0.0.1:8065;
}

server {
    listen 80;
    server_name linuxize-test.com www.linuxize-test.com;

    include snippets/letsencrypt.conf;
    return 301 https://linuxize-test.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name www.linuxize-test.com;

    ssl_certificate /etc/letsencrypt/live/linuxize-test.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/linuxize-test.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/linuxize-test.com/chain.pem;
    include snippets/ssl.conf;

    return 301 https://linuxize-test.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name linuxize-test.com;

    ssl_certificate /etc/letsencrypt/live/linuxize-test.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/linuxize-test.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/linuxize-test.com/chain.pem;
    include snippets/ssl.conf;

    access_log /var/log/nginx/linuxize-test.com-access.log;
    error_log /var/log/nginx/linuxize-test.com-error.log;

   location ~ /api/v[0-9]+/(users/)?websocket$ {
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection "upgrade";
       client_max_body_size 50M;
       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 $scheme;
       proxy_set_header X-Frame-Options SAMEORIGIN;
       proxy_buffers 256 16k;
       proxy_buffer_size 16k;
       proxy_read_timeout 600s;
       proxy_pass http://mattermost_backend;
   }

   location / {
       proxy_http_version 1.1;
       client_max_body_size 50M;
       proxy_set_header Connection "";
       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 $scheme;
       proxy_set_header X-Frame-Options SAMEORIGIN;
       proxy_buffers 256 16k;
       proxy_buffer_size 16k;
       proxy_read_timeout 600s;
       proxy_cache mattermost_cache;
       proxy_cache_revalidate on;
       proxy_cache_min_uses 2;
       proxy_cache_use_stale timeout;
       proxy_cache_lock on;
       proxy_pass http://mattermost_backend;
   }
}

Перезагрузите службу Nginx, чтобы изменения вступили в силу:

sudo systemctl reload nginx

Настройка Mattermost 

Откройте браузер, введите свой домен и создайте свой первый аккаунт:

Первый созданный пользователь в системе имеет права администратора.

Нажмите на Create a new team ссылку, создайте свою первую команду и установите URL команды:

    После того, как вы создадите первую учетную запись администратора и первую группу, вы будете перенаправлены на панель инструментов Mattermost, вошедшую в систему как администратор. Откройте системную консоль, нажав свое имя пользователя в верхней части панели навигации, и в новом открывшемся меню нажмите на System Console ссылку:

Задайте URL-адрес сайта, выбрав «Настройки» → «Конфигурация».

    Включите уведомления по электронной почте, перейдя в Уведомления → Электронная почта

и введите параметры SMTP. Вы можете использовать любые популярные сервисы электронной почты, такие как SendinBlue, SendGrid, Amazon SES, Mandrill, Mailgun, Mailjet и Postmark, или вы можете настроить свой собственный почтовый сервер .

Наконец, нам нужно перезапустить службу Mattermost, чтобы изменения вступили в силу:

sudo systemctl restart mattermost

Вывод 

Вы успешно установили Mattermost на своем сервере CentOS 7 и настроили Nginx в качестве обратного прокси-сервера. Теперь вы можете начать использовать Mattermost для совместной работы с вашей командой.