[Node + Docker] 聊聊怎么把 nodeclub 构建成 Docker 镜像

14年毕业后开始接触node，15年来帝都找了份工做，一直默默的在cnode社区晃悠，灌过几回水，今天就想发个处女贴，跟你们聊聊怎么把nodeclub项目源码构建成一个镜像。话说Docker是今年刚接触的，还在入门中/(ㄒoㄒ)/~~，下面我简单介绍下Docker、Dockerfile的语法以及如何把nodeclub源码构建成镜像。（已经对Docker比较熟悉的小伙伴能够直接跳到第三个）

1.什么是docker？

Docker allows you to package an application with all of its dependencies into a standardized unit for software development.
Docker是一个开源的应用容器引擎，让开发者能够打包他们的应用以及依赖包到一个可移植的容器中，而后发布到任何流行的 Linux 机器上，也能够实现虚拟化。容器是彻底使用沙箱机制，相互之间不会有任何接口（相似 iPhone 的 app）。几乎没有性能开销，能够很容易地在机器和数据中心中运行。最重要的是，他们不依赖于任何语言、框架包括系统。

Docker 的目标是实现轻量级的操做系统虚拟化解决方案。Docker 的基础是 Linux 容器（LXC）等技术。在 LXC 的基础上 Docker 进行了进一步的封装，让用户不须要去关心容器的管理，使得操做更为简便。用户操做 Docker 的容器就像操做一个快速轻量级的虚拟机同样简单。

下面的图片比较了 Docker 和传统虚拟化方式的不一样之处，可见容器是在操做系统层面上实现虚拟化，直接复用本地主机的操做系统，而传统方式则是在硬件层面实现。

(图片来自Docker官方网站)

2.Dockerfile简单入门

Docker can build images automatically by reading the instructions from a Dockerfile. A Dockerfile is a text document that contains all the commands you would normally execute manually in order to build a Docker image. By calling docker build from your terminal, you can have Docker build your image step by step, executing the instructions successively.
Docker经过读取Dockerfile文件中的指令自动构建镜像。Dcokerfile是一个文本文件，它包含了构建镜像所须要执行的所有命令。执行docker build命令，Docker就会按照文档执行并最终建立一个镜像。（这段话是翻译上面那段话的%>_<%）。 Dockerfile支持支持的语法命令以下：

INSTRUCTION argument

指令不区分大小写。可是，命名约定为所有大写。
Dockerfile都必须以FROM命令开始。 FROM命令会指定镜像基于哪一个基础镜像建立，接下来的命令也会基于这个基础镜像（译者注：CentOS和Ubuntu有些命令但是不同的）。FROM命令能够屡次使用，表示会建立多个镜像。具体语法以下：

FROM <image name>

例如：

FROM google/nodejs

上面的指令告诉咱们，新的镜像将基于google的Node.js的镜像来构建。

继FROM命令，DockefFile还提供了一些其它的命令以实现自动化。在Dockerfile文件中这些命令的顺序就是它们被执行的顺序。 下面咱们就了解下这些有趣的Dockerfile命令吧。 1.MAINTAINER：设置该镜像的做者。语法以下：

MAINTAINER <author name>

2.RUN：在shell或者exec的环境下执行的命令。RUN指令会在新建立的镜像上添加新的层面，接下来提交的结果用在Dockerfile的下一条指令中。语法以下：

RUN <command>

3.ADD：复制文件指令。它有两个参数和。destination是容器内的路径。source能够是URL或者是启动配置上下文中的一个文件。语法以下：

ADD <src> <destination>

4.CMD：提供了容器默认的执行命令。 Dockerfile只容许使用一次CMD指令。 使用多个CMD会抵消以前全部的指令，只有最后一个指令生效。 CMD有三种形式：

CMD ["executable","param1","param2"]
CMD ["param1","param2"]
CMD command param1

5.EXPOSE：指定容器在运行时监听的端口。语法以下：

EXPOSE <port>;

6.ENTRYPOINT：配置给容器一个可执行的命令，这意味着在每次使用镜像建立容器时一个特定的应用程序能够被设置为默认程序。同时也意味着该镜像每次被调用时仅能运行指定的应用。相似于CMD，Docker只容许一个ENTRYPOINT，多个ENTRYPOINT会抵消以前全部的指令，只执行最后的ENTRYPOINT指令。语法以下：

ENTRYPOINT ["executable", "param1","param2"]
ENTRYPOINT command param1 param2

7.WORKDIR：指定RUN、CMD与ENTRYPOINT命令的工做目录。语法以下：

WORKDIR /path/to/workdir

