「Wekan」- 看板工具(kanban)

问题描述

该笔记将记录:在 Linux 中,如何安装 Wekan 看板工具,简单的使用方法,以及常见问题处理。

解决方案

部署方式的选择

参考 Platforms · wekan/wekan Wiki 文档,以了解官方支持所有部署方式。

我们尝试通过 UCS 安装:UCS 算是个 Linux 发行版,但是与其他发行版的意图不同。它集成各种基础服务(DNS, DHCP, …),我们能够通过 Web 界面直接安装应用,包括这里的 Wekan 应用。优点在于(1)简化部署、自动升级、易于维护,而缺点是(1)鉴于国内的网络环境,会出现各种失败。经过一番折腾,最终我们放弃这种方法。

我们最后通过 Docker Compose 安装(对于我们来说,这优于其他方法)。该方法的缺点是(1)需要自行维护,升级,部署;(2)数据保存在 Docker Volume 中,需要谨慎操作数据。

第一步、服务部署

git clone https://github.com/wekan/wekan.git
cd wekan

# 1)修改服务的端口映射,默认为 80:8080 与本地冲突;
# 2)修改数据存储,将其挂载到本地目录,而非 dockre volume 存储;
# 3)镜像不要使用 latest 标签,因为该 TAG 处于开发状态,未经测试;
vim docker-compose.yaml

# 启动服务
docker-compose up -d 

第二步、登录注册

当前版本:quay.io/wekan/wekan:v5.17

根据官方文档(Adding users · wekan/wekan Wiki),没有默认帐号密码,首个注册的用户将成为管理员。

数据备份与数据恢复

参考 Docker · wekan/wekan Wiki · GitHub 文档

数据备份:

# 停止应用
docker stop wekan-app # 防止数据写入

# 导出数据
docker exec -it wekan-db bash
cd /data
rm -rf dump
mongodump
exit

# 复制数据到本地
docker cp wekan-db:/data/dump .

数据恢复:

# 停止应用
docker stop wekan-app # 防止数据写入

# 复制数据到容器
docker exec -it wekan-db bash
cd /data
rm -rf dump
exit
docker cp dump wekan-db:/data/

# 导入数据
docker exec -it wekan-db bash
cd /data
mongorestore --drop
exit

# 启动应用
docker start wekan-app

应用升级

第一步、数据备份
1)参考 数据备份与数据恢复 部分;

第二步、直接修改镜像版本

第三步、数据恢复
1)参考 数据备份与数据恢复 部分;

参考文献

wekan/wekan: The Open Source kanban (built with Meteor).
Docker · wekan/wekan Wiki
Bug: Wekan – Synology · Issue #3874 · wekan/wekan · GitHub