Cách cài đặt Wekan giống như Trello Kanban trên Ubuntu 16.04

[theanh]

Wekan là một bảng kanban giống Trello mã nguồn mở dựa trên nền tảng Javascript Meteor. Đây là một công cụ quản lý dựa trên web cho phép bạn tạo một bảng cho sự cộng tác trong dự án của mình. Với bảng Wekan, bạn chỉ cần mời thành viên của mình vào bảng và thế là xong. Trên bảng Wekan, bạn có thể tạo một nhiệm vụ dựa trên thẻ và quản lý việc cần làm, sau đó chỉ định cho thành viên của mình.

Trong hướng dẫn này, chúng tôi sẽ chỉ cho bạn cách cài đặt và cấu hình từng bước Wekan giống Trello Kanban trên Ubuntu 16.04. Chúng tôi sẽ sử dụng MongoDB làm cơ sở dữ liệu và máy chủ web Nginx làm proxy ngược cho ứng dụng Wekan. Hướng dẫn này sẽ trình bày chi tiết một số chủ đề bao gồm bảo mật cơ sở dữ liệu MongoDB và cấu hình Nginx làm Proxy ngược.

Điều kiện tiên quyết​

• Máy chủ Ubuntu 16.04
• Quyền root

Những việc chúng ta sẽ làm​

1. Cập nhật kho lưu trữ và nâng cấp hệ thống
2. Cài đặt Nodejs
3. Cài đặt và cấu hình MongoDB
4. Cài đặt Wekan
5. Chạy Wekan dưới dạng dịch vụ trên Ubuntu 16.04
6. Cài đặt và cấu hình Nginx làm Proxy ngược cho Wekan
7. Kiểm tra

Bước 1 - Cập nhật và nâng cấp hệ thống​

Kết nối với máy chủ bằng thông tin đăng nhập ssh của bạn.

ssh [emailprotected]

Bây giờ hãy cập nhật tất cả các kho lưu trữ trên hệ thống, sau đó nâng cấp tất cả các gói bằng các lệnh apt bên dưới.

sudo apt update
sudo apt upgrade

Bước 2 - Cài đặt Nodejs​

Wekan là ứng dụng dựa trên nodejs và yêu cầu nodejs phiên bản 4.8. Trong hướng dẫn này, chúng ta sẽ không cài đặt nodejs từ kho lưu trữ Ubuntu, thay vào đó chúng ta sẽ cài đặt nodejs 4.8 bằng nvm Node Version Manager.

Trước khi cài đặt nodejs, hãy thêm người dùng hệ thống mới 'wekan' bằng lệnh bên dưới.

useradd -m -s /bin/bash wekan
passwd wekan

Đăng nhập với tư cách là người dùng 'wekan', sau đó tải xuống và chạy tập lệnh cài đặt nvm.

su - wekan
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash

Lệnh này sẽ cài đặt nvm dưới người dùng 'wekan' và thêm cấu hình mới vào tệp cấu hình '.bashrc'. Tải lại tệp '.bashrc'.

source ~/.bashrc

Bây giờ hãy kiểm tra bằng lệnh nvm như bên dưới.

command -v nvm
nvm --version

Và bạn có thể thấy nvm '0.33.8' được cài đặt trên hệ thống.

Tiếp theo, cài đặt nodejs 4.8 bằng nvm Node Version Manager.

Chạy lệnh nvm install được hiển thị bên dưới.

nvm install v4.8
nvm use node

Sau khi cài đặt hoàn tất, hãy kiểm tra phiên bản node.

node -v

Và bạn sẽ nhận được nodejs 4.8 được cài đặt trên Ubuntu 16.04, dưới người dùng 'wekan'.

Bước 3 - Cài đặt và cấu hình MongoDB​

Trong bước này, chúng ta sẽ cài đặt và cấu hình cơ sở dữ liệu MongoDB NoSQL. Wekan yêu cầu MongoDB 3.2.x để cài đặt.

Thêm khóa MongoDB cũng như kho lưu trữ vào hệ thống bằng cách chạy lệnh bên dưới.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv EA312927
echo "deb http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list

Bây giờ hãy cập nhật kho lưu trữ và cài đặt MongoDB bằng lệnh apt.

sudo apt update
sudo apt install -y mongodb-org mongodb-org-server mongodb-org-shell mongodb-org-mongos mongodb-org-tools

Sau khi cài đặt hoàn tất, hãy khởi động dịch vụ MongoDB và cho phép dịch vụ này khởi chạy mỗi khi khởi động hệ thống.

sudo systemctl start mongod
sudo systemctl enable mongod

MongoDB 3.2 đã được cài đặt trên hệ thống Ubuntu 16.04.

Tiếp theo, chúng ta cần cấu hình xác thực MongoDB. Đăng nhập vào shell mongo và tạo siêu người dùng 'admin' mới.

Đăng nhập vào shell mongo.

mongo