8.ENV：设置环境变量。它们使用键值对，增长运行程序的灵活性。语法以下：

ENV <key> <value>

9.USER：镜像运行时，设置一个UID。语法以下：

USER <uid>

10.VOLUME：受权访问从容器内到主机上的目录。语法以下：

VOLUME ["/data"]

3. 把nodeclub构建成一个镜像

先把我写的Dockerfile贴出来：

# Dockerfile to create a nodeclub image
FROM google/nodejs
MAINTAINER Carrotzpc

# Add files to the image
RUN mkdir -p /opt/nodejs
ADD . /opt/nodejs
WORKDIR /opt/nodejs

# Install the dependencies modules
RUN npm install

# Run make build
RUN make build

# Expose environment variables
ENV MONGO_CARROT_ADDR **LinkMe**
ENV MONGO_CARROT_PORT **LinkMe**
ENV MONGO_CARROT_DATABASE admin
ENV MONGO_CARROT_USER **ChangeMe**
ENV MONGO_CARROT_PASS **ChangeMe**

# Expose the container port
EXPOSE 5000

ENTRYPOINT ["node", "app.js"]

这么简单的几行命令，就能够构建出一个nodeclub镜像。下面我重点聊一下环境变量ENV，nodeclub的源码我用的是node + mongo(无redis)的版本，mongo配置信息经过环境变量传递，这就须要咱们简单修改一下nodeclub的配置文件，我在配置文件中增长了如下代码（不过直接在配置文件里边这样写不太好），用来获取mongo数据库链接字符串：

// Get mongodb connec string from env
function _getMongoUrl(){
  var db_addr = process.env.MONGO_CARROT_ADDR;
  var db_port = process.env.MONGO_CARROT_PORT;
  var db_user = process.env.MONGO_CARROT_USER;
  var db_pass = process.env.MONGO_CARROT_PASS;
  var db_database =  process.env.MONGO_CARROT_DATABASE;
  var db_url  = 'mongodb://';
  if (db_user && db_pass) {
    db_url += (db_user + ':' + db_pass + '@');
  }
  db_url += (db_addr? db_addr: 'localhost');
  db_url += ':' + (db_port? db_port: 27017);
  db_url += '/' + (db_database? db_database: 'admin');
  console.log('Connect to MongoStore Use this url:' + db_url);
  return db_url;
}

（不知道还有木有童鞋有耐心看到这里）到这里咱们完成了源码的修改，其中Dockerfile是放在源代码根目录的。如今能够开始构建nodeclub镜像了，Windows安装Docker比较蛋疼，我本地没有安装Docker环境，我用的是TenxCloud时速云的本地客户端tce，安装配置都比较简单，这里就不说了，你们能够参考官方文档。 在命令行中输入tce login填写用户名、密码后完成登陆，而后进入到源代码根目录，执行tce push nodeclub命令，tce会自动将Dockerfile及引用的本地文件打包成zip，并上传到TenxCloud，由TenxCloud的容器引擎构建Docker 镜像，咱们能够看到Docker构建镜像的相关日志：

完成构建后打开时速云网站，进入镜像市场>个人镜像就能够看到咱们刚刚构建的镜像nodeclub：

在镜像详情页能够上传镜像图标、修改镜像信息、服务接口等，咱们把Dockerfile中的ENV增长到服务接口中，用于在部署镜像时填写mongo的相关配置信息：

万事具有，只欠一个mongo了，正好时速云有提供mongo的镜像，因而我部署了一个mongo，而后在部署nodeclub时填写这个mongo的地址、端口等信息，这样就完成了nodeclub的部署：

还有一种方式就是把mongo也集成到咱们的镜像中，这就涉及到了mongo的安装以及启动，咱们留在下一次讨论。我把源代码上传到了github，你们有兴趣的话能够本身构建试试：

还有一种方式就是把mongo也集成到咱们的镜像中，这就涉及到了mongo的安装以及启动，咱们留在下一次讨论。我把源代码上传到了github，你们有兴趣的话能够本身构建试试：https://github.com/Carrotzpc/docker-nodeclub。

示例网站：http://nodeclub-k9nmf.q1.tenxcloud.net:46141/。

PS：因为部署镜像前host并不可知，因此我把源码改为了经过req.headers.host来获取host，这样激活邮件中的连接就可用了。

参考资料

• what is docker ?
• 什么是容器服务（Container as a Service）
• Dockerfile reference
• Docker入门教程（三）Dockerfile
• google / nodejs
• How to use MongoDB & NodeJS with Docker (video included)
• 使用 tce 客户端