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

jopen 9年前

准备 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
    1
    2
    3
    4
    5
    6
    7
    $ 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
     

安装 GitBook 环境

  • 搜索镜像

    $ sudo docker search gitbook NAME DESCRIPTION STARS OFFICIAL AUTOMATED tobegit3hub/gitbook-server 2 [OK]
    1
    2
    3
    4
    $ 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
      1
      2
      $ sudo docker pull tobegit3hub / gitbook - server
       
    </li> </ul>

    完善 GitBook 环境

    • 启动 GitBook 环境

      $ sudo docker images | grep gitbook tobegit3hub/gitbook-server latest d171079650c8 $ sudo docker run -i -t \ tobegit3hub/gitbook-server /bin/bash
      1
      2
      3
      4
      5
      $ 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
      1
      2
      3
      $ apt - get install git
      $ apt - get install fonts - arphic - gbsn00lp
       

    用 GitBook 写书

    基础准备

    • Markdown

      • 当前最流行的内容创作标记语言
      • Google自然设计：突出内容，抛弃繁杂的格式！
      • Markdown 基本语法
      • Markdown 编辑器：retext
      </li>

    • Pandoc

      • 各种格式自由转换
      • Pandoc Markdown 语法
        • </ul> </li>

      • GitBook

        • GitBook 快速上手
        • GitBook 简明教程
          • </ul> </li> </ul>

          GitBook 核心文件

          • GitBook 本身是一个 Git 仓库

            • .gitignore: 需要忽略的临时内容
            </li>

          • 重要组件

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

              GitBook 输出格式

              • 静态 HTML 页面

                • gitbook build ./ --output=./_book/
                </li>

              • PDF

                • gitbook pdf
                  • </ul> </li> </ul>

                  GitBook 在线预览

                  • 启动服务
                    • gitbook serve ./
                    </li> </ul>

                    Starting server …

                    Serving book on http://localhost:4000

                    • 在线预览
                      • 用浏览器打开:http://localhost:4000
                      </li> </ul>

                      杂项

                      • Json 语法错误 </li> </ul>

                        SyntaxError:…/book.json:Unexpected token o

                        • GitBook 调试

                          • export DEBUG=true
                          </li>

                        • GitBook 插件

                          • Google Analytics
                          • Disqus: Comments
                          • Exercises
                            • </ul> </li> </ul>

                            GitBook 图书实例

                            下载和编译图书

                            • 下载

                              $ git clone \ https://github.com/tobegit3hub/understand_linux_process.git
                              1
                              2
                              3
                              $ git clone \
                              https : //github.com/tobegit3hub/understand_linux_process.git
                               

                            • 编译

                              $ cd understand_linux_process $ gitbook build $ gitbook pdf
                              1
                              2
                              3
                              4
                              $ 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
                                1
                                2
                                3
                                4
                                5
                                6
                                $ ifconfig eth0 | grep "inet addr"
                                inet addr : 172.17.0.31 . . .
                                $ gitbook serve . /
                                Starting server . . .
                                Serving book on http : //localhost:4000
                                 
                              </li>

                            • 主机侧

                              • 在浏览器访问：http://172.17.0.31:4000
                                • </ul> </li> </ul>

                                从 Docker 拷贝出 pdf

                                • Docker 侧：确认 pdf 路径

                                  $ readlink -f book.pdf /gitbook/understand_linux_process/book.pdf
                                  1
                                  2
                                  3
                                  $ 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 .
                                  1
                                  2
                                  3
                                  4
                                  5
                                  6
                                  $ 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
                                    1
                                    2
                                    3
                                    4
                                    5
                                    6
                                    $ 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
                                     
                                  </li> </ul>

                                  直接挂载卷共享

                                  • 挂载主机 GitBook 目录到 Docker

                                    $ sudo docker run -i -t \ -v /path/to/mybook/:/gitbook/ \ tinylab/gitbook /bin/bash
                                    1
                                    2
                                    3
                                    4
                                    $ 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
                                    1
                                    2
                                    3
                                    4
                                    $ 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
                                    1
                                    2
                                    $ sudo docker save tinylab / gitbook > gitbook . tar
                                     

                                  • 导入镜像文件到其他主机上: load/import

                                    $ sudo docker load < gitbook.tar
                                    1
                                    2
                                    $ sudo docker load < gitbook . tar
                                     

                                  其他操作

                                  • 删除/杀掉容器

                                    • docker rm [-f] contaier_id
                                    • docker kill contaier_id
                                    </li>

                                  • 停止容器

                                    • docker stop container_id
                                      • </ul> </li>

                                    • 启动容器

                                      • docker start container_id
                                        • </ul> </li>

                                      • 删除镜像

                                        • docker rmi image_id
                                          • </ul> </li> </ul>

                                          新建 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 -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"]
                                          </tr> </tbody> </table> </div> </div>

                                          新建 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 -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"]
                                          1
                                          2
                                          3
                                          4
                                          5
                                          6
                                          7
                                          8
                                          9
                                          10
                                          11
                                          12
                                          13
                                          14
                                          15
                                          </div> </td>
                                          # 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 - 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" ]
                                           
                                          </tr> </tbody> </table> </div> </div>

                                          基于 Dockerfile 构建映像

                                          • 快速构建

                                            $ sudo docker build -t tinylab/gitbook ./
                                          1
                                          2
                                          3
                                          4
                                          5
                                          6
                                          7
                                          8
                                          9
                                          10
                                          11
                                          12
                                          13
                                          14
                                          15
                                          16
                                          17
                                          18
                                          </div> </td>
                                          # 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 - 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" ]
                                           
                                          1
                                          2
                                          $ 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

                                        参考资料

                                        来自：