Come creare un Kanban minimalista in Linux con Kanboard

Kanboard è un tracker di progetti kanban leggero che puoi ospitare sul tuo server. A differenza di altri tracker kanban, mira a creare un’interfaccia semplice e intuitiva a cui puoi accedere da qualsiasi luogo.

Questo articolo ti mostrerà come installare Kanboard su Ubuntu 22.04. Metterà anche in evidenza il processo di estensione di Kanboard utilizzando plugin della comunità.

Indice dei contenuti

• Perché usare Kanboard?
• Installazione di Kanboard
• Configurazione di Kanboard per SSL
• Accesso e creazione di una bacheca Kanban
• Personalizzazione della tua bacheca Kanban con i plugin
• Domande frequenti

Perché usare Kanboard?

Uno dei maggiori vantaggi di Kanboard è che può funzionare su quasi qualsiasi server grazie alla magia di Docker. Di conseguenza, ospitare Kanboard è sia indolore che facile anche per gli utenti non tecnici.

A parte questo, Kanboard viene anche fornito con una piattaforma di plugin flessibile. Questo include la possibilità di creare tag, tracciare il tempo e eseguire script personalizzati. Ad esempio, puoi creare un plugin che aggiorna le proprietà di ogni scheda a seconda del suo contenuto.

Suggerimento: Scopri come essere efficiente ed efficace nella prioritizzazione delle attività comprendendo la matrice di Eisenhower.

Installazione di Kanboard

1. Il primo passo per installare Kanboard è assicurarti che il tuo sistema sia aggiornato. Puoi farlo eseguendo il seguente comando:

sudo apt update  
sudo apt upgrade

1. Installa la chiave del repository di terze parti del progetto Docker:

sudo install -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  
sudo chmod a+r /etc/apt/trusted.gpg.d/docker.gpg

1. Crea un nuovo file di repository apt utilizzando il tuo editor di testo preferito:

sudo nano /etc/apt/sources.list.d/docker.list

1. Scrivi le informazioni del repository per il repository ufficiale di Docker:

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

1. Salva il tuo nuovo file di repository premendo Ctrl + O, quindi Ctrl + X.

2. Aggiorna i dettagli del repository del tuo sistema eseguendo il seguente comando:

sudo apt update

1. Installa il motore Docker insieme alle sue dipendenze utilizzando apt:

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

Ottenere Kanboard

Una volta che hai installato correttamente il motore Docker, la prossima cosa da fare è recuperare lo script Docker Compose per Kanboard. Questo è un piccolo file di testo che contiene un elenco di opzioni che diranno a Docker come creare automaticamente Kanboard.

1. Crea una cartella separata nella tua directory home per Kanboard:

mkdir ~/kanboard  
cd ~/kanboard

1. Crea un nuovo file di testo con il nome “docker-compose.yml” tramite il tuo editor di testo preferito:

nano ~/kanboard/docker-compose.yml

1. Copia il seguente blocco di codice e incollalo all’interno del tuo file “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. Apri un nuovo terminale e genera una password sicura utilizzando il seguente comando:

cat /dev/urandom | tr -dc 'A-Za-z0-9' | fold -w 16 | head -n 1

1. Torna al tuo terminale precedente e incolla la tua password sicura in ogni istanza di “#!REPLACE-ME” all’interno del file.

1. Salva e esci dal tuo file “docker-compose.yml” premendo Ctrl + O, quindi Ctrl + X.

2. Ora puoi costruire il tuo container Docker di Kanboard eseguendo il seguente comando:

docker compose up -d

Buono a sapersi: Scopri come puoi creare una bacheca Kanban offline utilizzando Obsidian.md oggi.

Configurazione di Kanboard per SSL

A questo punto, hai ora un’installazione di Kanboard parzialmente funzionante. Tuttavia, per accedervi in modo sicuro, devi prima creare un proxy inverso Nginx. Questo fungerà da server web che fornisce bilanciamento del carico e SSL.

1. Installa il server web Nginx:

sudo apt install nginx

1. Crea un file di configurazione del sito per il tuo proxy inverso Nginx:

sudo nano /etc/nginx/sites-available/kanboard

1. Copia e incolla il seguente blocco di codice all’interno del tuo nuovo file di configurazione del sito:

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: sostituisci “my-kanban-domain-url.com” con il nome di dominio effettivo.

1. Crea un link simbolico per il tuo proxy inverso Kanboard:

sudo ln -s /etc/nginx/sites-available/kanboard /etc/nginx/sites-enabled/kanboard

1. Ricarica il demone del servizio Nginx:

sudo systemctl reload nginx.service

Ottenere un certificato SSL per Kanboard

Con il tuo proxy inverso attivo, ora puoi richiedere un certificato SSL per il tuo Kanboard. Questa sezione ti mostra come ottenere un certificato gratuito tramite il Certbot della Electronic Frontier Foundation (EFF).

1. Per iniziare, devi installare e aggiornare il demone core snap del tuo sistema:

