Wekan ist ein Trello-ähnliches Open-Source-Kanban-Board, das auf dem Meteor-JavaScript-Framework basiert. Es ist ein webbasiertes Verwaltungstool, mit dem Sie ein Board für Ihre Projektzusammenarbeit erstellen können. Mit dem Wekan-Board müssen Sie nur Ihr Mitglied in das Board einladen und schon kann es losgehen. Auf dem wekan-Board können Sie eine kartenbasierte Aufgaben- und Aufgabenverwaltung erstellen und diese dann Ihrem Mitglied zuweisen.
In diesem Tutorial zeigen wir Ihnen, wie Sie Wekan Trello-ähnliches Kanban unter Ubuntu 16.04 Schritt für Schritt installieren und konfigurieren. Wir werden MongoDB als Datenbank und den Nginx-Webserver als Reverse-Proxy für die Wekan-Anwendung verwenden. Dieses Tutorial behandelt einige Themen im Detail, einschließlich der Sicherung der MongoDB-Datenbank und der Konfiguration von Nginx als Reverse Proxy.
Voraussetzungen
- Ubuntu 16.04-Server
- Root-Rechte
Was wir tun werden
- Repository aktualisieren und System aktualisieren
- Installieren Sie Nodejs
- MongoDB installieren und konfigurieren
- Installieren Sie Wekan
- Ausführen von Wekan als Dienst auf Ubuntu 16.04
- Installieren und konfigurieren Sie Nginx als Reverse Proxy für Wekan
- Testen
Schritt 1 - System aktualisieren und aktualisieren
Verbinden Sie sich mit Ihrem ssh-Login mit dem Server.
ssh [email protected]
Aktualisieren Sie nun alle Repositories auf dem System und aktualisieren Sie dann alle Pakete mit den folgenden apt-Befehlen.
sudo apt update
sudo apt upgrade
Schritt 2 - Nodejs installieren
Wekan ist eine nodejs-basierte Anwendung und erfordert nodejs-Version 4.8. In diesem Tutorial installieren wir nodejs nicht aus dem Ubuntu-Repository, sondern wir installieren nodejs 4.8 mit dem nvm Node Version Manager.
Fügen Sie vor der Installation von nodejs den neuen Systembenutzer „wekan“ mit dem folgenden Befehl hinzu.
useradd -m -s /bin/bash wekan
passwd wekan
Melden Sie sich als Benutzer „wekan“ an und laden Sie dann das nvm-Installationsskript herunter und führen Sie es aus.
su - wekan
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash
Der Befehl installiert nvm unter dem Benutzer „wekan“ und fügt der Konfigurationsdatei „.bashrc“ eine neue Konfiguration hinzu. Laden Sie die '.bashrc'-Datei neu.
source ~/.bashrc
Testen Sie jetzt mit dem nvm-Befehl wie unten.
command -v nvm
nvm --version
Und Sie können sehen, dass nvm '0.33.8' auf dem System installiert ist.
Als nächstes installieren Sie nodejs 4.8 mit nvm Node Version Manager.
Führen Sie die unten gezeigten nvm-Installationsbefehle aus.
nvm install v4.8
nvm use node
Überprüfen Sie nach Abschluss der Installation die Knotenversion.
node -v
Und Sie sollten nodejs 4.8 erhalten, wie es auf Ubuntu 16.04 unter dem Benutzer „wekan“ installiert ist.
Schritt 3 – MongoDB installieren und konfigurieren
In diesem Schritt werden wir die MongoDB NoSQL-Datenbank installieren und konfigurieren. Wekan benötigt MongoDB 3.2.x für seine Installation.
Fügen Sie den MongoDB-Schlüssel sowie das Repository zum System hinzu, indem Sie den folgenden Befehl ausführen.
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
Aktualisieren Sie nun das Repository und installieren Sie MongoDB mit dem apt-Befehl.
sudo apt update
sudo apt install -y mongodb-org mongodb-org-server mongodb-org-shell mongodb-org-mongos mongodb-org-tools
Starten Sie nach Abschluss der Installation den MongoDB-Dienst und aktivieren Sie ihn so, dass er jedes Mal beim Systemstart gestartet wird.
sudo systemctl start mongod
sudo systemctl enable mongod
MongoDB 3.2 wurde auf dem Ubuntu 16.04-System installiert.
Als nächstes müssen wir die MongoDB-Authentifizierung konfigurieren. Melden Sie sich bei der Mongo-Shell an und erstellen Sie einen neuen „admin“-Superuser.
Melden Sie sich bei der Mongo-Shell an.
mongo
Erstellen Sie einen neuen „admin“-Benutzer mit dem Passwort „MyAdminPassword“ und legen Sie die Rolle als „root“ fest.
Führen Sie die MongoDB-Abfragen unten aus.
db.createUser(
{
user: "admin",
pwd: "MyAdminPassword",
roles: [ { role: "root", db: "admin" } ]
}
)
Der MongoDB-Administratorbenutzer wurde erstellt.
Jetzt müssen wir die Konfigurationsdatei ‚/etc/mongod.conf‘ bearbeiten, um die Authentifizierung zu aktivieren.
Bearbeiten Sie die Konfigurationsdatei „mongod.conf“ mit vim.
vim /etc/mongod.conf
Entkommentieren Sie die Zeile „Sicherheit“ und fügen Sie die Konfiguration wie unten gezeigt hinzu.
security:
authorization: enabled
Speichern und beenden.
Starten Sie nun den MongoDB-Dienst neu.
systemctl restart mongod
Die MongoDB-Authentifizierung wurde aktiviert.
Als nächstes müssen wir eine neue Datenbank und einen neuen Benutzer für Wekan erstellen. Wir erstellen eine neue Datenbank namens „wekan“ mit dem Benutzer „wekan“ und dem Passwort „WekanPassword“.
Melden Sie sich als Admin-Benutzer bei der Mongo-Shell an.
mongo -u admin -p
Geben Sie das Admin-Passwort „MyAdminPassword“ ein.
Und wenn Sie die Mongo-Shell erhalten, führen Sie die MongoDB-Abfragen unten aus.
use wekan
db.createUser(
{
user: "wekan",
pwd: "WekanPassword",
roles: ["readWrite"]
}
)
Die Datenbank und der Benutzer für die Wekan-Installation wurden erstellt.
Schritt 4 – Wekan installieren
Melden Sie sich als 'wekan'-Benutzer an.
su - wekan
Laden Sie die neueste Version des Wekan-Quellcodes mit dem Befehl wget herunter und extrahieren Sie ihn.
wget https://github.com/wekan/wekan/releases/download/v0.63/wekan-0.63.tar.gz
tar xf wekan-0.63.tar.gz
Und Sie erhalten ein neues Verzeichnis mit dem Namen „bundle“. Wechseln Sie in dieses Verzeichnis und installieren Sie die Wekan-Abhängigkeiten mit dem npm-Befehl wie unten gezeigt.
cd bundle/programs/server
npm install
Nachdem die Installation abgeschlossen ist, erhalten Sie das unten gezeigte Ergebnis.
Als nächstes werden wir versuchen, Wekan auf dem System auszuführen.
Führen Sie die folgenden Befehle aus, um die Umgebungsvariablen für die Wekan-Anwendung einzurichten.
export MONGO_URL='mongodb://wekan:[email protected]:27017/wekan?authSource=wekan'
export ROOT_URL='http://192.168.33.10/'
export MAIL_URL='smtp://user:[email protected]:25/'
export MAIL_FROM='[email protected]'
export PORT=8000
Gehen Sie nun in das Verzeichnis „Bundle“ und führen Sie die Anwendung Wekan Node.js aus.
cd ~/bundle
node main.js
Der Wekan-Server läuft jetzt unter Port 8000. Öffnen Sie Ihren Webbrowser und geben Sie Ihre Serveradresse mit Port 8000 ein. Meine ist http://192.168.33.10:8000/
Und Sie erhalten die Wekan-Anmeldeseite wie unten gezeigt.
Wekan ist jetzt erfolgreich auf Ubuntu 16.04 installiert.
Schritt 5 – Wekan as a Service konfigurieren
Wir werden die Wekan-Anwendung als Dienst auf dem Ubuntu-System ausführen. Also müssen wir eine neue Servicedatei im systemd-Verzeichnis erstellen.
Bevor wir die Wekan-Dienstdatei erstellen, müssen wir die Umgebungsvariablendatei erstellen.
Melden Sie sich als 'wekan'-Benutzer an.
su - wekan
Gehen Sie in das Verzeichnis „bundle/“ und erstellen Sie mit vim
eine neue Umgebungsvariablendatei „.env“.cd bundle/
vim .env
Fügen Sie dort die folgende Konfiguration ein.
MONGO_URL='mongodb://wekan:[email protected]:27017/wekan?authSource=wekan'
ROOT_URL='http://wekan.hakase-labs.co'
MAIL_URL='smtp://user:[email protected]:25/'
MAIL_FROM='[email protected]'
PORT=8000
HTTP_FORWARDED_COUNT=1
Speichern und beenden.
Gehen Sie nun zurück zu Ihrem Root-Terminal und gehen Sie in das Verzeichnis ‚/etc/systemd/system‘, erstellen Sie dann eine neue Servicedatei ‚wekan.service‘.
cd /etc/systemd/system/
vim wekan.service
Fügen Sie dort die folgende Konfiguration ein.
[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
Speichern und beenden.
Laden Sie das systemd-System mit dem Befehl systemctl neu.
systemctl daemon-reload
Starten Sie den Wekan-Dienst und aktivieren Sie ihn so, dass er jedes Mal beim Systemstart gestartet wird.
systemctl start wekan
systemctl enable wekan
Überprüfen Sie nun den Wekan-Dienst mit den folgenden Befehlen.
netstat -plntu
systemctl status wekan
Und das Folgende sind die Ergebnisse.
Wekan läuft jetzt unter Port 8000 und läuft als Dienst auf einem Ubuntu 16.04-System.
Schritt 6 – Nginx als Reverse-Proxy für Wekan installieren
In diesem Schritt installieren wir den Nginx-Webserver und konfigurieren ihn als Reverse-Proxy für den Wekan-Dienst, der unter Port 8000 ausgeführt wird.
Installieren Sie den Nginx-Webserver aus dem Ubuntu-Repository mit dem folgenden apt-Befehl.
sudo apt install nginx -y
Gehen Sie nach Abschluss der Installation in das Verzeichnis „/etc/nginx/sites-available“ und erstellen Sie eine neue virtuelle Hostdatei „wekan“.
cd /etc/nginx/sites-available
vim wekan
Fügen Sie dort die folgende Konfiguration des virtuellen Hosts ein.
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;
}
} Speichern und beenden.
Aktivieren Sie nun den virtuellen Host und führen Sie die Test-Nginx-Konfiguration aus, und stellen Sie sicher, dass kein Fehler vorliegt.
ln -s /etc/nginx/sites-available/wekan /etc/nginx/sites-enabled/
nginx -t
Unter der Annahme, dass alles gut gelaufen ist, starten Sie jetzt den Nginx-Dienst neu und aktivieren Sie ihn so, dass er jedes Mal beim Systemstart gestartet wird.
systemctl restart nginx
systemctl enable nginx
Überprüfen Sie nun den HTTP-Port mit dem Befehl netstat und vergewissern Sie sich, dass er sich im Status „LISTEN“ befindet.
netstat -plntu
Die Konfiguration des virtuellen Nginx-Hosts für die Wekan Node.js-Anwendung wurde abgeschlossen.
Schritt 7 – Testen
Öffnen Sie Ihren Webbrowser und geben Sie die Wekan-Installations-URL in die Adressleiste ein, meine ist http://wekan.hakase-labs.co/
Und Sie werden zur Anmeldeseite weitergeleitet, klicken Sie auf den Link „Registrieren“.
Geben Sie nun Ihren Benutzernamen, Ihre E-Mail-Adresse und Ihr Passwort ein und lassen Sie den Einladungscode leer.
Klicken Sie auf die blaue Schaltfläche „Registrieren“.
Und Sie werden wahrscheinlich die Meldung „Internal Server Error“ erhalten – lassen Sie sie und kehren Sie zu Ihrem Terminal zurück. Weil wir den ersten Benutzer vom Terminal aus aktivieren.
Öffnen Sie Ihr Terminal und melden Sie sich als „wekan“-Benutzer bei der Mongo-Shell an.
mongo -u wekan -p --authenticationDatabase "wekan"
Aktivieren Sie nun den Benutzer mithilfe der folgenden Abfragen.
use wekan
db.users.update({username:'hakase'},{$set:{isAdmin:true}})
Beenden Sie die Mongo-Shell.
Kehren Sie zu Ihrem Browser zurück und öffnen Sie erneut die Wekan-URL-Installation.
http://wekan.hakase-labs.co/
Geben Sie Ihren Benutzernamen und Ihr Passwort ein und klicken Sie dann auf die Schaltfläche „Anmelden“.
Und jetzt sollten Sie das Wekan-Benutzer-Dashboard erhalten.
Unten ist das wekan-Beispielprojekt.
Die Wekan-Installation auf Ubuntu 16.04 mit MongoDB und Nginx-Webserver wurde erfolgreich abgeschlossen.
Referenz
- https://github.com/wekan/wekan/wiki