Ako nainštalovať Wekan (Open Source Kanban) na Ubuntu 16.04

Wekan je kanban tabuľa vytvorená pomocou rámca Meteor JavaScript. Považuje sa za alternatívu k Trello s otvoreným zdrojom a hosťom, ktorá poskytuje takmer rovnaké funkcie. Umožňuje vám vytvárať zoznamy „to-do“ správy založené na kartách. Wekan je veľmi nápomocný pri zvyšovaní produktivity pri práci v prostredí spolupráce. Wekan má plne responzívne webové rozhranie a je aktívne preložené do mnohých jazykov.

Predpoklady

• Inštancia servera Vultr Ubuntu 16.04.
• Sudo používateľ .

V tomto návode použijeme wekan.example.comnázov domény smerujúci k inštancii Vultr. Uistite sa, že ste nahradili všetky výskyty vzorového názvu domény skutočným.

Aktualizujte svoj základný systém pomocou príručky Ako aktualizovať Ubuntu 16.04 . Po aktualizácii systému pokračujte v inštalácii závislostí.

Nainštalujte Node.js

Wekan podporuje iba Node.js LTS version 4.8. Na inštaláciu Node.js použijeme správcu verzií uzla. Nainštalujte nvmspustením inštalačného skriptu.

wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.4/install.sh | bash

Ak chcete okamžite začať používať nvm, spustite toto.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Ak nvmbol nainštalovaný úspešne, mali by ste mať možnosť skontrolovať jeho verziu.

user@vultr:~$ nvm --version
0.33.4

Nainštalujte Node.js.

nvm install v4.8

Nastavte predvolenú verziu Node.js.

nvm use node

Ak sa Node.js úspešne nainštaloval, mali by ste mať možnosť skontrolovať jeho verziu.

node -v

Uvidíte tento výstup.

user@vultr:~$ node -v
v4.8.4

NVM nainštaluje Node.js iba pre aktuálneho používateľa. Ak chcete, aby bol Node.js dostupný globálne, spustite toto.

