简年14:蚂蚁笔记(Leanote)快速部署指南

请看这里更新后的精简内容。


本文基于 Docker,请先安装 Docker 和 Compose。

开始之前,附上源代码,以下是你要的快速部署指南。

第一步、新建一个文件夹,在里面新建三个文件,分别是:

  • 复制粘贴这里的内容保存为 app.conf 文件。
  • 复制粘贴这里的内容保存为 docker-compose.yml 文件。
  • 复制粘贴这里的内容保存为 initdb.sh 文件。

第二步、初始化数据库,一条命令:

# 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
部署成功

推荐阅读更多精彩内容

  • 0. 前言 docker是什么?docker是用GO语言开发的应用容器引擎,基于容器化,沙箱机制的应用部署技术。可...
    sessionboy阅读 3,245评论 2 49
  • 搭建note 1 --初始环境,启动容器 在服务器家目录拉取mynote代码: git clone git@git...
    ronnyjiang阅读 377评论 0 0
  • Docker从2013年发布第一个版本以来,已经火遍全球,技术迭代也比较频繁,其周边产品和技术也越来越丰富。Doc...
    niko0598阅读 10,218评论 7 44
  • Docker基础资料 安装docker $ sudo apt-get install docker.io 查看本地...
    Sherry凤阅读 184评论 0 0
  • 【1005今日剽悍】 今天趁着开车上下班的时间,打开之前买来但被我搁置了好几个月的恶魔奶爸英语课程,结果越听越有兴...
    朱朱的餐具阅读 65评论 0 1