Comment créer un Kanban minimaliste sous Linux avec Kanboard

Une photographie de deux personnes tenant une série de notes autocollantes.

Kanboard est un outil de suivi de projet kanban léger que vous pouvez héberger sur votre propre serveur. Contrairement à d’autres outils de suivi kanban, il vise à créer une interface simple et intuitive à laquelle vous pouvez accéder de n’importe où.

Cet article vous montrera comment installer Kanboard sur Ubuntu 22.04. Il mettra également en évidence le processus d’extension de Kanboard à l’aide de plugins communautaires.

Table des matières

  • Pourquoi utiliser Kanboard ?
  • Installer Kanboard
  • Configurer Kanboard pour SSL
  • Se connecter et créer un tableau Kanban
  • Personnaliser votre tableau Kanban avec des plugins
  • Questions fréquentes

Pourquoi utiliser Kanboard ?

L’un des plus grands avantages de Kanboard est qu’il peut fonctionner sur presque n’importe quel serveur grâce à la magie de Docker. En conséquence, l’hébergement de Kanboard est à la fois indolore et facile même pour les utilisateurs non techniques.

En plus de cela, Kanboard est également livré avec une plateforme de plugins flexible. Cela inclut la possibilité de créer des étiquettes, de suivre le temps et d’exécuter des scripts personnalisés. Par exemple, vous pouvez créer un plugin qui met à jour les propriétés de chaque carte en fonction de son contenu.

Une capture d'écran d'une instance Kanboard fonctionnelle.

Astuce : Apprenez à être efficace et efficace dans la priorisation des tâches en comprenant la matrice d’Eisenhower.

Installer Kanboard

  1. La première étape pour installer Kanboard est de vous assurer que votre système est à jour. Vous pouvez le faire en exécutant la commande suivante :
sudo apt update  
sudo apt upgrade
  1. Installez la clé du dépôt tiers du projet 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. Créez un nouveau fichier de dépôt apt en utilisant votre éditeur de texte préféré :
sudonano/etc/apt/sources.list.d/docker.list
  1. Écrivez les informations du dépôt pour le dépôt officiel de Docker :
deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable
  1. Enregistrez votre nouveau fichier de dépôt en appuyant sur Ctrl + O, puis Ctrl + X.

  2. Mettez à jour les détails du dépôt de votre système en exécutant la commande suivante :

sudo apt update
  1. Installez le moteur Docker ainsi que ses dépendances en utilisant apt :
sudo apt installwget docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin

Obtenir Kanboard

Une fois que vous avez correctement installé le moteur Docker, la prochaine chose à faire est de récupérer le script Docker Compose pour Kanboard. Il s’agit d’un petit fichier texte qui contient une liste d’options qui indiqueront à Docker comment créer automatiquement Kanboard.

  1. Créez un dossier séparé dans votre répertoire personnel pour Kanboard :
mkdir ~/kanboard  
cd ~/kanboard
  1. Créez un nouveau fichier texte nommé “docker-compose.yml” à l’aide de votre éditeur de texte préféré :
nano ~/kanboard/docker-compose.yml
  1. Copiez le bloc de code suivant et collez-le dans votre fichier “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. Ouvrez un nouveau terminal et générez un mot de passe sécurisé en utilisant la commande suivante :
cat/dev/urandom |tr-dc'A-Za-z0-9'| fold -w16|head-n1
  1. Retournez à votre terminal précédent et collez votre mot de passe sécurisé dans chaque instance de “#!REPLACE-ME” à l’intérieur du fichier.

Un terminal montrant un fichier Docker compose fonctionnel pour Kanboard.

  1. Enregistrez et quittez votre fichier “docker-compose.yml” en appuyant sur Ctrl + O, puis Ctrl + X.

  2. Vous pouvez maintenant construire votre conteneur Docker Kanboard en exécutant la commande suivante :

docker compose up -d

