Cómo crear un Kanban minimalista en Linux con Kanboard

Kanboard es un rastreador de proyectos kanban ligero que puedes alojar en tu propio servidor. A diferencia de otros rastreadores kanban, su objetivo es crear una interfaz simple e intuitiva a la que puedes acceder desde cualquier lugar.

Este artículo te mostrará cómo puedes instalar Kanboard en Ubuntu 22.04. También destacará el proceso de extender Kanboard utilizando plugins de la comunidad.

Tabla de Contenidos

• ¿Por qué usar Kanboard?
• Instalando Kanboard
• Configurando Kanboard para SSL
• Iniciando sesión y creando un tablero Kanban
• Personalizando tu tablero Kanban con plugins
• Preguntas Frecuentes

¿Por qué usar Kanboard?

Una de las mayores ventajas de Kanboard es que puede funcionar en casi cualquier servidor gracias a la magia de Docker. Como resultado, alojar Kanboard es tanto indoloro como fácil incluso para usuarios no técnicos.

Aparte de eso, Kanboard también viene con una plataforma de plugins flexible. Esto incluye la capacidad de crear etiquetas, rastrear tiempo y ejecutar scripts personalizados. Por ejemplo, puedes crear un plugin que actualice las propiedades de cada tarjeta dependiendo de su contenido.

Consejo: Aprende a ser eficiente y efectivo al priorizar tareas entendiendo la Matriz de Eisenhower.

Instalando Kanboard

1. El primer paso para instalar Kanboard es asegurarte de que tu sistema esté actualizado. Puedes hacer esto ejecutando el siguiente comando:

sudo apt update  
sudo apt upgrade

1. Instala la clave del repositorio de terceros del proyecto Docker:

sudoinstall-m 0755 -d/etc/apt/keyrings  
curl -fsSL https://download.docker.com/linux/ubuntu/gpg |sudo gpg --dearmor-o/etc/apt/trusted.gpg.d/docker.gpg  
sudochmod a+r /etc/apt/trusted.gpg.d/docker.gpg

1. Crea un nuevo archivo de repositorio apt usando tu editor de texto favorito:

sudonano/etc/apt/sources.list.d/docker.list

1. Escribe la información del repositorio para el repositorio oficial de Docker:

deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable

1. Guarda tu nuevo archivo de repositorio presionando Ctrl + O, luego Ctrl + X.

2. Actualiza los detalles del repositorio de tu sistema ejecutando el siguiente comando:

sudo apt update

1. Instala el motor Docker junto con sus dependencias usando apt:

sudo apt installwget docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin

Obtención de Kanboard

Una vez que tengas el motor Docker correctamente instalado, lo siguiente que debes hacer es obtener el script de Docker Compose para Kanboard. Este es un pequeño archivo de texto que contiene una lista de opciones que le dirán a Docker cómo crear Kanboard automáticamente.

1. Crea una carpeta separada en tu directorio personal para Kanboard:

mkdir ~/kanboard  
cd ~/kanboard

1. Crea un nuevo archivo de texto con el nombre “docker-compose.yml” a través de tu editor de texto favorito:

nano ~/kanboard/docker-compose.yml

1. Copia el siguiente bloque de código y pégalo dentro de tu archivo “docker-compose.yml”:

version: '2'  
services:  
  kanboard:  
    image: kanboard/kanboard:latest  
    ports:  
      - 8080:80  
    volumes:  
      - kanboard_data:/var/www/app/data  
      - kanboard_plugins:/var/www/app/plugins  
    environment:  
      DATABASE_URL: mysql://kanboard:!#REPLACE-ME@db/kanboard  
      PLUGIN_INSTALLER: true  
  db:  
    image: mariadb:latest  
    command: --default-authentication-plugin=mysql_native_password  
    environment:  
      MYSQL_ROOT_PASSWORD: !#REPLACE-ME  
      MYSQL_DATABASE: kanboard  
      MYSQL_USER: kanboard  
      MYSQL_PASSWORD: !#REPLACE-ME  
    volumes:  
    - db:/var/lib/mysql  
volumes:  
  kanboard_data:  
  kanboard_plugins:  
  db:

1. Abre una nueva terminal y genera una contraseña segura usando el siguiente comando:

cat/dev/urandom |tr-dc'A-Za-z0-9'| fold -w16|head-n1

1. Regresa a tu terminal anterior y pega tu contraseña segura en cada instancia de “#!REPLACE-ME” dentro del archivo.

1. Guarda y sal de tu archivo “docker-compose.yml” presionando Ctrl + O, luego Ctrl + X.

2. Ahora puedes construir tu contenedor docker de Kanboard ejecutando el siguiente comando:

docker compose up -d

Bueno saber: Aprende cómo puedes crear un tablero Kanban sin conexión usando Obsidian.md hoy.

Configurando Kanboard para SSL

En este punto, ahora tienes una instalación de Kanboard parcialmente funcional. Sin embargo, para acceder de forma segura, primero necesitas crear un proxy inverso Nginx. Esto servirá como tu servidor de cara a la web que proporciona balanceo de carga y SSL.

1. Instala el servidor web Nginx:

sudo apt install nginx

1. Crea un archivo de configuración de sitio para tu proxy inverso Nginx:

sudonano/etc/nginx/sites-available/kanboard

1. Copia y pega el siguiente bloque de código dentro de tu nuevo archivo de configuración de sitio:

server {  
    listen 80;  
    listen [::]:80;  
  
    root                    /var/www/html;  
    server_name             my-kanban-domain-url.com;  
  
    location /{  
        proxy_set_header    X-Forwarded-For $remote_addr;  
        proxy_set_header    Host $http_host;  
        proxy_pass          http://localhost:8080;  
}  
}

