En este tutorial, cubriremos los pasos necesarios para instalar Wekan en un VPS Debian 9.
Wekan es un tablero Kanban gratuito, flexible y de código abierto. Con Wekan podemos crear tableros y tarjetas que se pueden mover entre varias columnas. Wekan le permite invitar a miembros a la junta y asignar tareas a un miembro específico. Esto maximiza la productividad en un equipo porque cada miembro puede ver exactamente qué tan avanzadas están todas las tareas y enfocarse en las tareas según su prioridad. El proceso de instalación no llevará mucho tiempo, así que comencemos con la instalación.
Requisitos previos
- Para los propósitos de este tutorial, usaremos un VPS Debian 9.
- Al menos 1 GB de RAM libre para Wekan. Un servidor de producción debe tener un total mínimo de 4 GB de RAM.
- También se requiere acceso SSH completo usando la cuenta raíz o un usuario con privilegios sudo.
Paso 1:Primeros pasos
Conéctese a su servidor a través de SSH como usuario raíz usando el siguiente comando:
ssh root@IP_ADDRESS -p PORT_NUMBER
y reemplace "IP_ADDRESS" y "PORT_NUMBER" con la dirección IP de su servidor real y el número de puerto SSH. Reemplace 'root' por el nombre de usuario de una cuenta diferente si es necesario.
Antes de comenzar con la instalación, deberá actualizar los paquetes de su sistema a sus últimas versiones.
Puede hacerlo ejecutando el siguiente comando:
apt-get update apt-get upgrade
Paso 2:Instalar Node.js
En los sistemas Debian, puede instalar Node.js desde el repositorio de NodeSource:
$ apt-get update $ apt install curl git gcc g++ make
Después de eso, instala el repositorio de Node.js con el siguiente comando
$ curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
Después de eso, ejecute los siguientes comandos para instalar Node.js:
$ apt-get install nodejs
Paso 3:Comprobar la versión de Node.js
Después de completar la instalación, compruebe y verifique la versión instalada de Node.js y NPM. Puede encontrar más detalles sobre la versión actual en el sitio web oficial de Node.js.
$ node -v v12.2.0
Además, verifique la versión de NPM.
$ npm -v 6.9.0
Si son las versiones que se muestran arriba o más nuevas, puede continuar con el siguiente paso.
Paso 4:Instale el servidor de base de datos MongoDB
MongoDB es el servidor de base de datos predeterminado para Wekan. Inicie la instalación importando la clave pública utilizada por el sistema de gestión de paquetes.
$ apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
Agregue el repositorio de MongoDB:
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/4.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
Actualice el índice del paquete apt e instale el servidor MongoDB:
$ apt-get update $ apt-get install -y mongodb-org
Inicie el servicio MongoDB:
$ systemctl start mongod.service $ systemctl enable mongod.service
Verifique la instalación de MongoDB. Debe tener la versión 4.0 o posterior:
$ mongod --version
db version v4.0.9
git version: fc525e2d9b0e4bceff5c2201457e564362909765
OpenSSL version: OpenSSL 1.1.0j 20 Nov 2018
allocator: tcmalloc
modules: none
build environment:
distmod: debian92
distarch: x86_64
target_arch: x86_64
Paso 5:Configurar MongoDB
Necesitamos configurar la autenticación MongoDB. Iniciaremos sesión en el shell de mongo y crearemos un nuevo superusuario 'administrador'. Inicie sesión en MongoDB ejecutando el siguiente comando:
mongo
Luego cambie al administrador de base de datos y cree un nuevo usuario administrador:
use admin
Ejecutaremos la consulta de Mongo a continuación para crear un nuevo usuario administrador con contraseña y establecer el rol como root.
db.createUser(
{
user: "admin",
pwd: "MyAdminPassword",
roles: [ { role: "root", db: "admin" } ]
}
) Asegúrese de reemplazar 'MyAdminPassword' con una contraseña segura.
El usuario administrador ya se ha creado.
Reinicie el servicio MongoDB y la autenticación MongoDB debería estar habilitada.
systemctl restart mongod
Necesitamos crear una nueva base de datos llamada 'wekan' con el usuario 'wekan' con la contraseña 'StrongPassword'. Cambie la contraseña en consecuencia.
Inicie sesión en mongo shell como usuario administrador.
mongo -u admin -p
En el shell de Mongo ejecutaremos las siguientes consultas:
use wekan
db.createUser(
{
user: "wekan",
pwd: "StrongPassword",
roles: ["readWrite"]
}
) Creamos con éxito una base de datos y un usuario para la instalación de Wekan.
Paso 6:Instalar Wekan
Primero, creemos un wekan usuario para que root no ejecute su aplicación Wekan.
$ adduser wekan --disabled-login --no-create-home
Iniciaremos sesión como el usuario 'wekan'.
$ su - wekan
Descargaremos la última versión del código fuente wekan usando el comando wget y lo extraeremos.
$ wget https://github.com/wekan/wekan/releases/download/v0.63/wekan-0.63.tar.gz $ tar xf wekan-0.63.tar.gz
También haremos que nuestro nuevo usuario sea propietario de todos los directorios de instalación de Wekan para que pueda ejecutarlos sin ningún problema:
$ chown -R wekan:wekan /opt/bundle
Iremos a ese directorio e instalaremos las dependencias de Wekan usando el comando 'npm'.
$ cd /opt/bundle/programs/server $ npm install
Ahora ejecutaremos los siguientes comandos para crear las variables de entorno para la aplicación Wekan.
$ export MONGO_URL='mongodb://wekan:[email protected]:27017/wekan?authSource=wekan' $ export ROOT_URL='http://your_ip_address/' $ export MAIL_URL='smtp://user:pass@your_domain.com:25/' $ export MAIL_FROM='wekan@your_domain.com' $ export PORT=8000
Iremos al directorio ‘bundle’ y ejecutaremos la aplicación Wekan Node.js.
$ cd /opt/bundle $ node main.js
Wekan se instaló correctamente y está escuchando en el puerto 8000.
Paso 7:configurar el servicio Wekan SystemD
Ahora tiene Wekan en funcionamiento, pero dejará de funcionar una vez que cierre la sesión de la terminal. Para evitar esto, debemos crear un servicio SystemD para que lo ejecute el sistema en lugar del usuario.
Cree un archivo llamado wekan.service en /etc/systemd/system/ , utilizando su editor de texto preferido:
$ cd /etc/systemd/system/ $ nano wekan.service
Pegue el siguiente contenido:
[Unit] Description=Wekan Server After=syslog.target After=network.target [Service] Type=simple Restart=always StandardOutput=syslog SyslogIdentifier=Wekan User=wekan Group=wekan Environment=MONGO_URL=mongodb://127.0.0.1:27017/wekan Environment=ROOT_URL=https://example.com Environment=PORT=8000 Environment=MAIL_URL=smtp://user:[email protected]:25/ WorkingDirectory=/opt/bundle ExecStart=/usr/bin/node /opt/bundle/main.js [Install] WantedBy=multi-user.target
Asegúrese de reemplazar 'example.com' con su nombre de dominio registrado. Guarde y cierre el archivo.
Para que SystemD sea consciente de este nuevo archivo, ejecute el siguiente comando:
$ systemctl daemon-reload
Inicie el servicio Wekan y actívelo.
$ systemctl start wekan $ systemctl enable wekan
Paso 8:Accede a Wekan
Abra su navegador web favorito y escriba la URL http://your_ip_address:8000 . Seremos redirigidos a la página de inicio de sesión de Wekan.
Eso es todo. Si siguió todas las instrucciones correctamente, ahora debería poder acceder a su instalación de Wekan en su servidor Debian 9.
Por supuesto, no tienes que i instalar Wekan en Debian 9 si tiene un VPS Debian con nosotros. Si es así, puede instalar Wekan en su servidor simplemente pidiéndole a nuestro equipo de soporte que instale Wekan en Debian 9 por usted. Están disponibles las 24 horas del día, los 7 días de la semana y podrán ayudarlo con la instalación.
PD . Si disfrutó leyendo esta publicación de blog sobre cómo instalar Wekan en Debian 9, siéntase libre de compartirla en las redes sociales utilizando los accesos directos para compartir, o simplemente deje un comentario en la sección de comentarios. Gracias.