Como criar um Kanban minimalista no Linux com Kanboard

Kanboard é um rastreador de projeto kanban leve que você pode hospedar em seu próprio servidor. Ao contrário de outros rastreadores kanban, seu objetivo é criar uma interface simples e intuitiva que você possa acessar de qualquer lugar.

Este artigo mostrará como você pode instalar o Kanboard no Ubuntu 22.04. Também destacará o processo de extensão do Kanboard usando plug-ins da comunidade.

Por que usar o Kanboard?

Uma das maiores vantagens do Kanboard é que ele pode funcionar em praticamente qualquer servidor através da magia do Docker. Como resultado, hospedar o Kanboard é simples e fácil, mesmo para usuários não técnicos.

Além disso, o Kanboard também vem com uma plataforma de plugins flexível. Isso inclui a capacidade de criar tags, monitorar o tempo e executar scripts personalizados. Por exemplo, você pode criar um plugin que atualize as propriedades de cada cartão dependendo do seu conteúdo.

Dica: Aprenda como ser eficiente e eficaz na priorização de tarefas, compreendendo a Matriz de Eisenhower.

Instalando o Kanboard

1. O primeiro passo para instalar o Kanboard é certificar-se de que seu sistema está atualizado. Você pode fazer isso executando o seguinte comando:

sudo apt update
sudo apt upgrade

2. Instale a chave do repositório de terceiros do projeto 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

3. Crie um novo arquivo de repositório apt usando seu editor de texto favorito:

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

4. Escreva as informações do repositório oficial do Docker:

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

5. Salve seu novo arquivo de repositório pressionando Ctrl + Óentão Ctrl + X.

6. Atualize os detalhes do repositório do seu sistema executando o seguinte comando:

sudo apt update

7. Instale o mecanismo Docker junto com suas dependências usando apt:

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

Obtendo Kanboard

Depois de instalar o mecanismo Docker corretamente, a próxima coisa a fazer é buscar o script Docker Compose para Kanboard. Este é um pequeno arquivo de texto que contém uma lista de opções que informarão ao Docker como criar Kanboard automaticamente.

1. Crie uma pasta separada em seu diretório inicial para Kanboard:

mkdir ~/kanboard
cd ~/kanboard

2. Crie um novo arquivo de texto com o nome “docker-compose.yml” através do seu editor de texto favorito:

nano ~/kanboard/docker-compose.yml

3. Copie o seguinte bloco de código e cole-o dentro do arquivo “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:

4. Abra um novo terminal e gere uma senha segura usando o seguinte comando:

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

5. Volte ao seu terminal anterior e cole sua senha segura em cada instância de “#!REPLACE-ME” dentro do arquivo.

6. Salve e saia do arquivo “docker-compose.yml” pressionando Ctrl + Óentão Ctrl + X.

7. Agora você pode criar seu contêiner docker Kanboard executando o seguinte comando:

docker compose up -d

Bom saber: Aprenda como você pode criar um quadro Kanban offline usando Obsidian.md hoje mesmo.

Configurando o Kanboard para SSL

Neste ponto, agora você tem uma instalação do Kanboard parcialmente funcional. No entanto, para acessá-lo com segurança, você precisa primeiro criar um proxy reverso Nginx. Ele servirá como seu servidor web que fornece balanceamento de carga e SSL.

3. Instale o servidor Nginx:

sudo apt install nginx

4. Crie um arquivo de configuração de site para seu proxy reverso Nginx:

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

5. Copie e cole o seguinte bloco de código dentro do novo arquivo de configuração do 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;
    }
}

Observação: substitua “my-kanban-domain-url.com” pelo nome de domínio real.

6. Crie um link simbólico para seu proxy reverso Kanboard:

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

7. Recarregue seu daemon de serviço Nginx:

sudo systemctl reload nginx.service

Obtendo um certificado SSL para Kanboard

Com seu proxy reverso ativado, agora você pode solicitar um certificado SSL para seu Kanboard. Esta seção mostra como obter um certificado gratuito por meio do Certbot da Electronic Frontier Foundation (EFF).

1. Para começar, você precisa instalar e atualizar o daemon snap principal do seu sistema:

sudo snap install core
sudo snap refresh core

2. Instale o pacote snap do certbot:

sudo snap install --classic certbot

3. Crie um link simbólico entre o binário instantâneo do certbot e o diretório binário padrão do seu sistema:

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

4. Teste se o certbot está em execução usando-o para registrar-se no EFF:

sudo certbot register --agree-tos --email ramces@email.invalid

5. Gere um certificado SSL para o seu nome de domínio executando o seguinte comando:

sudo certbot

Escolha o domínio na entrada e ele fará o trabalho de gerar SSL para o seu domínio.

Bom saber: Saiba mais sobre criptografia na Internet criando seu próprio certificado SSL autoassinado.

Fazendo login e criando um quadro Kanban

Agora você pode usar o Kanboard para criar e gerenciar quadros Kanban. Para fazer isso, faça login na sua instância do Kanboard acessando seu nome de domínio em um navegador da web.

1. Use “admin” como nome de usuário e senha na tela de login.
2. Clique em “Novo projeto” para criar um quadro Kanban público.

3. Forneça um nome e um slug de URL para seu novo quadro.
4. Clique em “Acesso Público” na barra lateral esquerda da página.

5. Clique no botão azul “Ativar acesso público”. Isso criará um feed RSS e um link visível publicamente que você pode compartilhar com usuários que não são do Kanboard.

6. Clique no botão “Quadro” no canto superior esquerdo da página para acessar e criar novos itens em seu quadro.

Criando um usuário para quadros Kanban colaborativos

Além de compartilhar quadros “somente visualização” acessíveis ao público, você também pode usar o Kanboard para criar quadros de “tarefas” colaborativos entre vários usuários locais.

1. Clique no ícone do usuário administrador no canto superior direito da página e selecione “Gerenciamento de usuários”.

2. Clique no link “Novo usuário” na barra lateral superior esquerda da página.
3. Isso abrirá uma pequena caixa de diálogo onde o Kanboard solicitará o nome de usuário e a senha do seu novo usuário.

4. Role para baixo até a parte inferior do prompt e clique na caixa suspensa na categoria “Projetos”.

5. Selecione o quadro Kanban do qual você deseja que o usuário faça parte.

6. Clique em “Salvar” para criar sua nova conta de usuário.

Personalizando seu quadro Kanban com plug-ins

Um dos recursos brilhantes do Kanboard é que ele fornece uma estrutura para estender seu quadro além de seus recursos básicos. Isso significa que você não precisa depender dos desenvolvedores para incluir um recurso personalizado em seu servidor.

1. Para adicionar um novo plugin, clique no ícone do usuário administrador no canto superior direito da página e selecione “Plugins”.

2. Clique na categoria “Diretório de plug-ins” na barra lateral esquerda da página.

3. Encontre um plugin que você deseja instalar em seu servidor Kanboard. No meu caso, instalarei “MarkdownPlus” para estender o Markdown básico em meu servidor.

4. Clique em “Instalar” e atualize a página da web para carregar corretamente o plugin em seu servidor.

PARA SUA INFORMAÇÃO: Kanban não é a única maneira de gerenciar tarefas e dados. Aprenda como você pode otimizar suas listas de tarefas e dados usando Todoist hoje mesmo.

perguntas frequentes