n=$(which node);n=${n%/bin/node}; chmod -R 755 $n/bin/*; sudo cp -r $n/{bin,lib,share} /usr

Node.js je teraz k dispozícii ako /usr/bin/node.

user@vultr:~$ sudo which node
/usr/bin/node

Nainštalujte MongoDB

MongoDB je bezplatný a open source databázový server NoSQL. Na rozdiel od tradičných databáz, ktoré na organizáciu údajov používajú tabuľky, je MongoDB orientovaný na dokumenty a používa dokumenty podobné JSON bez schém. Wekan používa MongoDB na ukladanie svojich údajov.

Wekan je kompatibilný iba s MongoDB version 3.2. Vytvorte nový súbor úložiska.

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

Importujte verejný kľúč GPG MongoDB a aktualizujte zoznam balíkov.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv EA312927
sudo apt update

Nainštalujte MongoDB.

sudo apt install -y mongodb-org

Spustite MongoDB a povoľte jej automatické spustenie.

sudo systemctl start mongod
sudo systemctl enable mongod

Zabezpečenie inštancie MongoDB

V predvolenom nastavení nie je na serveri MongoDB povolená žiadna autentifikácia. Každý používateľ, ktorý má prístup k terminálu servera, bude mať plné oprávnenia na inštaláciu MongoDB. Aby sme zabezpečili databázový server a obmedzili prístup neprivilegovaného používateľa, budeme musieť na serveri nastaviť autentifikáciu.

MongoDB poskytuje mongoshell, ktorý sa používa na spúšťanie dotazov na MongoDB. Prepnite sa na mongoškrupinu.

mongo

Vytvorte nového používateľa MongoDB s oprávneniami root. Môžete použiť ľubovoľné používateľské meno podľa vlastného výberu. Uistite sa, že ste heslo nahradili .

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

Mali by ste vidieť nasledujúci výstup.

user@vultr:~$ mongo
MongoDB shell version: 3.2.17
connecting to: test
Welcome to the MongoDB shell.

...

2017-09-30T18:11:40.274+0000 I CONTROL  [initandlisten]
> db.createUser(
...   {
...     user: "admin",
...     pwd: "StrongAdminPassword",
...     roles: [ { role: "root", db: "admin" } ]
...   }
... )
Successfully added user: {
        "user" : "admin",
        "roles" : [
                {
                        "role" : "root",
                        "db" : "admin"
                }
        ]
}

Ukončite príkazové rozhranie MongoDB do terminálu Linux stlačením „ Ctrl+C“.

Upravte konfiguračný súbor MongoDB.

sudo nano /etc/mongod.conf

Pripojte nasledujúci riadok na koniec súboru.

security:
 authorization: enabled

Reštartujte MongoDB, aby sa zmena konfigurácie prejavila.

sudo systemctl restart mongod

Now that security has been enabled, you can test if it is working by switching to the mongo shell again using the mongo command. This time, if you run a query, such as show dbs to show the list of databases, you will see a message reporting failed authorization. Exit to the sudo user again after testing the log-in as the new user you just created.

Log in as the administrator user you just created.

mongo -u admin -p

Provide the password of the user for a successful login. Create a new user for the wekan database which will be used to store Wekan data.

use wekan
db.createUser(
    {
      user: "wekan",
      pwd: "StrongPassword",
      roles: ["readWrite"]
    }
 ) 

Make sure to replace the StrongPassword with a strong password. You will see the following output.

user@vultr:~$ mongo -u admin -p
MongoDB shell version: 3.2.17
Enter password:
connecting to: test

...

2017-09-30T18:13:26.007+0000 I CONTROL  [initandlisten]
>
> use wekan
switched to db wekan
> db.createUser(
...     {
...       user: "wekan",
...       pwd: "StrongPassword",
...       roles: ["readWrite"]
...     }
...  )
Successfully added user: { "user" : "wekan", "roles" : [ "readWrite" ] }

Install Wekan

Check for the latest link to the Wekan release on Github as new releases are very frequent. Download the latest version of Wekan from Github replacing the link to the installer package.

cd ~
wget https://github.com/wekan/wekan/releases/download/v0.44/wekan-0.44.tar.gz

Extract the downloaded archive into a new directory named wekan.

mkdir wekan
tar xzvf wekan-*.tar.gz -C wekan

Install the Node.js dependencies.

cd wekan/bundle/programs/server && npm install

The Wekan server reads configurations from the environment variables. Run the following commands to set the configurations as environment variables.

export MONGO_URL='mongodb://wekan:[email protected]:27017/wekan?authSource=wekan'
export ROOT_URL='http://wekan.example.com'
export MAIL_URL='smtp://user:[email protected]:25/'
export MAIL_FROM='[email protected]'
export PORT=4000

Make sure to replace the MongoDB password for the wekan user you have created. Also, update the mail URL according to your SMTP server settings. If you do not have an email server ready, you can always change this configuration later.

To immediately start the application.

cd ~/wekan/bundle
node main.js

You can now access the application by going to http://wekan.example.com:4000. You will see the interface to log-in into the Wekan kanban board.

For production use, it is recommended to set up a reverse proxy to serve the application on the standard HTTP port and a systemd service to manage the application process. In this tutorial, we will use the Nginx web server as a reverse proxy, secured with a Let's Encrypt free SSL.

Setting up the Nginx Reverse Proxy

Add the Certbot PPA repository to the system.

sudo add-apt-repository ppa:certbot/certbot
sudo apt update

Install Nginx and Certbot, which is the client application for Let's Encrypt CA.

sudo apt -y install certbot nginx

Note: The domain name which you are using to obtain the certificates from the Let's Encrypt CA must be pointed towards the server. The client verifies the domain authority before issuing the certificates.

Generate the SSL certificates.

sudo certbot certonly --standalone -d wekan.example.com

The generated certificates are likely to be stored in the /etc/letsencrypt/live/wekan.example.com/ directory. The SSL certificate will be stored as fullchain.pem, and private key will be stored as privkey.pem.

Let's Encrypt certificates expire in 90 days, so it is recommended to set up auto-renewal of the certificates using Cronjob. Cron is a system service which is used to run periodic tasks.

Open the cron job file.

sudo crontab -e

Add the following line at the end of the file.

30 5 * * * /usr/bin/certbot renew --quiet

The above cron job will run every day at 5:30 AM. If the certificates are due for expiration, it will automatically renew them.

Create a new virtual host.

sudo nano /etc/nginx/sites-available/wekan.example.com.conf

Populate the file with the following.

upstream wekan {
        server 127.0.0.1:4000;
}
server {
        listen  80;
        listen [::]:80;
        server_name  wekan.example.com;

        location / {
                if ($ssl_protocol = "") {
                        rewrite     ^   https://$server_name$request_uri? permanent;
                }
        }
}

server {
        listen 443 ssl;
        listen [::]:443 ssl;
        server_name wekan.example.com;

        add_header Strict-Transport-Security "max-age=15768000";

        ssl_certificate /etc/letsencrypt/live/wekan.example.com/fullchain.pem;
        ssl_certificate_key /etc/letsencrypt/live/wekan.example.com/privkey.pem;

        ssl_session_timeout 1d;
        ssl_session_cache shared:SSL:10m;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_ciphers 'ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS';
        ssl_prefer_server_ciphers on;

        ssl_stapling on;
        ssl_stapling_verify on;

        error_page 497  https://$host:$server_port$request_uri;
        location / {
            proxy_pass http://wekan;
            proxy_http_version 1.1;
            proxy_set_header Host $host:$server_port;
            proxy_set_header Referer $http_referer;
            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 https;
            proxy_set_header X-Forwarded-Ssl on;
            proxy_set_header X-Nginx-Proxy true;

            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";

            proxy_redirect off;

            proxy_send_timeout 86400;
            proxy_read_timeout 86400;
        }
}

Replace wekan.example.com with your actual domain name in the above configuration.

Enable the newly added site.

sudo ln -s /etc/nginx/sites-available/wekan.example.com.conf /etc/nginx/sites-enabled/wekan.example.com.conf

Restart Nginx so that the changes can take effect.

sudo systemctl restart nginx

Povoľte automatické spustenie Nginx pri štarte.

sudo systemctl enable nginx

Nastavte službu Systemd

Vytvorte nového používateľa na spustenie procesu.

sudo adduser wekan --shell /usr/sbin/nologin --home /opt/wekan

Teraz presuňte všetky súbory do /opt/wekanadresára.

sudo mv ~/wekan/* /opt/wekan/

Poskytnite vlastníctvo súborov novovytvorenému používateľovi.

sudo chown -R wekan:wekan /opt/wekan

Wekan neberie údaje zo žiadneho konfiguračného súboru. Namiesto toho k nemu pristupuje z premenných prostredia. Vytvoríme nový súbor na uloženie premenných prostredia. Súbor obsahujúci premenné prostredia prejde cez Systemdslužbu.

Vytvorte nový súbor na ukladanie premenných prostredia.

 sudo nano /opt/wekan/config.env

Naplňte súbor nasledujúcim obsahom.

MONGO_URL='mongodb://wekan:[email protected]:27017/wekan?authSource=wekan'
ROOT_URL='http://wekan.example.com'
MAIL_URL='smtp://user:[email protected]:25/'
MAIL_FROM='[email protected]'
PORT=4000
HTTP_FORWARDED_COUNT=1

Uistite sa, že ste nahradili usernamea password.

Poskytnite vlastníctvo wekanpoužívateľovi spustením.

sudo chown -R wekan:wekan /opt/wekan/config.env

Vytvorte nový súbor služby pre službu Wekan systemd.

sudo nano /etc/systemd/system/wekan.service

Naplňte súbor nasledujúcim.

[Unit]
Description=Wekan Server
After=syslog.target
After=network.target

[Service]
Type=simple
Restart=on-failure
StartLimitInterval=86400
StartLimitBurst=5
RestartSec=10
ExecStart=/usr/bin/node /opt/wekan/bundle/main.js
EnvironmentFile=/opt/wekan/config.env
ExecReload=/bin/kill -USR1 $MAINPID
RestartSec=10
User=wekan
Group=wekan
WorkingDirectory=/opt/wekan
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=Wekan

[Install]
WantedBy=multi-user.target

Uložte súbor a ukončite editor. Teraz môžete ľahko spustiť Wekan.

sudo systemctl start wekan

Ak chcete povoliť automatické spustenie Wekan pri štarte.

sudo systemctl enable wekan

Ak chcete skontrolovať stav služby Wekan.

sudo systemctl status wekan

Zabaliť sa

Teraz máte prístup k inštancii Wekan na https://wekan.example.com. Začnite vytvorením nového účtu. Po vytvorení účtu môžete novovytvorenému používateľovi povoliť administratívny prístup. Prihláste sa do prostredia MongoDB ako administrátor.

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

Teraz vyberte wekandatabázu a aktualizujte objekt, aby ste používateľa povýšili na správcu.

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

Nezabudnite ho nahradiť admin_userskutočným používateľským menom používateľa, ktorého ste vytvorili. V správcovskom rozhraní budete môcť zakázať samoregistráciu a aktualizovať nastavenia SMTP.

Gratulujeme, úspešne ste nainštalovali dosku Wekan Kanban na svoju inštanciu Vultr Ubuntu.