Поиск по сайту:

Как установить Wekan Trello-подобный Kanban на Ubuntu 16.04

На этой странице

  1. Предпосылки
  2. Что мы будем делать
  3. Шаг 1. Обновите и обновите систему
  4. Шаг 2. Установите Nodejs
  5. Шаг 3. Установка и настройка MongoDB
  6. Шаг 4. Установите Wekan
  7. Шаг 5. Настройте Wekan как услугу
  8. Шаг 6. Установите Nginx в качестве обратного прокси-сервера для Wekan
  9. Шаг 7. Тестирование
  10. Справочник

Wekan — это канбан-доска с открытым исходным кодом, похожая на Trello, основанная на платформе Meteor Javascript. Это веб-инструмент управления, который позволяет вам создать доску для совместной работы над проектом. С советом Wekan вам просто нужно пригласить своего члена на совет, и все готово. На доске Wekan вы можете создать карточную задачу и управление делами, а затем назначить ее своему участнику.

В этом руководстве мы покажем вам, как шаг за шагом установить и настроить Wekan Trello-подобный Kanban в Ubuntu 16.04. Мы будем использовать MongoDB в качестве базы данных и веб-сервер Nginx в качестве обратного прокси-сервера для приложения Wekan. В этом руководстве подробно рассматриваются некоторые темы, в том числе защита базы данных MongoDB и настройка Nginx в качестве обратного прокси.

Предпосылки

  • Сервер Ubuntu 16.04
  • Привилегии root

Что мы будем делать

  1. Обновление репозитория и системы обновления
  2. Установить Node.js
  3. Установка и настройка MongoDB
  4. Установить Wekan
  5. Запуск Wekan как службы в Ubuntu 16.04
  6. Установите и настройте Nginx в качестве обратного прокси-сервера для Wekan.
  7. Тестирование

Шаг 1 - Обновите и обновите систему

Подключитесь к серверу, используя свой ssh-логин.

ssh

Теперь обновите все репозитории в системе, а затем обновите все пакеты, используя приведенные ниже команды apt.

sudo apt update
sudo apt upgrade

Шаг 2 — Установите Nodejs

Wekan — это приложение на основе nodejs, и для него требуется nodejs версии 4.8. В этом руководстве мы не будем устанавливать nodejs из репозитория Ubuntu, а лучше установим nodejs 4.8 с помощью диспетчера версий узлов nvm.

Перед установкой nodejs добавьте нового системного пользователя wekan с помощью приведенной ниже команды.

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

Войдите в систему как пользователь wekan, а затем загрузите и запустите сценарий установки nvm.

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

Команда установит nvm под пользователем wekan и добавит новую конфигурацию в файл конфигурации .bashrc. Перезагрузите файл .bashrc.

source ~/.bashrc

Теперь проверьте с помощью команды nvm, как показано ниже.

command -v nvm
nvm --version

И вы можете увидеть nvm 0.33.8, установленный в системе.

Затем установите nodejs 4.8 с помощью nvm Node Version Manager.

Запустите команды установки nvm, показанные ниже.

nvm install v4.8
nvm use node

После завершения установки проверьте версию узла.

node -v

И вы должны получить nodejs 4.8, установленный на Ubuntu 16.04, под пользователем wekan.

Шаг 3 — Установите и настройте MongoDB

На этом этапе мы установим и настроим базу данных MongoDB NoSQL. Для установки Wekan требуется MongoDB 3.2.x.

Добавьте ключ MongoDB, а также репозиторий в систему, выполнив приведенную ниже команду.

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

Теперь обновите репозиторий и установите MongoDB с помощью команды apt.

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

После завершения установки запустите службу MongoDB и включите ее запуск каждый раз при загрузке системы.

sudo systemctl start mongod
sudo systemctl enable mongod

MongoDB 3.2 был установлен в системе Ubuntu 16.04.

Далее нам нужно настроить аутентификацию MongoDB. Войдите в оболочку mongo и создайте нового суперпользователя администратора.

Войдите в оболочку монго.

mongo

Создайте нового пользователя-администратора с паролем MyAdminPassword и установите роль root.

Запустите запросы MongoDB ниже.

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

Создан пользователь-администратор MongoDB.

Теперь нам нужно отредактировать файл конфигурации /etc/mongod.conf, чтобы включить аутентификацию.

Отредактируйте файл конфигурации mongod.conf с помощью vim.

vim /etc/mongod.conf

Раскомментируйте строку безопасности и добавьте конфигурацию, как показано ниже.

security:
  authorization: enabled

Сохранить и выйти.

Теперь перезапустите службу MongoDB.

systemctl restart mongod

Аутентификация MongoDB включена.

Далее нам нужно создать новую базу данных и пользователя для Wekan. Мы создадим новую базу данных с именем wekan с пользователем wekan и паролем WekanPassword.

Войдите в оболочку mongo как пользователь-администратор.

mongo -u admin -p

