泰晓科技 -- 聚焦 Linux - 追本溯源,见微知著!
网站地址:https://tinylab.org

泰晓RISC-V实验箱,转战RISC-V,开箱即用
请稍侯

Docker 快速上手:用 Docker + GitBook 写书

Wu Zhangjin 创作于 2015/04/27

By Falcon of TinyLab.org泰晓沙龙第二期 @ 2015/04/26

注:由于 Docker 和 Gitbook 更新换代太快,以下方法或许已经失效,推荐直接通过 Markdown Lab 来撰写书籍,它基于 Docker 内建有 Gitbook 环境。

准备 GitBook 环境

安装 Docker

  • 以Ubuntu为例

    $ echo deb http://get.docker.io/ubuntu docker main \
        | sudo tee /etc/apt/sources.list.d/docker.list
    $ sudo apt-key adv --keyserver keyserver.ubuntu.com \
        --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9
    $ sudo apt-get update
    $ sudo apt-get install -y lxc-docker
    

:以上方法在新版 Ubuntu 上已经失效,最新版本已经转为使用 docker engine

安装 GitBook 环境

  • 搜索镜像

    $ sudo docker search gitbook
    NAME  DESCRIPTION   STARS     OFFICIAL   AUTOMATED
    tobegit3hub/gitbook-server 2             [OK]
    
  • 安装镜像

    • ubuntu
    • npm + nodejs
    • gitbook + calibre(ebook-convert)

      $ sudo docker pull tobegit3hub/gitbook-server
      

完善 GitBook 环境

  • 启动 GitBook 环境

    $ sudo docker images | grep gitbook
    tobegit3hub/gitbook-server   latest d171079650c8
    $ sudo docker run -i -t \
    tobegit3hub/gitbook-server /bin/bash
    
  • 安装 字体 和 Git

    $ apt-get install git
    $ apt-get install fonts-arphic-gbsn00lp
    

用 GitBook 写书

基础准备

GitBook 核心文件

  • GitBook 本身是一个 Git 仓库

    • .gitignore: 需要忽略的临时内容
  • 重要组件

    • README.md: 书籍简介
    • SUMMARY.md: 图书结构,文章索引
    • LANGS.md: 多国语言,每种一个目录
    • GLOSSARY.md: 词汇表
    • cover.jpg: 图书封面
    • cover_small.jpg: 小尺寸图书封面

GitBook 输出格式

  • 静态 HTML 页面

    • gitbook build ./ --output=./_book/
  • PDF

    • gitbook pdf

GitBook 在线预览

  • 启动服务
    • gitbook serve ./

Starting server …

Serving book on http://localhost:4000

  • 在线预览
    • 用浏览器打开: http://localhost:4000

杂项

SyntaxError:…/book.json:Unexpected token o

  • GitBook 调试

    • export DEBUG=true
  • GitBook 插件

    • Google Analytics
    • Disqus: Comments
    • Exercises

GitBook 图书实例

下载和编译图书

  • 下载

    $ git clone \
    
    https://github.com/tobegit3hub/understand_linux_process.git
    
  • 编译

    $ cd understand_linux_process
    $ gitbook build
    $ gitbook pdf
    

在线预览图书

  • Docker 侧

    • 启动图书服务器

      $ ifconfig eth0 | grep "inet addr"
      inet addr:172.17.0.31 ...
      $ gitbook serve ./
      Starting server ...
      Serving book on http://localhost:4000
      
  • 主机侧

    • 在浏览器访问:http://172.17.0.31:4000

从 Docker 拷贝出 pdf

  • Docker 侧:确认 pdf 路径

    $ readlink -f book.pdf
    /gitbook/understand_linux_process/book.pdf
    
  • 主机侧:docker cp CONTAINER_ID:PATH HOSTPATH

    $ sudo docker ps -a
    CONTAINER ID   IMAGE              COMMAND
    cf5925e tobegit3hub/gitbook-server "/bin/bash"
    $ sudo docker cp \
    cf5925e:/gitbook/understand_linux_process/book.pdf .
    