Un terminal montrant le processus de construction pour Docker Compose.

Bon à savoir : Apprenez comment vous pouvez créer un tableau Kanban hors ligne en utilisant Obsidian.md aujourd’hui.

Configurer Kanboard pour SSL

À ce stade, vous avez maintenant une installation Kanboard partiellement fonctionnelle. Cependant, pour y accéder de manière sécurisée, vous devez d’abord créer un proxy inverse Nginx. Cela servira de serveur accessible sur le web qui fournit un équilibrage de charge et SSL.

  1. Installez le serveur web Nginx :
sudo apt install nginx
  1. Créez un fichier de configuration de site pour votre proxy inverse Nginx :
sudonano/etc/nginx/sites-available/kanboard
  1. Copiez et collez le bloc de code suivant dans votre nouveau fichier de configuration de site :
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;  
}  
}

Remarque : remplacez “my-kanban-domain-url.com” par le nom de domaine réel.

  1. Créez un lien symbolique pour votre proxy inverse Kanboard :
sudoln-s/etc/nginx/sites-available/kanboard /etc/nginx/sites-enabled/kanboard
  1. Rechargez votre service daemon Nginx :
sudo systemctl reload nginx.service

Obtenir un certificat SSL pour Kanboard

Avec votre proxy inverse en place, vous pouvez maintenant demander un certificat SSL pour votre Kanboard. Cette section vous montre comment obtenir un certificat gratuit via le Certbot de l’Electronic Frontier Foundation (EFF).

  1. Pour commencer, vous devez installer et mettre à jour le daemon snap de base de votre système :
sudo snap install core  
sudo snap refresh core
  1. Installez le paquet snap certbot :
sudo snap install--classic certbot
  1. Créez un lien symbolique entre le binaire snap certbot et le répertoire binaire par défaut de votre système :
sudoln-s/snap/bin/certbot /usr/bin/certbot
  1. Testez si certbot fonctionne en l’utilisant pour s’enregistrer auprès de l’EFF :
sudo certbot register --agree-tos--email [email protected]
  1. Générez un certificat SSL pour votre nom de domaine en exécutant la commande suivante :
sudo certbot

Choisissez le domaine dans l’entrée et il fera son travail pour générer SSL pour votre domaine.

Bon à savoir : En savoir plus sur le chiffrement sur Internet en créant votre propre certificat SSL auto-signé.

Se connecter et créer un tableau Kanban

Vous pouvez maintenant utiliser Kanboard pour créer et gérer des tableaux Kanban. Pour ce faire, connectez-vous à votre instance Kanboard en accédant à son nom de domaine depuis un navigateur web.

  1. Utilisez “admin” comme nom d’utilisateur et mot de passe sur l’écran de connexion.
  2. Cliquez sur “Nouveau projet” pour créer un tableau Kanban public.

Une capture d'écran mettant en évidence le lien

  1. Fournissez un nom et un slug d’URL pour votre nouveau tableau.
  2. Cliquez sur “Accès public” dans la barre latérale gauche de la page.

Une capture d'écran mettant en évidence le lien

  1. Cliquez sur le bouton bleu “Activer l’accès public”. Cela créera un flux RSS et un lien visible publiquement que vous pouvez partager avec des utilisateurs non-Kanboard.

Une capture d'écran montrant le bouton

  1. Cliquez sur le bouton “Tableau” dans le coin supérieur gauche de la page pour accéder et créer de nouveaux éléments dans votre tableau.

Une capture d'écran montrant un tableau Kanban public en cours d'exécution.

Créer un utilisateur pour des tableaux Kanban collaboratifs

En plus de partager des tableaux accessibles au public en mode “lecture seule”, vous pouvez également utiliser Kanboard pour créer des tableaux collaboratifs “tâches” entre plusieurs utilisateurs locaux.

  1. Cliquez sur l’icône de l’utilisateur Admin dans le coin supérieur droit de la page, puis sélectionnez “Gestion des utilisateurs”.

