Como Criar um Kanban Minimalista no Linux com Kanboard

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

Este artigo mostrará como você pode instalar o Kanboard no Ubuntu 22.04. Ele também destacará o processo de extensão do Kanboard usando plugins da comunidade.

Índice

• Por que usar o Kanboard?
• Instalando o Kanboard
• Configurando o Kanboard para SSL
• Fazendo login e criando um quadro Kanban
• Personalizando seu quadro Kanban com plugins
• Perguntas frequentes

Por que usar o Kanboard?

Uma das maiores vantagens do Kanboard é que ele pode funcionar em quase qualquer servidor através da mágica do Docker. Como resultado, hospedar o Kanboard é tanto indolor quanto 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, rastrear tempo e executar scripts personalizados. Por exemplo, você pode criar um plugin que atualiza as propriedades de cada cartão dependendo de seu conteúdo.

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

Instalando o Kanboard

1. O primeiro passo para instalar o Kanboard é garantir que seu sistema esteja atualizado. Você pode fazer isso executando o seguinte comando:

sudo apt update  
sudo apt upgrade

1. Instale a chave do repositório de terceiros do projeto 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. Crie um novo arquivo de repositório apt usando seu editor de texto favorito:

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

1. Escreva as informações do repositório para o 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

1. Salve seu novo arquivo de repositório pressionando Ctrl + O, depois Ctrl + X.

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

sudo apt update

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

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

Obtendo o Kanboard

Uma vez que você tenha o mecanismo Docker instalado corretamente, a próxima coisa a fazer é buscar o script Docker Compose para o Kanboard. Este é um pequeno arquivo de texto que contém uma lista de opções que dirão ao Docker como criar automaticamente o Kanboard.

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

mkdir ~/kanboard  
cd ~/kanboard

1. 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

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

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

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

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

1. Salve e saia do seu arquivo “docker-compose.yml” pressionando Ctrl + O, depois Ctrl + X.

2. Agora você pode construir seu contêiner Docker do Kanboard executando o seguinte comando:

docker compose up -d

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

Configurando o Kanboard para SSL

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

1. Instale o servidor web Nginx:

sudo apt install nginx

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

sudonano/etc/nginx/sites-available/kanboard

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

Nota: substitua “my-kanban-domain-url.com” pelo nome de domínio real.

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

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

1. Recarregue o daemon de serviço Nginx:

sudo systemctl reload nginx.service

Obtendo um Certificado SSL para o Kanboard

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

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

sudo snap install core  
sudo snap refresh core

1. Instale o pacote snap certbot:

sudo snap install--classic certbot

1. Crie um link simbólico entre o binário snap certbot e o diretório binário padrão do seu sistema:

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

1. Teste se o certbot está funcionando usando-o para se registrar na EFF:

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

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

sudo certbot

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

Bom saber: Aprenda 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 a partir de um navegador 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.

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

1. Clique no botão azul “Habilitar Acesso Público”. Isso criará um feed RSS e um link visível publicamente que você pode compartilhar com usuários não-Kanboard.

1. 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 leitura” acessíveis publicamente, 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 Admin no canto superior direito da página, depois selecione “Gerenciamento de Usuários”.

1. Clique no link “Novo Usuário” na barra lateral esquerda superior da página.
2. Isso abrirá um pequeno prompt de diálogo onde o Kanboard pedirá o nome de usuário e a senha do seu novo usuário.

1. Role até o final do prompt e clique na caixa suspensa sob a categoria “Projetos”.

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

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

Personalizando Seu Quadro Kanban com Plugins

Uma das características brilhantes do Kanboard é que ele fornece uma estrutura para estender seu quadro além de suas funcionalidades básicas. Isso significa que você não precisa depender dos desenvolvedores para incluir um recurso personalizado para seu servidor.

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

1. Clique na categoria “Diretório de Plugins” na barra lateral esquerda da página.

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

1. Clique em “Instalar”, depois atualize a página para carregar corretamente o plugin em seu servidor.

FYI: Kanban não é a única maneira de gerenciar tarefas e dados. Aprenda como você pode otimizar suas listas de tarefas e dados usando o Todoist hoje.

Perguntas Frequentes

É possível fazer backup do conteúdo do meu quadro Kanban?

Sim. Para fazer backup de um quadro Kanban específico, clique no ícone de engrenagem no quadro que você deseja exportar e depois clique em “Exportações.”

Isso abrirá um pequeno prompt onde o Kanboard pedirá um intervalo de datas que você deseja exportar. Forneça uma data de início e uma data de término, depois clique em “Exportar.”

É possível redefinir o período “bloqueado” do meu quadro Kanban?

Sim. É possível redefinir o temporizador bloqueado de um usuário específico no Kanboard. Para fazer isso, clique no ícone do usuário Admin no canto superior direito da página. Em seguida, selecione o item “Gerenciamento de Usuários” e clique no nome do usuário bloqueado. Por fim, vá para a categoria “Segurança” e clique em “Desbloquear este usuário.”

É possível modificar o arquivo config.php dentro do meu contêiner Kanboard?

Sim. No entanto, fazer isso pode potencialmente arruinar a consistência da sua imagem Docker. Em vez disso, os desenvolvedores do programa sugerem que você use as variáveis de ambiente dentro do seu arquivo docker-compose.yml ao configurar os valores da sua instância do Kanboard.

Crédito da imagem: Eden Constantino via Unsplash. Todas as alterações e capturas de tela por Ramces Red.