Как создать минималистский Канбан в Linux с помощью Kanboard

Kanboard — это легкий трекер проектов в стиле канбан, который вы можете разместить на своем собственном сервере. В отличие от других трекеров канбан, он нацелен на создание простого и интуитивно понятного интерфейса, к которому вы можете получить доступ из любой точки.

Эта статья покажет вам, как установить Kanboard в Ubuntu 22.04. Она также подчеркнет процесс расширения Kanboard с помощью плагинов сообщества.

Содержание

• Почему стоит использовать Kanboard?
• Установка Kanboard
• Настройка Kanboard для SSL
• Вход в систему и создание доски Канбан
• Настройка вашей доски Канбан с помощью плагинов
• Часто задаваемые вопросы

Почему стоит использовать Kanboard?

Одним из главных преимуществ Kanboard является то, что он может работать на почти любом сервере благодаря магии Docker. В результате размещение Kanboard является безболезненным и простым даже для не технических пользователей.

Кроме того, Kanboard также предлагает гибкую платформу для плагинов. Это включает возможность создания тегов, отслеживания времени и запуска пользовательских скриптов. Например, вы можете создать плагин, который обновляет свойства каждой карточки в зависимости от ее содержимого.

Совет: Узнайте, как быть эффективным и результативным в приоритизации задач, понимая матрицу Эйзенхауэра.

Установка Kanboard

1. Первый шаг в установке Kanboard — убедиться, что ваша система обновлена. Вы можете сделать это, выполнив следующую команду:

sudo apt update  
sudo apt upgrade

1. Установите ключ третьей стороны репозитория проекта 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. Создайте новый файл репозитория apt с помощью вашего любимого текстового редактора:

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

1. Запишите информацию о репозитории для официального репозитория Docker:

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

1. Сохраните ваш новый файл репозитория, нажав Ctrl + O, затем Ctrl + X.

2. Обновите детали репозитория вашей системы, выполнив следующую команду:

sudo apt update

1. Установите движок Docker вместе с его зависимостями с помощью apt:

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

Получение Kanboard

После того как вы правильно установили движок Docker, следующим шагом будет получение скрипта Docker Compose для Kanboard. Это небольшой текстовый файл, который содержит список опций, которые скажут Docker, как автоматически создать Kanboard.

1. Создайте отдельную папку в вашем домашнем каталоге для Kanboard:

mkdir ~/kanboard  
cd ~/kanboard

1. Создайте новый текстовый файл с именем “docker-compose.yml” через ваш любимый текстовый редактор:

nano ~/kanboard/docker-compose.yml

1. Скопируйте следующий блок кода и вставьте его в ваш файл “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. Откройте новый терминал и сгенерируйте надежный пароль, выполнив следующую команду:

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

1. Вернитесь в предыдущий терминал и вставьте ваш надежный пароль в каждое вхождение “#!REPLACE-ME” внутри файла.

1. Сохраните и выйдите из вашего файла “docker-compose.yml”, нажав Ctrl + O, затем Ctrl + X.

2. Теперь вы можете создать контейнер Kanboard, выполнив следующую команду:

docker compose up -d

Полезно знать: Узнайте, как вы можете создать оффлайн доску Канбан с помощью Obsidian.md сегодня.

Настройка Kanboard для SSL

На данный момент у вас уже есть частично работающая установка Kanboard. Однако, чтобы получить к ней безопасный доступ, вам сначала нужно создать обратный прокси-сервер Nginx. Это будет ваш веб-сервер, который обеспечивает балансировку нагрузки и SSL.

1. Установите веб-сервер Nginx:

sudo apt install nginx

1. Создайте файл конфигурации сайта для вашего обратного прокси Nginx:

sudonano/etc/nginx/sites-available/kanboard

1. Скопируйте и вставьте следующий блок кода в ваш новый файл конфигурации сайта:

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;  
}  
}

Примечание: замените “my-kanban-domain-url.com” на фактическое доменное имя.

1. Создайте символическую ссылку для вашего обратного прокси Kanboard:

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

1. Перезагрузите демон службы Nginx:

sudo systemctl reload nginx.service

Получение SSL-сертификата для Kanboard

С вашим обратным прокси теперь вы можете запросить SSL-сертификат для вашего Kanboard. Этот раздел покажет вам, как получить бесплатный сертификат через Certbot Фонда Электронных Фронтов (EFF).

1. Для начала вам нужно установить и обновить основной демон snap вашей системы:

sudo snap install core  
sudo snap refresh core

1. Установите пакет certbot snap:

sudo snap install--classic certbot

1. Создайте символическую ссылку между бинарным файлом certbot snap и каталогом бинарных файлов по умолчанию вашей системы:

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

1. Проверьте, работает ли certbot, используя его для регистрации себя в EFF:

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

1. Сгенерируйте SSL-сертификат для вашего доменного имени, выполнив следующую команду:

sudo certbot

Выберите домен из записи, и он выполнит свою работу по генерации SSL для вашего домена.

Полезно знать: Узнайте больше о шифровании в интернете, создав свой собственный самоподписанный SSL-сертификат.

Вход в систему и создание доски Канбан

Теперь вы можете использовать Kanboard для создания и управления досками Канбан. Для этого войдите в свою инстанцию Kanboard, получив доступ к ее доменному имени через веб-браузер.

1. Используйте “admin” в качестве имени пользователя и пароля на экране входа.
2. Нажмите “Новый проект”, чтобы создать публичную доску Канбан.

1. Укажите имя и URL-слуг для вашей новой доски.
2. Нажмите “Публичный доступ” на левой боковой панели страницы.

1. Нажмите синюю кнопку “Включить публичный доступ”. Это создаст RSS-ленту и публично доступную ссылку, которую вы можете поделиться с пользователями, не использующими Kanboard.

1. Нажмите кнопку “Доска” в верхнем левом углу страницы, чтобы получить доступ и создать новые элементы на вашей доске.

Создание пользователя для совместных досок Канбан

Помимо того, что вы можете делиться публично доступными “только для просмотра” досками, вы также можете использовать Kanboard для создания совместных “задачных” досок между несколькими локальными пользователями.

1. Нажмите на значок администратора в верхнем правом углу страницы, затем выберите “Управление пользователями”.

1. Нажмите ссылку “Новый пользователь” на верхней левой боковой панели страницы.
2. Это вызовет небольшое диалоговое окно, где Kanboard попросит вас ввести имя пользователя и пароль для вашего нового пользователя.

1. Прокрутите вниз до конца подсказки и нажмите выпадающий список в категории “Проекты”.

1. Выберите доску Канбан, частью которой вы хотите сделать пользователя.

1. Нажмите “Сохранить”, чтобы создать вашу новую учетную запись пользователя.

Настройка вашей доски Канбан с помощью плагинов

Одной из замечательных функций Kanboard является то, что он предоставляет основу для расширения вашей доски за пределами ее основных функций. Это означает, что вам не нужно полагаться на разработчиков, чтобы включить пользовательскую функцию для вашего сервера.

1. Чтобы добавить новый плагин, нажмите на значок администратора в верхнем правом углу страницы, затем выберите “Плагины”.

1. Нажмите категорию “Каталог плагинов” на левой боковой панели страницы.

1. Найдите плагин, который вы хотите установить на своем сервере Kanboard. В моем случае я установлю “MarkdownPlus”, чтобы расширить базовый Markdown на моем сервере.

1. Нажмите “Установить”, затем обновите веб-страницу, чтобы правильно загрузить плагин на вашем сервере.

Для вашего сведения: Канбан — это не единственный способ управления задачами и данными. Узнайте, как вы можете оптимизировать свои списки дел и данные с помощью Todoist сегодня.

Часто задаваемые вопросы

Возможно ли создать резервную копию содержимого моей доски Канбан?

Да. Чтобы создать резервную копию конкретной доски Канбан, нажмите на значок шестеренки на доске, которую вы хотите экспортировать, затем нажмите “Экспорт”.

Это вызовет небольшую подсказку, где Kanboard попросит вас указать диапазон дат, который вы хотите экспортировать. Укажите дату начала и окончания, затем нажмите “Экспорт”.

Возможно ли сбросить период “блокировки” моей доски Канбан?

Да. Возможно сбросить таймер блокировки конкретного пользователя в Kanboard. Для этого нажмите на значок администратора в верхнем правом углу страницы. Затем выберите пункт “Управление пользователями”, затем нажмите на имя заблокированного пользователя. Наконец, перейдите в категорию “Безопасность” и нажмите “Разблокировать этого пользователя”.

Возможно ли изменить файл config.php внутри моего контейнера Kanboard?

Да. Однако, сделав это, вы можете потенциально разрушить согласованность вашего образа Docker. Вместо этого разработчики программы предлагают использовать переменные окружения внутри вашего файла docker-compose.yml при настройке значений вашей инстанции Kanboard.

Кредит изображения: Eden Constantino через Unsplash. Все изменения и скриншоты сделаны Рамсесом Редом.