Une capture d'écran mettant en évidence le sous-menu

  1. Cliquez sur le lien “Nouvel utilisateur” dans la barre latérale gauche en haut de la page.
  2. Cela fera apparaître une petite invite de dialogue où Kanboard vous demandera le nom d’utilisateur et le mot de passe de votre nouvel utilisateur.

Une capture d'écran montrant le formulaire Nouvel utilisateur dans Kanboard.

  1. Faites défiler vers le bas de l’invite et cliquez sur la boîte déroulante sous la catégorie “Projets”.

Une capture d'écran montrant la sous-catégorie

  1. Sélectionnez le tableau Kanban dont vous souhaitez que l’utilisateur fasse partie.

Une capture d'écran montrant la sélection du tableau pour le nouvel utilisateur.

  1. Cliquez sur “Enregistrer” pour créer votre nouveau compte utilisateur.

Une capture d'écran montrant le bouton Enregistrer pour l'invite Nouvel utilisateur.

Personnaliser votre tableau Kanban avec des plugins

L’une des fonctionnalités brillantes de Kanboard est qu’il fournit un cadre pour étendre votre tableau au-delà de ses fonctionnalités de base. Cela signifie que vous n’avez pas besoin de compter sur les développeurs pour inclure une fonctionnalité personnalisée pour votre serveur.

  1. Pour ajouter un nouveau plugin, cliquez sur l’icône de l’utilisateur Admin dans le coin supérieur droit de la page, puis sélectionnez “Plugins”.

Une capture d'écran mettant en évidence la sous-catégorie

  1. Cliquez sur la catégorie “Répertoire des plugins” dans la barre latérale gauche de la page.

Une capture d'écran montrant la sous-catégorie

  1. Trouvez un plugin que vous souhaitez installer sur votre serveur Kanboard. Dans mon cas, je vais installer “MarkdownPlus” pour étendre le Markdown de base sur mon serveur.

Une capture d'écran montrant les plugins disponibles dans Kanboard.

  1. Cliquez sur “Installer”, puis actualisez la page pour charger correctement le plugin sur votre serveur.

FYI : Kanban n’est pas le seul moyen de gérer des tâches et des données. Apprenez comment vous pouvez optimiser vos listes de tâches et vos données en utilisant Todoist aujourd’hui.

Questions fréquentes

Est-il possible de sauvegarder le contenu de mon tableau Kanban ?

Oui. Pour sauvegarder un tableau Kanban spécifique, cliquez sur l’icône d’engrenage sur le tableau que vous souhaitez exporter, puis cliquez sur “Exports”.

Cela fera apparaître une petite invite où Kanboard vous demandera une plage de dates que vous souhaitez exporter. Fournissez une date de début et de fin, puis cliquez sur “Exporter”.

Est-il possible de réinitialiser la période “verrouillée” de mon tableau Kanban ?

Oui. Il est possible de réinitialiser le minuteur de verrouillage d’un utilisateur particulier dans Kanboard. Pour ce faire, cliquez sur l’icône de l’utilisateur Admin dans le coin supérieur droit de la page. Ensuite, sélectionnez l’élément “Gestion des utilisateurs”, puis cliquez sur le nom de l’utilisateur verrouillé. Enfin, allez dans la catégorie “Sécurité” et cliquez sur “Déverrouiller cet utilisateur”.

Est-il possible de modifier le fichier config.php à l’intérieur de mon conteneur Kanboard ?

Oui. Cependant, faire cela pourrait potentiellement ruiner la cohérence de votre image Docker. Au lieu de cela, les développeurs du programme suggèrent d’utiliser les variables d’environnement à l’intérieur de votre fichier docker-compose.yml lors de la configuration des valeurs de votre instance Kanboard.

Crédit d’image : Eden Constantino via Unsplash. Toutes les modifications et captures d’écran par Ramces Red.