Nota: reemplaza “my-kanban-domain-url.com” con el nombre de dominio real.

1. Crea un enlace simbólico para tu proxy inverso de Kanboard:

sudoln-s/etc/nginx/sites-available/kanboard /etc/nginx/sites-enabled/kanboard

1. Recarga el daemon de servicio de Nginx:

sudo systemctl reload nginx.service

Obtención de un certificado SSL para Kanboard

Con tu proxy inverso en funcionamiento, ahora puedes solicitar un certificado SSL para tu Kanboard. Esta sección te muestra cómo obtener un certificado gratuito a través del Certbot de la Electronic Frontier Foundation (EFF).

1. Para comenzar, necesitas instalar y actualizar el daemon snap core de tu sistema:

sudo snap install core  
sudo snap refresh core

1. Instala el paquete snap certbot:

sudo snap install--classic certbot

1. Crea un enlace simbólico entre el binario snap certbot y el directorio binario predeterminado de tu sistema:

sudoln-s/snap/bin/certbot /usr/bin/certbot

1. Prueba si certbot está funcionando usándolo para registrarse en la EFF:

sudo certbot register --agree-tos--email [email protected]

1. Genera un certificado SSL para tu nombre de dominio ejecutando el siguiente comando:

sudo certbot

Elige el dominio de la entrada y hará su trabajo para generar SSL para tu dominio.

Bueno saber: Aprende más sobre la encriptación a través de internet creando tu propio certificado SSL autofirmado.

Iniciando sesión y creando un tablero Kanban

Ahora puedes usar Kanboard para crear y gestionar tableros Kanban. Para hacerlo, inicia sesión en tu instancia de Kanboard accediendo a su nombre de dominio desde un navegador web.

1. Usa “admin” como el nombre de usuario y contraseña en la pantalla de inicio de sesión.
2. Haz clic en “Nuevo proyecto” para crear un tablero Kanban público.

1. Proporciona un nombre y un slug de URL para tu nuevo tablero.
2. Haz clic en “Acceso Público” en la barra lateral izquierda de la página.

1. Haz clic en el botón azul “Habilitar Acceso Público”. Esto creará un feed RSS y un enlace visible públicamente que puedes compartir con usuarios que no usan Kanboard.

1. Haz clic en el botón “Tablero” en la esquina superior izquierda de la página para acceder y crear nuevos elementos en tu tablero.

Creando un usuario para tableros Kanban colaborativos

Aparte de compartir tableros “solo lectura” accesibles públicamente, también puedes usar Kanboard para crear tableros colaborativos de “tareas” entre múltiples usuarios locales.

1. Haz clic en el ícono del usuario Admin en la esquina superior derecha de la página, luego selecciona “Gestión de usuarios”.

1. Haz clic en el enlace “Nuevo Usuario” en la barra lateral izquierda de la página.
2. Esto abrirá un pequeño cuadro de diálogo donde Kanboard te pedirá el nombre de usuario y la contraseña de tu nuevo usuario.

1. Desplázate hacia abajo hasta el final del cuadro de diálogo y haz clic en el cuadro desplegable bajo la categoría “Proyectos”.

1. Selecciona el tablero Kanban del que deseas que el usuario forme parte.

1. Haz clic en “Guardar” para crear tu nueva cuenta de usuario.

Personalizando tu tablero Kanban con plugins

Una de las características brillantes de Kanboard es que proporciona un marco para extender tu tablero más allá de sus características básicas. Esto significa que no necesitas depender de los desarrolladores para incluir una función personalizada para tu servidor.

1. Para agregar un nuevo plugin, haz clic en el ícono del usuario Admin en la esquina superior derecha de la página, luego selecciona “Plugins”.

1. Haz clic en la categoría “Directorio de Plugins” en la barra lateral izquierda de la página.

1. Encuentra un plugin que deseas instalar en tu servidor Kanboard. En mi caso, instalaré “MarkdownPlus” para extender el Markdown básico en mi servidor.

1. Haz clic en “Instalar”, luego actualiza la página para cargar correctamente el plugin en tu servidor.

FYI: Kanban no es la única forma de gestionar tareas y datos. Aprende cómo puedes optimizar tus listas de tareas y datos usando Todoist hoy.

Preguntas Frecuentes

¿Es posible hacer una copia de seguridad del contenido de mi tablero Kanban?

Sí. Para hacer una copia de seguridad de un tablero Kanban específico, haz clic en el ícono de engranaje en el tablero que deseas exportar y luego haz clic en “Exportaciones.”

Esto abrirá un pequeño cuadro de diálogo donde Kanboard te pedirá un rango de fechas que deseas exportar. Proporciona una fecha de inicio y una fecha de finalización, luego haz clic en “Exportar.”

¿Es posible restablecer el período de “bloqueo” de mi tablero Kanban?

Sí. Es posible restablecer el temporizador de bloqueo de un usuario particular en Kanboard. Para hacer esto, haz clic en el ícono del usuario Admin en la esquina superior derecha de la página. A continuación, selecciona el elemento “Gestión de usuarios” y luego haz clic en el nombre del usuario bloqueado. Por último, ve a la categoría “Seguridad” y haz clic en “Desbloquear a este usuario.”

¿Es posible modificar el archivo config.php dentro de mi contenedor Kanboard?

Sí. Sin embargo, hacer esto podría arruinar la consistencia de tu imagen Docker. En su lugar, los desarrolladores del programa sugieren que uses las variables de entorno dentro de tu archivo docker-compose.yml al configurar los valores de tu instancia de Kanboard.

Crédito de la imagen: Eden Constantino a través de Unsplash. Todas las alteraciones y capturas de pantalla por Ramces Red.