部署 Mattermost Omnibus 伺服器並上傳 Focalboard 插件（模組）

蔡秀吉
June 05, 2024
官方指南：Install Mattermost Omnibus

目錄

• 部署 Mattermost Omnibus 伺服器並上傳 Focalboard 插件（模組）
  • 前言
  • 在新增 apt 儲存庫之前刪除舊金鑰
  • 設定儲存庫
  • 安裝 Mattermost Omnibus
  • 下載 Boards 模組(mattermost plugin focalboard)
  • 啟用模組上傳功能並調整上傳容量限制
    • 要如何上傳模組至你的 Mattermost 伺服器呢？
    • 在Mattermost Omnibus 伺服器新增一個Boards
    • 關於本篇技術文檔作者

前言

今年 COSCUP 2024 本人的社群議程有幸被錄取。由於受到 Trello 免費版政策調整的影響，所以今年 COSCUP 也轉戰 Mattermost 一個開源的專案管理團隊協作工具。

2024年5月20日之後，Trello 免費工作區將限制為 10 名協作者，包括成員、訪客和待處理邀請。

Focalboard 是 Mattermost 的一個插件，但由於 Focalboard 整合進了 Mattermost 生態系統，所以現在會叫做 Mattermost Boards。

官方註解：Boards 已不再是 Mattermost 預設產品的一部分，目前作為插件使用。(資料來源)

本指南主要教學如何在你的虛擬機（VM）或實例（Instance）上面，安裝 Mattermost Omnibus 伺服器，並安裝 Focalboard 模組（插件）。

我安裝 Mattermost Omnibus 這個版本的原因，是因為我們是一個任務型組織，且人數不多，同時希望實現工作和生活分割。因此，如果你和我們一樣是屬於小型團隊（如：實驗室小組、任務性團隊）人數和需求不大，用不到太多華麗的功能，剛好硬體資源也不多，那麼安裝 Mattermost Omnibus 將會是你最佳的選擇。

因為 Mattermost Omnibus 是一個封裝好的安裝程序，它將部署 Mattermost 伺服器所需的所有先決套件（如：PostgreSQL 資料庫、部屬 Nginx 代理）全部整合其中，簡化了安裝過程，減少維運成本，讓你可以輕鬆快速地部署和運行 Mattermost。

官方建議：如果你會將 Mattermost 伺服器和資料庫運作在同一個系統上，那麼推薦安裝 Mattermost Omnibus。

由於 Omnibus 僅支援 Ubuntu 發行版。所以作業系統只能安裝：

• Ubuntu Focal - 20.04 LTS
• Ubuntu Jammy - 22.04 LTS

在新增 apt 儲存庫之前刪除舊金鑰

• 對於 Ubuntu Focal - 20.04 LTS：

sudo apt-key del A1B31D46F0F3A10B02CF2D44F8F2C31744774B28
curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg | gpg --dearmor | sudo apt-key add

• 對於 Ubuntu Jammy - 22.04 LTS：

sudo rm /usr/share/keyrings/mattermost-archive-keyring.gpg
curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg |  gpg --dearmor | sudo tee /usr/share/keyrings/mattermost-archive-keyring.gpg > /dev/null

設定儲存庫

新增 Mattermost PPA 的資料庫。請在終端機視窗中，執行以下設定儲存庫的命令：

curl -o- https://deb.packages.mattermost.com/repo-setup.sh | sudo bash

這條命令設置了 PostgreSQL 資料庫所需的軟體來源，並設置 NGINX Web 伺服器作為代理，配置 certbot，用來簽發和更新 SSL 證書，並設置了 Mattermost Omnibus 的軟體來源以便執行安裝的命令。

請注意，由於下一步是安裝 Mattermost Omnibus，所以執行了下面那個 安裝 Mattermost Omnibus 的命令後，系統會要求你提供一個指定網域名稱和電子郵件地址來簽發憑證。這兩個資訊將用於產生證書和發送相關通知。並且，安裝完所有軟體套件後，Omnibus 會執行 ansible 腳本來設定所有平台元件並啟動伺服器。

因此在此之前你必須要：

1. 確定你購買的網域其 DNS A 紀錄有正確的被設置，使網域能夠正確的被解析到你伺服器的ip（請前往你購買 domain 的網站 如：godaddy，調整 DNS 管理的設置，將所有 Type A 的紀錄（包含 @ 和 www）的 RDATA，都要改成你伺服器中用於對外的 IP）

更改成你伺服器用於對外的ip，讓你無論您輸入 IP 位址或網域名稱，都可以連線至你的 Mattermost 伺服器。

2. 確保伺服器的防火牆和安全組設定允許外部使用 HTTP (80) 和 HTTPS (443) 的 port 來訪問。

如果你的 Mattermost 伺服器託管在雲平台（如 AWS、Google Cloud、Azure 或 openstack）上，你可能會需要調整安全組（Security Groups）規則，新增 HTTP (80) 和 HTTPS (443) ，並允許從任何來源（或限定的 IP 範圍）的訪問。

