Как да инсталирате Wekan (Open Source Kanban) на CentOS 7

Предпоставки

Инсталирайте Node.js

Инсталирайте MongoDB

Инсталирайте Wekan

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

Настройте услугата Systemd

Обобщавайки

Wekan е kanban дъска, изградена с рамката на Meteor JavaScript. Счита се за отворен код и самостоятелно хоствана алтернатива на Trello, предоставяща почти същите функции. Позволява ви да създавате базирани на карти списъци за управление на „задачи“. Wekan е много полезен за повишаване на производителността, когато работите в среда за сътрудничество. Wekan има напълно отзивчив уеб интерфейс и е активно преведен на много езици.

Предпоставки

• Сървърна инстанция Vultr CentOS 7.
• А потребителското Sudo .

За този урок ще използваме wekan.example.comкато име на домейн, насочено към екземпляра Vultr. Моля, не забравяйте да замените всички срещания на примерното име на домейн с действителното.

Актуализирайте базовата си система с помощта на ръководството Как да актуализирате CentOS 7 . След като вашата система бъде актуализирана, продължете с инсталирането на зависимостите.

Инсталирайте Node.js

Wekan поддържа само Node.js LTS version 4.8. За да инсталираме Node.js, ще използваме мениджъра на версиите на възел. Инсталирайте, nvmкато стартирате инсталационния скрипт.

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

За да започнете незабавно да използвате nvm, стартирайте това.

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

Ако nvmе инсталиран успешно, тогава трябва да можете да проверите неговата версия.

[user@vultr ~]$ nvm --version
0.33.4

Инсталирайте Node.js.

nvm install v4.8

Задайте версията по подразбиране на Node.js.

nvm use node

Ако Node.js е инсталиран успешно, тогава трябва да можете да проверите неговата версия.

node -v

Ще видите този изход.

[user@vultr ~]$ node -v
v4.8.4

NVM инсталира Node.js само за текущия потребител. За да бъде Node.js достъпен глобално, стартирайте това.

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

Node.js вече е достъпен като /bin/node.

[user@vultr ~]$ sudo which node
/bin/node

Инсталирайте MongoDB

MongoDB е безплатен NoSQL сървър на база данни с отворен код. За разлика от традиционните бази данни, които използват таблици за организиране на своите данни, MongoDB е ориентиран към документи и използва подобни на JSON документи без схеми. Wekan използва MongoDB, за да съхранява своите данни.

Wekan е съвместим само с MongoDB version 3.2. MongoDB не е наличен в YUMхранилището по подразбиране , така че ще трябва да създадете нов файл на хранилището.

sudo nano /etc/yum.repos.d/mongodb-org-3.2.repo

Попълнете файла със следното съдържание.

[mongodb-org-3.2]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.2/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.2.asc

Инсталирайте MongoDB.

sudo yum install -y mongodb-org

Стартирайте сървъра MongoDB и го активирайте да стартира автоматично.

sudo systemctl start mongod
sudo systemctl enable mongod

Защита на екземпляра на MongoDB

По подразбиране няма активирана автентификация в сървър на MongoDB. Всеки потребител, който има достъп до терминала на сървъра, ще има пълни привилегии върху инсталацията на MongoDB. За да защитим сървъра на базата данни и да ограничим достъпа на непривилегирован потребител, ще трябва да настроим удостоверяване на сървъра.

MongoDB предоставя mongoобвивка, която се използва за изпълнение на заявки в MongoDB. Превключете към mongoобвивката, като напишете.

mongo

Създайте нов потребител на MongoDB с root привилегии. Можете да използвате всяко потребителско име по ваш избор. Моля, не забравяйте да смените паролата .

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

Трябва да видите следния изход.

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

...

2017-09-29T20:42:29.042+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"
                }
        ]
}

Излезте от командния интерфейс на MongoDB към терминала на Linux, като натиснете " Ctrl+C".

Редактирайте конфигурационния файл на MongoDB.

sudo nano /etc/mongod.conf

Добавете следния ред в края на файла.

security:
 authorization: enabled

Рестартирайте MongoDB, за да може промяната на конфигурацията да влезе в сила.

sudo systemctl restart mongod

Сега, когато сигурността е активирана, можете да тествате дали работи, като превключите отново към mongo shell с помощта на mongoкомандата. Този път, ако изпълните заявка, като например show dbsда покажете списък с бази данни, ще видите съобщение, отчитащо неуспешно упълномощаване. Излезте sudoотново към потребителя, след като тествате влизането като новия потребител, който току-що създадохте.

Влезте като administratorпотребител, който току-що създадохте.

mongo -u admin -p

Предоставете паролата на потребителя за успешно влизане. Създайте нов потребител за Wekanбазата данни, който ще се използва за съхраняване на данни на Wekan.

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

Уверете се, че сте променили StrongPasswordсъс силна парола. Ще видите следния изход.

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