Введите пароль администратора MyAdminPassword.

И когда вы получите оболочку mongo, запустите приведенные ниже запросы MongoDB.

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

База данных и пользователь для установки wekan созданы.

Шаг 4 - Установите Wekan

Войдите в систему как пользователь wekan.

su - wekan

Загрузите исходный код последней версии wekan с помощью команды wget и извлеките его.

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

И вы получите новый каталог с именем bundle. Перейдите в этот каталог и установите зависимости Wekan с помощью команды npm, как показано ниже.

cd bundle/programs/server
npm install

После завершения установки вы получите результат, как показано ниже.

Далее попробуем запустить Wekan в системе.

Выполните следующие команды, чтобы настроить переменные среды для приложения Wekan.

export MONGO_URL='mongodb://wekan:'
export PORT=8000

Теперь перейдите в каталог пакетов и запустите приложение Wekan Node.js.

cd ~/bundle
node main.js

Сервер Wekan теперь работает с портом 8000. Откройте веб-браузер и введите адрес своего сервера с портом 8000. У меня http://192.168.33.10:8000/

И вы получите страницу входа в Wekan, как показано ниже.

Теперь Wekan успешно установлен на Ubuntu 16.04.

Шаг 5. Настройте Wekan как услугу

Мы будем запускать приложение Wekan в качестве службы в системе Ubuntu. Поэтому нам нужно создать новый служебный файл в каталоге systemd.

Перед созданием служебного файла Wekan нам необходимо создать файл переменной среды.

Войдите в систему как пользователь wekan.

su - wekan

Перейдите в каталог bundle/ и создайте новый файл переменной среды .env с помощью vim.

cd bundle/
vim .env

Вставьте туда следующую конфигурацию.

MONGO_URL='mongodb://wekan:'
 PORT=8000
 HTTP_FORWARDED_COUNT=1

Сохранить и выйти.

Теперь вернитесь к корневому терминалу и перейдите в каталог /etc/systemd/system, затем создайте новый служебный файл wekan.service.

cd /etc/systemd/system/
vim 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=/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
 
 [Install]
 WantedBy=multi-user.target

Сохранить и выйти.

Перезагрузите систему systemd с помощью команды systemctl.

systemctl daemon-reload

Запустите службу Wekan и включите ее запуск каждый раз при загрузке системы.

systemctl start wekan
systemctl enable wekan

Теперь проверьте сервис Wekan, используя приведенные ниже команды.

netstat -plntu
systemctl status wekan

И следующие результаты.

Сейчас Wekan работает под портом 8000 как служба в системе Ubuntu 16.04.

Шаг 6. Установите Nginx в качестве обратного прокси-сервера для Wekan.

На этом этапе мы установим веб-сервер Nginx и настроим его в качестве обратного прокси-сервера для службы Wekan, работающей под портом 8000.

Установите веб-сервер Nginx из репозитория Ubuntu, используя приведенную ниже команду apt.

sudo apt install nginx -y

После завершения установки перейдите в каталог /etc/nginx/sites-available и создайте новый файл виртуального хоста wekan.

cd /etc/nginx/sites-available
vim wekan

Вставьте туда следующую конфигурацию виртуального хоста.

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

Сохранить и выйти.

Теперь активируйте виртуальный хост и запустите тестовую конфигурацию nginx и убедитесь в отсутствии ошибок.

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

Предполагая, что все прошло нормально, теперь перезапустите службу Nginx и включите ее запуск каждый раз при загрузке системы.

systemctl restart nginx
systemctl enable nginx

Теперь проверьте HTTP-порт с помощью команды netstat и убедитесь, что он находится в состоянии LISTEN.

netstat -plntu

Завершена настройка виртуального хоста Nginx для приложения Wekan Node.js.

Шаг 7 — Тестирование

Откройте веб-браузер и введите URL-адрес установки Wekan в адресной строке, мой – http://wekan.hakase-labs.co/.

И вы будете перенаправлены на страницу входа, нажмите на ссылку Регистрация.

Теперь введите свое имя пользователя, адрес электронной почты, пароль и оставьте поле «Код приглашения» пустым.

Нажмите синюю кнопку Регистрация.

И вы, скорее всего, получите сообщение об ошибке внутреннего сервера — оставьте его и вернитесь к своему терминалу. Потому что мы будем активировать первого пользователя из терминала.

Откройте свой терминал и войдите в оболочку mongo как пользователь wekan.

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

Теперь активируйте пользователя, используя запросы ниже.

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

Выход из оболочки монго.

Вернитесь в свой браузер и снова откройте установку URL-адреса Wekan.

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

Введите имя пользователя и пароль, затем нажмите кнопку «Войти».

И теперь вы должны получить панель пользователя Wekan.

Ниже приведен пример проекта Wekan.

Установка Wekan на Ubuntu 16.04 с MongoDB и веб-сервером Nginx успешно завершена.

Ссылка

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