Tạo người dùng 'admin' mới với mật khẩu 'MyAdminPassword' và đặt vai trò là 'root'.

Chạy các truy vấn MongoDB bên dưới.

db.createUser(
 {
 user: "admin",
 pwd: "MyAdminPassword",
 roles: [ { role: "root", db: "admin" } ]
 }
)

Người dùng quản trị MongoDB đã được tạo.

Bây giờ chúng ta cần chỉnh sửa tệp cấu hình '/etc/mongod.conf' để bật xác thực.

Chỉnh sửa tệp cấu hình 'mongod.conf' bằng vim.

vim /etc/mongod.conf

Bỏ chú thích dòng 'bảo mật' và thêm cấu hình như hiển thị bên dưới.

security:
 authorization: enabled

Lưu và thoát.

Bây giờ hãy khởi động lại dịch vụ MongoDB.

systemctl restart mongod

Xác thực MongoDB đã được bật.



Tiếp theo, chúng ta cần tạo cơ sở dữ liệu và người dùng mới cho Wekan. Chúng tôi sẽ tạo một cơ sở dữ liệu mới có tên 'wekan' với người dùng 'wekan' và mật khẩu 'WekanPassword'.

Đăng nhập vào shell mongo với tư cách là người dùng quản trị.

mongo -u admin -p

Nhập mật khẩu quản trị 'MyAdminPassword'.

Và khi bạn nhận được shell mongo, hãy chạy các truy vấn MongoDB bên dưới.

sử dụng wekan
db.createUser(
 {
 người dùng: "wekan",
 pwd: "WekanPassword",
 vai trò: ["readWrite"]
 }
)

Cơ sở dữ liệu và người dùng để cài đặt wekan đã được tạo.

Bước 4 - Cài đặt Wekan​

Đăng nhập với tư cách là người dùng 'wekan'.

su - wekan

Tải xuống phiên bản mới nhất của mã nguồn wekan bằng lệnh wget và giải nén nó.

wget https://github.com/wekan/wekan/releases/download/v0.63/wekan-0.63.tar.gz
tar xf wekan-0.63.tar.gz

Và bạn sẽ nhận được một thư mục mới có tên là 'bundle'. Vào thư mục đó và cài đặt các phụ thuộc của Wekan bằng lệnh npm như hiển thị bên dưới.

cd bundle/programs/server
npm install

Sau khi cài đặt hoàn tất, bạn sẽ nhận được kết quả như hiển thị bên dưới.



Tiếp theo, chúng ta sẽ thử chạy Wekan trên hệ thống.

Chạy các lệnh sau để thiết lập các biến môi trường cho ứng dụng Wekan.

export MONGO_URL='mongodb://wekan:[emailprotected]:27017/wekan?authSource=wekan'
export ROOT_URL='http://192.168.33.10/'
export MAIL_URL='smtp://user:[emailprotected]:25/'
export MAIL_FROM='[emailprotected]'
export PORT=8000

Bây giờ hãy vào thư mục 'bundle' và chạy ứng dụng Wekan Node.js.

cd ~/bundle
node main.js

Máy chủ Wekan hiện đang chạy dưới cổng 8000. Mở trình duyệt web của bạn và nhập địa chỉ máy chủ của bạn với cổng 8000. Của tôi là

http://192.168.33.10:8000/

Và bạn sẽ nhận được trang đăng nhập Wekan như hiển thị bên dưới.



Wekan hiện đã được cài đặt thành công trên Ubuntu 16.04.

Bước 5 - Cấu hình Wekan dưới dạng Dịch vụ​

Chúng tôi sẽ chạy ứng dụng Wekan dưới dạng dịch vụ trên hệ thống Ubuntu. Vì vậy, chúng ta cần tạo tệp dịch vụ mới trong thư mục systemd.

Trước khi tạo tệp dịch vụ Wekan, chúng ta cần tạo tệp biến môi trường.

Đăng nhập với tư cách là người dùng 'wekan'.

su - wekan

Đi tới thư mục 'bundle/' và tạo tệp biến môi trường mới '.env' bằng vim

cd bundle/
vim .env

Dán cấu hình sau vào đó.

MONGO_URL='mongodb://wekan:[emailprotected]:27017/wekan?authSource=wekan'
 ROOT_URL='http://wekan.hakase-labs.co'
 MAIL_URL='smtp://user:[emailprotected]:25/'
 MAIL_FROM='[emailprotected]'
 PORT=8000
 HTTP_FORWARDED_COUNT=1

Lưu và thoát.

Bây giờ quay lại thiết bị đầu cuối gốc của bạn và đi đến thư mục '/etc/systemd/system', sau đó tạo tệp dịch vụ mới 'wekan.service'.

cd /etc/systemd/system/
vim wekan.service

Dán cấu hình sau vào đó.