...

2017-09-29T20:52:32.450+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" ] }

Инсталирайте 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.41/wekan-0.41.tar.gz

Extract the downloaded archive into a new directory named wekan.

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

Install Bzip2, which is required to extract the Node.js dependencies.

sudo yum -y install bzip2

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:StrongPassword@127.0.0.1:27017/wekan?authSource=wekan'
export ROOT_URL='http://wekan.example.com'
export MAIL_URL='smtp://user:pass@mail.example.com:25/'
export MAIL_FROM='wekan@example.com'
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 mail server ready, you can always change this configuration later. Open the firewall to allow port 4000 through the firewall.

sudo firewall-cmd --zone=public --add-port=4000/tcp --permanent
sudo firewall-cmd --reload

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 to 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

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

sudo yum -y install certbot nginx

Before you can request the SSL certificates, you will need to allow port 80 and 443 through the firewall. Certbot will check the domain authority before issuing certificates.

sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --zone=public --add-service=https --permanent

Now that we are running Wekan on a standard HTTPS port, we do not need to allow port 4000 through the firewall. Adjust the firewall to remove port 4000.

sudo firewall-cmd --zone=public --remove-port=4000/tcp --permanent
sudo firewall-cmd --reload

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

Генерираните сертификати вероятно ще се съхраняват в /etc/letsencrypt/live/wekan.example.com/директорията. SSL сертификатът ще се съхранява като fullchain.pem, а частният ключ ще се съхранява като privkey.pem.

Сертификатите Let's Encrypt изтичат след 90 дни, така че се препоръчва да настроите автоматично подновяване на сертификатите с помощта на Cronjob. Cron е системна услуга, която се използва за изпълнение на периодични задачи.

Отворете файла за задание на cron.

sudo crontab -e

Добавете следния ред в края на файла.

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

Горната задача на cron ще се изпълнява всеки ден в 5:30 сутринта. Ако сертификатите са с изтичане, той автоматично ще ги поднови.

Създайте нов виртуален хост.

sudo nano /etc/nginx/conf.d/wekan.example.com.conf

Попълнете файла със следното.

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;
        }
}

Заменете wekan.example.comс действителното си име на домейн в горната конфигурация.

Рестартирайте Nginx, за да могат промените да влязат в сила.

sudo systemctl restart nginx

Активирайте Nginx да стартира автоматично при стартиране.

sudo systemctl enable nginx

Настройте услугата Systemd

Създайте нов потребител за процеса.

sudo adduser wekan -s /usr/sbin/nologin -d /opt/wekan

Сега преместете всички файлове в /opt/wekanдиректорията.

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

Предоставете собствеността върху файловете на новосъздадения потребител.

sudo chown -R wekan:wekan /opt/wekan

Wekan не взема данни от нито един конфигурационен файл. Вместо това той осъществява достъп до него от променливи на средата. Ще създадем нов файл за съхраняване на променливите на средата. Файлът, съдържащ променливите на средата, ще бъде предаден през Systemdуслугата.

Създайте нов файл за съхраняване на променливи на средата.

 sudo nano /opt/wekan/config.env

Попълнете файла със следното съдържание.

MONGO_URL='mongodb://wekan:StrongPassword@127.0.0.1:27017/wekan?authSource=wekan'
ROOT_URL='http://wekan.example.com'
MAIL_URL='smtp://user:pass@mail.example.com:25/'
MAIL_FROM='wekan@example.com'
PORT=4000
HTTP_FORWARDED_COUNT=1

Моля, не забравяйте да смените usernameи password.

Предоставете собствеността на wekanпотребителя.

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

Създайте нов файл на услугата за услугата Wekan systemd.

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

Попълнете файла със следното.

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

[Service]
Type=simple
Restart=on-failure
StartLimitInterval=86400
StartLimitBurst=5
RestartSec=10
ExecStart=/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

Запазете файла и излезте от редактора. Сега можете лесно да стартирате Wekan.

sudo systemctl start wekan

За да разрешите на Wekan да стартира автоматично при стартиране.

sudo systemctl enable wekan

За да проверите състоянието на услугата Wekan.

sudo systemctl status wekan

Обобщавайки

Вече можете да получите достъп до екземпляра на Wekan на https://wekan.example.com. Започнете със създаване на нов акаунт. След като създадете акаунта, можете да разрешите административен достъп на новосъздадения потребител. Влезте в обвивката на MongoDB като администраторски потребител.

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

Сега изберете wekanбазата данни и актуализирайте обекта, за да повишите потребителя до потребител на администратор.

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

Моля, не забравяйте да замените admin_userс действителното потребителско име на потребителя, който сте създали. От администраторския интерфейс ще можете да деактивирате саморегистрацията и да актуализирате настройките на SMTP.

Поздравления, успешно инсталирахте платката Wekan Kanban на вашия екземпляр на Vultr CentOS.