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', '[e-mail]');
  
  // 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. 項目成員可以通過看板來進行日常的任務，超期的任務會有郵件通知項目管理者，安排討論及變更。

• 最后上一張圖片，完美
  

---

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