| 本文主要讲述如何为Node.js应用搭建持续集成环境。包括如何在开发机器上Docker化一个Node.js应用，如何部署Jenkins和
Docker registry以实现持续集成。推荐对使用Docker做CI方面的工作感兴趣的同学阅读，CI也是Docker的应用场景之一，本文是很好的教程。
你首先需要在你的Linux机器上安装Docker和Fig。本文主要会介绍如何使用Docker和Mesos实现持续集成。
测试、搭建生产环境可用的Mesos集群以及其它的复杂工作不在本文讨论范围之内，我会在后续文章中详细介绍。接下来，我们将在更多的云平台上支持该解决方案，比如GCE、AWS，并逐渐集成更多的第三方组件，比如
Flocker、 Weave和 Consul。
本文所有的代码都可以在 GitHub上找到。
整个解决方案中，我们使用到如下工具：
Node.js里的HelloWorld项目
Git
Jenkins
Docker
Docker Registry
Fig
Mesos
Mesosphere Marathon
Zookeeper
开发环境
让我们先从一个简单的HelloWorld先用开始吧，它使用Node.js编写，并且运行在Docker容器中。
从下图中，你可以看到开发人员在本地环境中使用容器运行构建、测试以及其它流程，如下图淡蓝色方块所示。一旦测试通过，他们将会把代码提交到中央Git仓库，接下来会发布到生产环境。
我假定阅读这篇文章的读者都能理解并且自己实现这一步。
首先是Node.js应用app.js:
// Load the http module to create an http server.
var http = require('http');
// Configure our HTTP server to respond with Hello World to all requests.
var server = http.createServer(function (request, response) {
response.writeHead(200, {"Content-Type": "text/plain"});
response.end("Hello World\n");
});
// Listen on port 8000, IP defaults to "0.0.0.0"
server.listen(8000);
// Put a friendly message on the terminal
console.log("Server running at http://127.0.0.1:8000/"); |
对应的配置文件package.json:
{
"name": "hello-world",
"description": "hello world",
"version": "0.0.1",
"private": true,
"dependencies": {
"express": "3.x"
},
"scripts": {"start": "node app.js"}
} |
上面两步完成之后，可以使用 Google的Node.js镜像来Docker化该应用，并且添加如下Dockerfile：
FROM google/nodejs
WORKDIR /app
ADD package.json /app/
RUN npm install
ADD . /app
EXPOSE 8000
CMD []
ENTRYPOINT ["/nodejs/bin/npm", "start"] |
开发环境准备好了。现在我们可以构建容器，并确认镜像是否可以正常运行。
$ docker build -t my_nodejs_image .
$ docker run -p 8000:8000 my_nodejs_image |
现在可以访问http://127.0.0.1:8000/，看看是否可以看到“Hello World”!
你可以修改app.js以让它显示其它的字符串。只需要重新构建镜像，然后启动一个新的容器，刷新浏览器，就能够看到这个新的字符串。
这里的配置没有任何测试。并不是因为觉得不需要，而是为了简化配置，将注意力放在Docker和Mesos/Marathon上。优秀的程序员都应该知道没有测试的话，开发项目就不能直接上生产环境。
现在进入下一步。
持续集成/交付
我们需要有一个版本控制系统和构建服务器，以在代码提交后运行构建和测试。为此，我们使用了Jenkins，并将构建结果（artefact）发布到仓
库。因为我们使用Docker部署，所最终的artefact就是一个Docker镜像，push也是push到本地Docker
Registry上。
为了简化复杂度，我并没有使用Git仓库管理工具，比如GitLab或者GitHub。将Jenkins连接到Git服务器很简单，这里不再赘述。如果想要在Docker上部署Git服务器，可以使用这个
镜像。
现在，让我们开始编写fig.yml吧。Fig是一个编排工具，我们使用一个命令就可以将所有中心化的服务部署好。
Fig只是个开发工具，如果想要在生产环境使用，需要用更复杂的自动化工具替代它。
几天之前，Docker发布了Docker Compose的第一个版本，它可以代替Fig。我还没有测试它，不过应该不需要什么改变，Docker
Compose就可以代替Fig了。
如下是搭建本地Docker Registry的fig.yml：
registry:
image: registry
environment:
- STORAGE_PATH=/registry
volumes:
- registry-stuff:/registry
ports:
- "5000:5000" |
这里使用的是标准的Docker Registry镜像，并且将容器外的一个持久存储的卷挂载到上面，因为我们需要重启容器后还能保留构建出的镜像。
接下来运行：
Docker Registry运行在http://localhost:5000。
下一步是构建镜像并将其push到Registry上。
# Build an image
$ docker build -t localhost:5000/containersol/nodejs_app
# Push it to the registry
$ docker push localhost:5000/containersol/nodejs_app |
这时Docker Daemon会报如下错误：
Forbidden. If this private registry supports only HTTP or HTTPS with an unknown CA certificate,
please add –insecure-registry 10.0.0.26:5000 to the daemon’s arguments. |
解决这个问题的方法见 StackOverflow
最快最简单的方法是将如下行添加到/etc/default/docker，然后重启Docker
Daemon：
DOCKER_OPTS="--insecure-registry localhost:5000" |
解决问题之后，将镜像push到repo上，并访问该 URL，检查镜像是否已经被成功push。
接下来添加Jenkins的配置到fig.yml文件里，重启系统：
jenkins:
image: containersol/jenkins_with_docker
volumes:
- jenkins-stuff:/var/jenkins_home
- .:/var/jenkins_data
- /var/run/docker.sock:/var/run/docker.sock
- /usr/bin/docker:/usr/bin/docker
ports:
- "8081:8080"
registry:
image: registry
environment:
- STORAGE_PATH=/registry
volumes:
- registry-stuff:/registry
ports:
- "5000:5000" |
这里详细解释下Jenkins配置。首先，我们在Jenkins容器里挂载了Docker二进制文件（译者注：如上的/usr/bin/docker）和
docker daemon使用的socket。这是因为需要从容器里允许Jenkins在主机上运行Docker命令。问题是，只有Docker组里的用户才有权这么
做，而Jenkins容器是Jenkins用户，而不是root用户。因此，我们使用如下Dockerfile构建我们自己的Jenkins镜像：
FROM jenkins
MAINTAINER ContainerSolutions
USER root
#TODO the group ID for docker group on my Ubuntu is 125,
therefore I can only run docker commands if I have same group id inside.
# Otherwise the socket file is not accessible.
RUN groupadd -g 125 docker && usermod -a -G docker jenkins
USER jenkins |
在Dockerfile的文件夹里运行如下命令构建镜像：
$ docker build -t containersol/jenkins_with_docker . |
这并不是很巧妙的解决方案，如果你有更好的方法，一定在本文后留言告诉我。
Fig会为Jenkins容器创建持久化的存储，并将当前目录挂载到容器里。这在之后运行build，push并且deploy脚本时就有用了。
要想完成文本介绍的持续集成，还需要添加一些脚本来构建和push Docker镜像，配置Jenkins来运行它们。
build.sh包含额外的镜像版本信息。每个Jenkins build会为Docker镜像创建新的标签。需要注意，我并不是说这是版本化的正确方式。这个领域很复杂，可能会在以后专门写文章讨论，但是现在就跳过吧。
#!/bin/bash
if [ -z "${1}" ]; then
version="latest"
else
version="${1}"
fi
cd nodejs_app
docker build -t localhost:5000/containersol/nodejs_app:${version} .
cd .. |
注意构建出的镜像的名字。它首先包含Registry的URL，然后是镜像全名，然后是标签。
还需要注意的是Jenkins在容器里运行，会使用脚本构建镜像，但是在Jenkins容器里执行的docker命令实际上会运行在主机上，因为之前我们挂载了Docker所使用的socket。
push.sh会push之前步骤构建出的镜像。使用和之前脚本一样的版本。
#!/bin/bash
if [ -z "${1}" ]; then
version="latest"
else
version="${1}"
fi
docker push localhost:5000/containersol/nodejs_app:"${version}" |
最后一步是用Fig重启整个系统，并且配置Jenkins job运行build.sh和push.sh。Jenkins在URLhttp://localhost:8081上运行。
这是一个标准的构建job，执行两个shell命令，build的版本是其输入参数：
./build.sh ${BUILD_ID}
./push.sh ${BUILD_ID} |
现在我们可以执行构建，可以看到新的镜像部署到了Registry里。注意URL包含新的标签。
本文作为该系列的第一篇，讲述了如何在开发机器上Docker化一个Node.js应用，并且如何为了Node.js应用部署Jenkins和Docker
Registry。
第二部分会接着介绍Mesos和Marathon的搭建，以及如何完成持续集成工作流。
|
