2018-9-25kanboard安装及使用

教程小书匠

欢迎走进zozo的学习之旅。

简介
运行官方docker容器
使用kanboard

简介

Kanboard的安装提供了两种方式一种是直接安装^[1]，一种是用官方提供的容器直接运行。

官方的文档总体上还是很全了，但发现用的人少，英文的文档相对比较简单有些坑在里面，所以还是把安装使用的过程简单介绍一下，本着要有回报得先付出的精神。

运行官方docker容器

我直接用容器，省去了部署的流程，毕竟之前评估Jitamin花了好多精神。Docker —— 从入门到实践

参考资料：Docker Container Usage

先上下我的环境

CentOS Linux release 7.4.1708 (Core)

Derived from Red Hat Enterprise Linux 7.4 (Source)

NAME="CentOS Linux"

VERSION="7 (Core)"

ID="centos"

ID_LIKE="rhel fedora"

VERSION_ID="7"

PRETTY_NAME="CentOS Linux 7 (Core)"

ANSI_COLOR="0;31"

CPE_NAME="cpe:/o:centos:centos:7"

HOME_URL="https://www.centos.org/"

BUG_REPORT_URL="https://bugs.centos.org/"

下载容器镜像

[zjh@localhost ~]$ docker pull kanboard/kanboard:latest

[zjh@localhost ~]$ docker image ls

REPOSITORY                    TAG                 IMAGE ID            CREATED             SIZE

docker.io/kanboard/kanboard   latest              3791dc637c41        4 weeks ago         52.9 MB

运行容器
```
[zjh@localhost ~]$ docker run -d --name kanboard -p 10080:80 -t kanboard/kanboard:latest
```
前面的端口是你想分配的端口，后面的端口是容器kanboard的访问端口。

运行成功，直接从你的服务器ip:10080 就可以访问了，默认账号 admin:admin

查看运行状态

[zjh@localhost www]$ docker  logs -f kanboard

其他命令

[zjh@localhost www]$ docker  stop kanboard

[zjh@localhost www]$ docker  start kanboard

使用kanboard

首先配置后台邮箱

进入容器

     [zjh@localhost www]$ docker exec -it kanboard bash

vi /var/www/app/config.php

修改内容如下，这里发送邮箱是用SMTP，无验证。

// Enable/disable email configuration from the user interface

define('MAIL_CONFIGURATION', true);

// E-mail address used for the "From" header (notifications)

define('MAIL_FROM', 'zjh@lierda.com');

// Mail transport available: "smtp", "sendmail", "mail" (PHP mail function), "postmark", "mailgun", "se

define('MAIL_TRANSPORT', 'smtp');

// SMTP configuration to use when the "smtp" transport is chosen

define('MAIL_SMTP_HOSTNAME', 'smtp.exmail.qq.com');

define('MAIL_SMTP_PORT', 25);

define('MAIL_SMTP_USERNAME', '邮箱地址');

define('MAIL_SMTP_PASSWORD', '邮箱密码');

define('MAIL_SMTP_ENCRYPTION', null); // Valid values are "null", "ssl" or "tls"

退出容器，重启容器，这样应该可以用了，不行就要看下你使用的邮箱配置是否正确。

推荐插件

这两个自不必多说马上按上，直接从插件目录里面安装即可：

接下来可以安装 Email相关的插接：

Auto Email Extended Actions 任务延期自动推送邮件给相关人员

ExtendedMail 项目邮件模板

Subtaskdate 子任务添加日期

Moon 主题，其他还有几个主题，注意同时只能安装一个主题。

其他的感觉都不是很实用，需要的同学慢慢摸索吧。

安装插件出现过一次 kanboard无法运行的情况，看了日志发现是安装了 TaskAssignCategory导致的，进到容器里面，把 /var/www/app/plugins/ 对应的插件删除即可。

错误日志

[zjh@localhost www]$ docker  logs -f kanboard

[2018/9/18 8:04:52] ignCategory' not found in /var/www/app/plugins/TaskAssignCategory/Plugin.php:9

[2018/9/18 8:04:52] Stack trace:

[2018/9/18 8:04:52] )

[2018/9/18 8:04:52] gnCateg...')

[2018/9/18 8:04:52] #2 /var/www/app/app/ServiceProvider/PluginProvider.php(27): Kanboard\Core\Plugin\Loader->scan()

[2018/9/18 8:04:52] ider->register(Object(Pimple\Container))

[2018/9/18 8:04:52] ovider))

[2018/9/18 8:04:52] #5 /var/www/app/index.php(6): require('/var/www/app/ap...')

[2018/9/18 8:04:52] #6 {main}

[2018/9/18 8:04:52] ix:/var/run/php-fpm.sock:", host: "10.16.10.166:10080"

[2018/9/18 8:04:52] or: stream_socket_client(): unable to connect to tcp://127.0.0.1:5672 (Connection refused)

修复

bash-4.4# cd /var/www/app/plugins/

bash-4.4#  mv TaskAssignCategory/  TaskAssignCategory_bk/

/9/18 8:09:50] bash-4.4# exit

[2018/9/18 8:09:50] exit

/9/18 8:10:12] [zjh@localhost ~]$ docker restart kanboard

[2018/9/18 8:10:13] kanboard

最后谈下使用思路

我也是慢慢磨合，不一定是最好，但是可以满足基本需求的流程：
1. 创建项目，对任务做基本的权限配置，邮件模块配置
2. 创建任务，可以用建好的模块导入，再调整每个任务的时间描述及子任务。
  
  kanboard_tasks_模板(utf8)
3. 项目成员可以通过看板来进行日常的任务，超期的任务会有邮件通知项目管理者，安排讨论及变更。
最后上一张图片，完美

https://docs.kanboard.org/en/latest/admin_guide/installation.html#from-the-archive-stable-version ↩︎