问题描述
该笔记将记录:在 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