3. 確保 NGINX 配置允許訪問 （不一定需要）

需要確保 NGINX 的配置文件有被正確的設定，以允許 Let's Encrypt 的認證機構訪問你的網站進行驗證。

server {
    listen 80;
    server_name your_domain.com;  # 替換成您的域名

    location /.well-known/acme-challenge/ {
        root /var/www/html;  # 確保這個路徑是可以訪問的並對應到您的網站目錄
        try_files $uri =404;
    }

    # 重定向所有 HTTP 流量到 HTTPS
    location / {
        return 301 https://$server_name$request_uri;
    }
}

sudo nginx -t  # 檢查配置文件是否有語法錯誤
sudo systemctl reload nginx  # 重新加載 NGINX

這些前提都處理完成之後，就可以進入下一步安裝 Mattermost Omnibus了。

安裝 Mattermost Omnibus

在終端機視窗中，執行以下命令來安裝 Omnibus。

sudo apt install mattermost-omnibus -y

輸入這行指令後，系統會叫你填寫網域，而後是你的電子信箱，用於發生警告時與你聯繫。

如果有設置正確，那到這邊基本上就是大功告成了！你可以在瀏覽器的網址列輸入你購買的網域或是伺服器用於對外的ip，應該就會進入註冊 mattermost 使用者的介面。

如果伺服器用於內部使用，你可以直接使用服務器的 IP 地址作為網域名稱，但不推薦直接將IP暴露在外網。

不過你也可以執行下面這條指令，讓你的 mattermost 伺服器處在最新版本。

sudo apt update && sudo apt upgrade

請注意：如果在設置域名的環節出錯，請使用下列這條命令來重新配置 Mattermost，這次請使用正確（有效）的域名而不是 IP 地址。

dpkg-reconfigure mattermost-omnibus

其餘關於備份、刪除、設置 Mattermost　伺服器的細節，請詳閱 安裝 Mattermost Omnibus 的官方指南，

下載 Boards 模組(mattermost plugin focalboard)

Mattermost Omnibus 是沒有預裝 Boards 的，也無法在模組市集內找到，因此需要手動下載 focalboard plugin，並手動上傳至 Mattermost Omnibus。

你可以到這邊手動下載最新版本的 focalboard plugin。

請下載：mattermost-plugin-focalboard.tar.gz #這個名稱的檔案

啟用模組上傳功能並調整上傳容量限制

要如何上傳模組至你的 Mattermost 伺服器呢？

登入你的 Mattermost 伺服器，轉到系統控制台（System Console）–> 模組管理（Plugin Management）。

登入Mattermost 伺服器之後，可以將平台語言換成繁體中文。

抵達圖中紅框處，模組管理這個頁面

到了模組管理的頁面，你會發現雖然上傳功能沒有被禁用，但卻無法上傳模組。這時就需要遵循以下步驟來啟用模組上傳功能並調整上傳容量限制，來把剛剛從 github 下載的模組上傳至 Mattermost 伺服器。

由於 Mattermost Omnibus 儲存設置檔案（configuration）的路徑和一般的 Mattermost 伺服器不同，Omnibus 將設置檔案（configuration）儲存在 /etc/mattermost/mmomni.yml 中，而非儲存在 config.json 裡面。

因此你需要遵循以下步驟，來啟用模組上傳功能並調整上傳容量限制

sudo nano /etc/mattermost/mmomni.yml

命令列視窗會跳出類似於下方的畫面

db_user: mmuser
db_password: YOURPASSWORDYADAYADAYADA
fqdn: your.doamin.com
email: [e-mail]
https: true
data_directory: /var/opt/mattermost/data
enable_plugin_uploads: false #Change into true
enable_local_mode: true
client_max_body_size: 50M #Set bigger than the plugin File size

儲存並退出編輯器：

• 如果你使用的是 nano，按下 Ctrl+O 儲存更改，然後按下 Enter 確認文件名，最後按 Ctrl+X 退出。
• 如果你使用的是 vi 或 vim，按下 Esc 進入命令模式，然後輸入 :wq 儲存並退出。

修改完之後，記得 reconfigure 你的 Mattermost Omnibus。

sudo mmomni reconfigure

在Mattermost Omnibus 伺服器新增一個Boards

重新登入伺服器後，你應該就能在左邊導航欄的最上方看到一個九宮格，點一下九宮格你就會看到 boards

圖中右上角紅框

關於本篇技術文檔作者

蔡秀吉，現於查理大學附設醫院實習，並於布拉格理工大學訪問研究，進行 開放電信網路(O-RAN) 和 電信網路雲原生 的相關研究。
就讀陽明交大大三，喜歡研究開放電信網路(O-RAN)及其相關的技術發展，感興趣的領域有：雲原生、人工智慧、表觀遺傳學、體外循環系統。

聯絡資訊

• [e-mail]
• https://www.facebook.com/thc1006