Introduzione
Mattermost è una piattaforma di messaggistica istantanea di livello enterprise, un'alternativa Slack self-hosted open source. È scritto in Golang e React e può usare MySQL o PostgreSQL come back-end del database. Mattermost riunisce tutte le comunicazioni del tuo team in un unico posto e offre varie funzionalità tra cui condivisione di file, messaggistica individuale e di gruppo, emoji personalizzati, videochiamate e altro ancora.
In questo tutorial, installeremo Mattermost su un server Ubuntu 18.04 e configureremo Nginx come proxy inverso con SSL HTTPS.
Prerequisiti
Assicurati di aver soddisfatto i seguenti prerequisiti prima di continuare con questo tutorial:
- Hai effettuato l'accesso come utente con privilegi sudo.
- Hai un nome di dominio che punta all'indirizzo IP del tuo server. In questo articolo useremo
example.com. - Hai installato Nginx, in caso contrario consulta questa guida.
- Hai un certificato SSL installato per il tuo dominio. Puoi installare un certificato SSL Let's Encrypt gratuito seguendo questa guida.
Se desideri installare Mattermost su un server in remoto continua a leggere, altrimenti salta il primo paragrafo "Connessione al Server" e leggi il successivo.
Connessione al Server
Per accedere al server, è necessario conoscere l'indirizzo IP. Avrai anche bisogno dell'username e della password per l'autenticazione. Per connettersi al server come utente root digitare il seguente comando:
ssh root@IP_DEL_SERVERSuccessivamente sarà necessario inserire la password dell'utente root.
Se non utilizzate l'utente root potete connettervi con un'altro nome utente utilizzando lo stesso comando, quindi modificare root con il vostro nome_utente:
ssh nome_utente@IP_DEL_SERVERSuccessivamente vi verrà chiesto di inserire la password del vostro utente.
La porta standard per connettersi tramite ssh è la 22, se il vostro server utilizza una porta diversa, sarà necessario specificarla utilizzando il parametro -p, quindi digitare il seguente comando:
ssh nome_utente@IP_DEL_SERVER -p PORTACreare un database MySQL
Useremo MySQL come database per Mattermost. Se non hai MySQL o MariaDB installati sul tuo server, puoi installarlo seguendo queste istruzioni.
Accedi alla shell MySQL:
sudo mysql -u rootAltrimenti se hai impostato una password per l'utente root, utilizza il seguente comando per accedere alla shell MySQL:
sudo mysql -u root -pCrea un nuovo database e utente per la nostra installazione Mattermost con:
CREATE DATABASE mattermost;GRANT ALL ON mattermost.* TO mattermost@localhost IDENTIFIED BY 'P4ssvv0rD';exit;Assicurati di utilizzare una password più sicura di P4ssvv0rD.
Creare un nuovo utente di sistema
Crea un nuovo utente e gruppo che eseguirà la nostra istanza Mattermost. Chiameremo l'utente mattermost:
sudo useradd -U -M -d /opt/mattermost mattermostInstallare Mattermost Server
Al momento della stesura di questo articolo, l'ultima versione stabile di Mattermost è la versione 5.19.1. Scarica l'archivio con il seguente comando curl:
sudo curl -L https://releases.mattermost.com/5.19.1/mattermost-5.19.1-linux-amd64.tar.gz -o /tmp/mattermost.tar.gzUna volta completato il download, estrarre l'archivio e spostarlo nella directory /opt:
sudo tar zxf /tmp/mattermost.tar.gz -C /optCreare la directory di archiviazione per i file:
sudo mkdir -p /opt/mattermost/dataCambia la proprietà della directory per l'utente mattermost:
sudo chown -R mattermost: /opt/mattermostApri il file /opt/mattermost/config/config.json, imposta il driver del database su mysql e inserisci le informazioni del database:
sudo nano /opt/mattermost/config/config.jsonCerca il parametro SqlSetting, modifica il valore DriverName e DataSource:
"SqlSettings": {
"DriverName": "mysql",
"DataSource": "mattermost:P4ssvv0rD@tcp(localhost:3306)/mattermost?charset=utf8mb4,utf8&readTimeout=30s&writeTimeout=30s",Per assicurarci che la nostra istanza Mattermost funzioni come previsto testeremo il server Mattermost. Passare alla directory /opt/mattermost e avviare il server con i seguenti comandi:
cd /opt/mattermostsudo -u mattermost bin/mattermostSe tutto funziona bene, il server verrà avviato e l'output avrà un aspetto simile al seguente:
{"level":"info","ts":1532546921.941638,"caller":"app/server.go:115","msg":"Starting Server..."}
{"level":"info","ts":1532546921.9421031,"caller":"app/server.go:154","msg":"Server is listening on [::]:8065"}
{"level":"info","ts":1532546921.9541554,"caller":"app/web_hub.go:75","msg":"Starting 2 websocket hubs"}
Ora possiamo arrestare il server Mattermost con CTRL+C e continuare con i passaggi successivi.
Crea un'unità Systemd
Per eseguire la nostra istanza Mattermost come servizio creeremo un file mattermost.service di unità nella directory /etc/systemd/system/.
Apri il tuo editor di testo e crea il seguente file:
sudo nano /etc/systemd/system/mattermost.service[Unit]
Description=Mattermost
After=network.target
After=mysql.service
Requires=mysql.service
[Service]
Type=notify
ExecStart=/opt/mattermost/bin/mattermost
TimeoutStartSec=3600
Restart=always
RestartSec=10
WorkingDirectory=/opt/mattermost
User=mattermost
Group=mattermost
LimitNOFILE=49152
[Install]
WantedBy=mysql.service
Notifica a systemd che abbiamo creato un nuovo file di unità e avvia il servizio Mattermost con i seguenti comandi:
sudo systemctl daemon-reloadSe non ci sono errori, abilitare il servizio Mattermost per l'avvio automatico all'avvio:
sudo systemctl enable mattermostAvviare il servizio:
sudo systemctl start mattermostOra possiamo controllare lo stato del servizio con:
sudo systemctl status mattermost● mattermost.service - Mattermost
Loaded: loaded (/etc/systemd/system/mattermost.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2020-02-08 20:24:36 CET; 4s ago
Main PID: 21884 (mattermost)
Tasks: 16 (limit: 2298)
CGroup: /system.slice/mattermost.service
├─21884 /opt/mattermost/bin/mattermost
└─21912 plugins/com.mattermost.nps/server/dist/plugin-linux-amd64Impostare un proxy inverso con Nginx
Se hai seguito le nostre istruzioni su come installare Nginx su Ubuntu 18.04 e su come proteggere Nginx con Let's Encrypt su Ubuntu 18.04 , dovresti avere già installato e configurato Nginx con certificato SSL.
Ora dobbiamo impostare il blocco server per l'istanza Mattermost. Apri il tuo editor di testo e crea/modifica il seguente file:
sudo nano /etc/nginx/sites-available/example.comproxy_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 {
if ($host = www.example.com) {
return 301 https://$host$request_uri;
}
if ($host = example.com) {
return 301 https://$host$request_uri;
}
listen 80;
listen [::]:80;
server_name example.com www.example.com;
return 404; # managed by Certbot
}
server {
listen [::]:443 ssl ipv6only=on; # managed by Certbot
listen 443 ssl; # managed by Certbot
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
access_log /var/log/nginx/example.com-access.log;
error_log /var/log/nginx/example.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;
}
}
Ricarica il servizio Nginx per rendere effettive le modifiche:
sudo systemctl reload nginxConfigurare Mattermost
Apri il tuo browser, digita il tuo dominio e verrai reindirizzato alla pagina di sugnup.
Inserisci la tua email, scegli un nome utente e una password e fai clic sul pulsante Create Account per creare il tuo primo account.
Il primo utente creato nel sistema avrà i privilegi di amministratore.
Nel passaggio successivo la procedura guidata di configurazione ti chiederà di creare un nuovo team.
Fare clic sul collegamento Create a new team, inserire il primo team e fare clic sul pulsante Next.
Nel passaggio successivo ti verrà chiesto di scegliere l'indirizzo web del tuo nuovo team.
Fai clic sul pulsante Finish e verrai reindirizzato alla dashboard Mattermost, effettuato l'accesso come amministratore.
Apri la Console di sistema, facendo clic sul tuo nome utente nella parte superiore del pannello di navigazione e nel nuovo menu che si apre, fai clic sul collegamento System Console.
Imposta l'URL del sito andando su Impostazioni generali → Configurazione.
Per abilitare le notifiche e-mail, vai su Notifiche → E-mail, modifica il valore di Enable Email Notifications da false a true e inserisci i parametri SMTP.
Puoi utilizzare tutti i più diffusi servizi di posta elettronica transazionali come SendinBlue, SendGrid, Amazon SES, Mandrill, Mailgun, Mailjet e Postmark oppure puoi configurare il tuo server di posta seguendo questo tutorial.
Infine, è necessario riavviare il servizio Mattermost per rendere effettive le modifiche:
sudo systemctl restart mattermostConclusione
Hai installato con successo Mattermost sul tuo server Ubuntu 18.04 e impostato Nginx come proxy inverso. Ora puoi iniziare a utilizzare Mattermost per collaborare con il tuo team.