从 主机 拷入 Docker

  • 两个步骤

    • 获取容器挂载路径
    • 通过本地 cp 命令直接拷贝进去

      $ fullid=`sudo docker inspect -f '{{ .Id }}' cf5925e`
      $ gitbook=/var/lib/docker/aufs/mnt/$fullid/gitbook/
      $ ls $gitbook
      understand_linux_process
      $ cp book.pdf $gitbook/book-from-host.pdf
      

直接挂载卷共享

  • 挂载主机 GitBook 目录到 Docker

    $ sudo docker run -i -t \
      -v /path/to/mybook/:/gitbook/ \
      tinylab/gitbook /bin/bash
    

新建 GitBook 环境

备份/导出/导入容器

  • 保存容器为新镜像: commit

    $ sudo docker commit cf5925e tinylab/gitbook
    $ sudo docker images | grep tinylab/gitbook
    tinylab/gitbook latest 2106b9f7f675
    
  • 导出镜像文件: save/export

    $ sudo docker save tinylab/gitbook > gitbook.tar
    
  • 导入镜像文件到其他主机上: load/import

    $ sudo docker load < gitbook.tar
    

其他操作

  • 删除/杀掉容器

    • docker rm [-f] contaier_id
    • docker kill contaier_id
  • 停止容器

    • docker stop container_id
  • 启动容器

    • docker start container_id
  • 删除镜像

    • docker rmi image_id

新建 GitBook Dockerfile

# Dockerfile
FROM ubuntu:14.04
MAINTAINER Falcon wuzhangjin@gmail.com
RUN sed -i -e "s/archive.ubuntu.com/mirrors.163.com/g" \
    /etc/apt/sources.list
RUN apt-get -y update
RUN apt-get install -y nodejs npm git && \
    npm install gitbook-cli -g
RUN apt-get install -y calibre
RUN apt-get install -y fonts-arphic-gbsn00lp
RUN mkdir /gitbook
WORKDIR /gitbook
EXPOSE 4000
CMD ["gitbook", "serve", "/gitbook"]

新建 GitBook Dockerfile(续)

# Dockerfile
FROM ubuntu:14.04
MAINTAINER Falcon wuzhangjin@gmail.com
RUN sed -i -e "s/archive.ubuntu.com/mirrors.163.com/g" \
    /etc/apt/sources.list
RUN apt-get -y update
RUN apt-get install -y curl git && cd / && \
    git clone https://github.com/creationix/nvm.git nvm && \
    echo ". /nvm/nvm.sh" > ~/.bashrc && . ~/.bashrc && \
    nvm install 0.12.2 && nvm use 0.12.2 && \
    npm install gitbook-cli -g
RUN apt-get install -y calibre
RUN apt-get install -y fonts-arphic-gbsn00lp
RUN mkdir /gitbook
WORKDIR /gitbook
EXPOSE 4000
CMD ["gitbook", "serve", "/gitbook"]

基于 Dockerfile 构建映像

  • 快速构建

    $ sudo docker build -t tinylab/gitbook ./
    
  • 更多参数: Cgroup

-c, –cpu-shares=0 CPU shares (relative weight)

–cpuset-cpus= CPUs in which to allow execution (0-3, 0,1)

-m, –memory= Memory limit

免 sudo 使用 docker

把普通用户加入 docker 用户组

  • 如果还没有 docker group 就添加一个:

      $ sudo groupadd docker
    
  • 将用户加入该 group 内。然后退出并重新登录就生效啦。

      $ sudo gpasswd -a ${USER} docker
    
  • 重启 docker 服务

      $ sudo service docker restart
    

原因

  • 因为 /var/run/docker.sock 所属 docker 组具有 setuid 权限

    $ sudo ls -l /var/run/docker.sock
    srw-rw---- 1 root docker 0 May  1 21:35 /var/run/docker.sock
    

参考资料



Read Album:

Read Related:

Read Latest: