简年14:蚂蚁笔记(Leanote)快速部署指南
请看这里更新后的精简内容。
本文基于 Docker,请先安装 Docker 和 Compose。
开始之前,附上源代码,以下是你要的快速部署指南。
第一步、新建一个文件夹,在里面新建三个文件,分别是:
第二步、初始化数据库,一条命令:
# docker network create leanote
docker-compose run --rm initdb
第三步、启动,一条命令:
docker-compose up -d leanote mongo
部署完成。现在你可以使用这个私人的云笔记工具,既能当笔记工具又能当博客用,还有全平台客户端同步。
所以全文总结起来就两句话?!
下面是一边写一边记录的内容,不看也罢。
今天打开蚂蚁笔记发现蚂蚁笔记也开始收费了(这年头笔记工具都不好活啊),嗯,不过蚂蚁笔记是开源的,我们可以自己部署到自己的服务器。
这一次边操作边写吧,废话较多,快速部署的方法在最上面,就两条命令。
一、整理信息
0. 官方文档
在 Docker Hub 上看到官方的镜像已经不再维护,所以从官方文档入手,看看怎么安装吧。
1. 下载蚂蚁笔记二进制版
wget https://jaist.dl.sourceforge.net/project/leanote-bin/2.3/leanote-linux-amd64-v2.3.bin.tar.gz
2. 安装 mongodb
我们有现成的官方镜像。
3. 导入初始数据
因为前面使用了 Docker 镜像,这里数据库地址是 mongo,数据库名称为 leanote。
mongorestore -h mongo -d leanote --dir /leanote/mongodb_backup/leanote_install_data/
4. 配置蚂蚁笔记
蚂蚁笔记的配置存储在文件 conf/app.conf 中。
修改app.secret一项, 在若干个随机位置处,将字符修改成一个其他的值, 否则会有安全隐患!
这里我们可以在 Dockerfile 中定义一个变量。
ENV APP_SECRET=V85ZzBeTnzpsHyjQX4zuKbQ8qqtJu9y2aDM55VWxAH1Q0p19poekx3xkcDVvrD0y
然后在 RUN 指令中添加 sed 命令修改。
sed -i '/app.secret/s/V85ZzBeTnzpsHyjQX4zukbQ8qqtju9y2aDM55VWxAH9Qop19poekx3xkcDVvrD0y/$APP_SECRET/g'
当然使用 volume 直接挂载配置文件也许更好。
5. 运行蚂蚁笔记
运行之前确保 mongodb 已在运行。
/leanote/bin/run.sh
以上就是全部了。出现下面这行表示运行成功。
Listening on :9000...
OK,官方文档看完之后就这些信息,整合一下。
二、初步的 Dockerfile
根据上面的信息,我们可以初步写一份 Dockerfile 了。
- Dockerfile
FROM alpine:3.5
ARG LEANOTE_VERSION=2.3
ENV APP_SECRET=V85ZzBeTnzpsHyjQX4zuKbQ8qqtJu9y2aDM55VWxAH1Q0p19poekx3xkcDVvrD0y
RUN apk add --no-cache --update wget ca-certificates \
&& wget https://jaist.dl.sourceforge.net/project/leanote-bin/${LEANOTE_VERSION}/leanote-linux-amd64-v${LEANOTE_VERSION}.bin.tar.gz \
&& tar -zxvf leanote-linux-amd64-v${LEANOTE_VERSION}.bin.tar.gz -C / \
&& rm leanote-linux-amd64-v${LEANOTE_VERSION}.bin.tar.gz \
&& sed -i '/app.secret/s/V85ZzBeTnzpsHyjQX4zukbQ8qqtju9y2aDM55VWxAH9Qop19poekx3xkcDVvrD0y/$APP_SECRET/g'
&& apk del --purge wget
VOLUME /leanote/data/
EXPOSE 9000
CMD ["sh", "/leanote/bin/run.sh"]
这里构建运行会遇到一个问题,数据库没初始化。
MongoDB 运行很简单。
docker run --name mongo -v /my/own/datadir:/data/db -d mongo
但是初始化就有点麻烦了,因为初始化数据库文件在另一个容器里面。因此修改上面的 Dockerfile 中的 CMD,把 run.sh 放到数据库初始化之后执行。
也就是先写个脚本把数据库初始化的工作干了。
- initdb.sh
#! /bin/sh
mongorestore -h mongo -d leanote --dir /leanote/mongodb_backup/leanote_install_data/
啊,等会,好像不行,算了,先从安装包里面抠出来用,看看后面我有没办法自动化实现。
继续,现在有了初始化文件夹,所以直接靠 MongoDB 的镜像就可以初始化了,到时候写入 docker-compose.yml 就可以自动初始化了。
三、数据卷
现在的话基本运行没问题了,但是数据持久化就麻烦了,容器一删数据全没那就没意思了。
先来看看蚂蚁笔记的目录结构:
app bin conf messages mongodb_backup public
除了 conf/app.conf 这个文件比较容易看出来是需要挂载之外,其他的还真没看出来啊。
不过因为我们打算把数据库初始化交给数据库镜像干,所以这里我们可以删掉这个 mongodb_backup
文件夹,减少体积。
在 public 文件夹中我们看到一些 README 文件,原来用户资源统一在 public/upload
这个目录,所以这里也是一个数据卷。
应用镜像一共两个数据卷,分别是配置文件和 upload 目录。
数据库镜像一共一个数据卷,用来备份。
四、Compose 文件
上面都没有问题了,那么接下来是 docker-compose.yml 文件的编写。
为了初始化数据库,我们需要单独建立一个“一次性”的容器服务来初始化数据库,这样可以避免干扰主数据库的运行。
- docker-compose.yml
version: '2'
services:
leanote:
image: zuolan/leanote
ports:
- "9000:9000"
volumes:
- ./app.conf:/leanote/conf/app.conf
- ./upload:/leanote/public/upload
- /etc/localtime:/etc/localtime:ro
links:
- mongo
mongo:
image: mvertes/alpine-mongo
volumes:
- ./data:/data/db
initdb:
image: mvertes/alpine-mongo
links:
- mongo
volumes:
- ./initdb.sh:/initdb.sh
- ./data:/data/db
command: sh /initdb.sh
- initdb.sh
#! bin/sh
apk add --no-cache wget
wget https://jaist.dl.sourceforge.net/project/leanote-bin/2.3/leanote-linux-amd64-v2.3.bin.tar.gz
tar zxf leanote-linux-amd64-v2.3.bin.tar.gz
mv leanote/mongodb_backup /
mongorestore -h mongo -d leanote --dir /mongodb_backup/leanote_install_data/
好了,好像搞定了,接下来补充刚才的 Dockerfile 内容。
- Dockerfile
FROM alpine:edge
ARG LEANOTE_VERSION=2.3
RUN apk add --no-cache --update wget ca-certificates \
&& wget https://jaist.dl.sourceforge.net/project/leanote-bin/${LEANOTE_VERSION}/leanote-linux-amd64-v${LEANOTE_VERSION}.bin.tar.gz \
&& tar -zxf leanote-linux-amd64-v${LEANOTE_VERSION}.bin.tar.gz -C / \
&& rm -rf /leanote/mongodb_backup \
&& rm leanote-linux-amd64-v${LEANOTE_VERSION}.bin.tar.gz \
&& apk del --purge wget
VOLUME /leanote/public/upload
EXPOSE 9000
CMD ["/leanote/bin/run.sh"]
我去试下,看看有没问题。
先构建镜像:
docker build -t zuolan/leanote .
没有问题,那我们继续,初始化数据库:
docker-compose run initdb
初始化数据库完成,接下来启动即可。
docker-compose up leanote mongo
部署成功