[Unit]
 Description=Wekan Server
 After=syslog.target
 After=network.target
 
 [Service]
 Type=simple
 Restart=on-failure
 StartLimitInterval=86400
 StartLimitBurst=5
 RestartSec=10
 ExecStart=/home/wekan/.nvm/versions/node/v4.8.7/bin/node bundle/main.js
 EnvironmentFile=/home/wekan/bundle/.env
 ExecReload=/bin/kill -USR1 $MAINPID
 RestartSec=10
 User=wekan
 Group=wekan
 WorkingDirectory=/home/wekan
 StandardOutput=syslog
 StandardError=syslog
 SyslogIdentifier=Wekan
 
 [Cài đặt]
 WantedBy=multi-user.target

Lưu và thoát.

Tải lại hệ thống systemd bằng lệnh systemctl.

systemctl daemon-reload

Khởi động dịch vụ Wekan và cho phép dịch vụ này khởi chạy mỗi khi khởi động hệ thống.

systemctl start wekan
systemctl enable wekan

Bây giờ hãy kiểm tra dịch vụ Wekan bằng lệnh bên dưới.

netstat -plntu
systemctl status wekan

Và sau đây là kết quả.



Wekan hiện đang chạy dưới cổng 8000, chạy như một dịch vụ trên hệ thống Ubuntu 16.04.

Bước 6 - Cài đặt Nginx làm proxy ngược cho Wekan​

Trong bước này, chúng ta sẽ cài đặt máy chủ web Nginx và cấu hình nó như một proxy ngược cho dịch vụ Wekan đang chạy dưới cổng 8000.

Cài đặt máy chủ web Nginx từ kho lưu trữ Ubuntu bằng lệnh apt bên dưới.

sudo apt install nginx -y

Sau khi cài đặt hoàn tất, hãy vào thư mục '/etc/nginx/sites-available' và tạo một tệp máy chủ ảo mới 'wekan'.

cd /etc/nginx/sites-available
vim wekan

Dán cấu hình máy chủ ảo sau vào đó.

server {
 server_name wekan.hakase-labs.co;
 listen 80;
 
 access_log /var/log/nginx/wekan-access.log;
 error_log /var/log/nginx/wekan-error.log;
 
 location / {
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header Host $host;
 proxy_http_version 1.1;
 proxy_set_header Upgrade $http_upgrade;
 proxy_set_header Connection 'upgrade';
 proxy_cache_bypass $http_upgrade;
 proxy_pass http://127.0.0.1:8000;
 }
 
 }

Lưu và thoát.

Bây giờ hãy kích hoạt máy chủ ảo và chạy thử cấu hình nginx, và đảm bảo không có lỗi.

ln -s /etc/nginx/sites-available/wekan /etc/nginx/sites-enabled/
nginx -t

Giả sử mọi thứ đã diễn ra tốt, bây giờ hãy khởi động lại dịch vụ Nginx và cho phép nó khởi chạy mỗi lần khởi động hệ thống.

systemctl restart nginx
systemctl enable nginx

Bây giờ hãy kiểm tra cổng HTTP bằng lệnh netstat và đảm bảo rằng nó ở trạng thái 'LISTEN'.

netstat -plntu

Cấu hình máy chủ ảo Nginx cho ứng dụng Wekan Node.js đã hoàn tất.

Bước 7 - Kiểm tra​

Mở trình duyệt web của bạn và nhập URL cài đặt Wekan vào thanh địa chỉ, của tôi là

http://wekan.hakase-labs.co/

Và bạn sẽ được chuyển hướng đến trang đăng nhập, hãy nhấp vào liên kết 'Đăng ký'.



Bây giờ hãy nhập tên người dùng, email, mật khẩu và để trống Mã mời.



Nhấp vào nút 'Đăng ký' màu xanh lam.

Và bạn có thể sẽ nhận được thông báo 'Lỗi máy chủ nội bộ' - hãy giữ nguyên và quay lại thiết bị đầu cuối của bạn. Bởi vì chúng ta sẽ kích hoạt người dùng đầu tiên từ terminal.

Mở terminal và đăng nhập vào shell mongo với tư cách là người dùng 'wekan'.

mongo -u wekan -p --authenticationDatabase "wekan"

Bây giờ hãy kích hoạt người dùng bằng các truy vấn bên dưới.

use wekan
db.users.update({username:'hakase'},{$set:{isAdmin:true}})

Thoát khỏi shell mongo.



Quay lại trình duyệt của bạn và mở lại cài đặt url Wekan.

http://wekan.hakase-labs.co/

Nhập tên người dùng và mật khẩu của bạn, sau đó nhấp vào nút 'Đăng nhập'.



Và bây giờ bạn sẽ nhận được người dùng Wekan dashboard.



Dưới đây là dự án mẫu wekan.



Cài đặt Wekan trên Ubuntu 16.04 với máy chủ web MongoDB và Nginx đã hoàn tất thành công.

Tham khảo​

• https://github.com/wekan/wekan/wiki