sudo snap install core  
sudo snap refresh core

1. Installa il pacchetto snap certbot:

sudo snap install --classic certbot

1. Crea un link simbolico tra il binario snap certbot e la directory binaria predefinita del tuo sistema:

sudo ln -s /snap/bin/certbot /usr/bin/certbot

1. Testa se certbot è in esecuzione utilizzandolo per registrarsi presso l’EFF:

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

1. Genera un certificato SSL per il tuo nome di dominio eseguendo il seguente comando:

sudo certbot

Scegli il dominio dall’entry e farà il suo lavoro per generare SSL per il tuo dominio.

Buono a sapersi: Scopri di più sulla crittografia su Internet creando il tuo certificato SSL autofirmato.

Accesso e creazione di una bacheca Kanban

Ora puoi utilizzare Kanboard per creare e gestire bacheche Kanban. Per farlo, accedi alla tua istanza di Kanboard accedendo al suo nome di dominio da un browser web.

1. Usa “admin” come nome utente e password nella schermata di accesso.
2. Fai clic su “Nuovo progetto” per creare una bacheca Kanban pubblica.

1. Fornisci un nome e uno slug URL per la tua nuova bacheca.
2. Fai clic su “Accesso pubblico” nella barra laterale sinistra della pagina.

1. Fai clic sul pulsante blu “Abilita accesso pubblico”. Questo creerà un feed RSS e un link visibile pubblicamente che puoi condividere con utenti non Kanboard.

1. Fai clic sul pulsante “Bacheca” nell’angolo in alto a sinistra della pagina per accedere e creare nuovi elementi nella tua bacheca.

Creazione di un utente per bacheche Kanban collaborative

Oltre a condividere bacheche “solo visualizzazione” accessibili pubblicamente, puoi anche utilizzare Kanboard per creare bacheche collaborative “compito” tra più utenti locali.

1. Fai clic sull’icona dell’utente Admin nell’angolo in alto a destra della pagina, quindi seleziona “Gestione utenti.”

1. Fai clic sul link “Nuovo utente” lungo la barra laterale sinistra della pagina.
2. Questo aprirà un piccolo prompt di dialogo in cui Kanboard ti chiederà il nome utente e la password del tuo nuovo utente.

1. Scorri verso il basso fino in fondo al prompt e fai clic sulla casella a discesa sotto la categoria “Progetti”.

1. Seleziona la bacheca Kanban di cui vuoi che l’utente faccia parte.

1. Fai clic su “Salva” per creare il tuo nuovo account utente.

Personalizzazione della tua bacheca Kanban con i plugin

Una delle caratteristiche brillanti di Kanboard è che fornisce un framework per estendere la tua bacheca oltre le sue funzionalità di base. Questo significa che non devi fare affidamento sugli sviluppatori per includere una funzionalità personalizzata per il tuo server.

1. Per aggiungere un nuovo plugin, fai clic sull’icona dell’utente Admin nell’angolo in alto a destra della pagina, quindi seleziona “Plugin.”

1. Fai clic sulla categoria “Directory Plugin” nella barra laterale sinistra della pagina.

1. Trova un plugin che desideri installare nel tuo server Kanboard. Nel mio caso, installerò “MarkdownPlus” per estendere il Markdown di base nel mio server.

1. Fai clic su “Installa”, quindi aggiorna la pagina per caricare correttamente il plugin nel tuo server.

FYI: Kanban non è l’unico modo per gestire attività e dati. Scopri come puoi ottimizzare le tue liste To Do e i dati utilizzando Todoist oggi.

Domande frequenti

È possibile eseguire il backup dei contenuti della mia bacheca Kanban?

Sì. Per eseguire il backup di una specifica bacheca Kanban, fai clic sull’icona dell’ingranaggio sulla bacheca che desideri esportare e poi fai clic su “Esportazioni.”

Questo aprirà un piccolo prompt in cui Kanboard ti chiederà un intervallo di date che desideri esportare. Fornisci una data di inizio e una di fine, quindi fai clic su “Esporta.”

È possibile ripristinare il periodo di “blocco” della mia bacheca Kanban?

Sì. È possibile ripristinare il timer di blocco di un particolare utente in Kanboard. Per farlo, fai clic sull’icona dell’utente Admin nell’angolo in alto a destra della pagina. Successivamente, seleziona l’elemento “Gestione utenti” e fai clic sul nome dell’utente bloccato. Infine, vai alla categoria “Sicurezza” e fai clic su “Sblocca questo utente.”

È possibile modificare il file config.php all’interno del mio container Kanboard?

Sì. Tuttavia, farlo potrebbe potenzialmente rovinare la coerenza della tua immagine Docker. Invece, gli sviluppatori del programma suggeriscono di utilizzare le variabili di ambiente all’interno del tuo file docker-compose.yml quando configuri i valori della tua istanza di Kanboard.

Crediti immagine: Eden Constantino tramite Unsplash. Tutte le modifiche e gli screenshot di Ramces Red.