项目地址： https://github.com/xiongwilee/docker-compose-boilerplate

基本特性：

快捷部署多人nginx+php的开发测试环境，也可以扩展构建其他语言；

基于Docker和docker-compose，不依赖K8S等高级编排工具，成本低廉、部署简单；

Docker内置集成jenkins，一键添加开发测试角色，无需额外配置；

支持微服务架构，适用于小公司or敏捷项目团队，也可以作为Docker学习入门的case；

一、背景

在角色分工明确的团队里，什么样的条件才算是最优雅的联调和测试环境？在大厂里肯定都有很多高级的解决方案，比如这些：

大型团队的合作框架下，必须依赖更复杂的DevOps架构（参考：DevOps详解）。但对于成员不多、负责的Web项目工程量也不大的团队，面临的问题肯定也更单纯：

前后端角色工程解耦，开发环境分离；
工程师只关注业务逻辑本身，持续集成；
环境和角色一键创建、一键更新、一键销毁，环境之间不受影响；

即便是只有这些需求，在以往的“开发机”的联调环境里，一旦需要添加开发或者测试人员，或者需要更新nginx的配置，再或者需要更新PHP、Nodejs的版本……对于测试环境的维护来说都是很痛苦的。

二、快速开始

注意： 当前部署方案仅依赖：Docker,Docker-compose,git

1、下载代码

$ git clone https://github.com/xiongwilee/docker-compose-boilerplate.git

2、添加测试角色`demo`

$ cd docker-compose
$ sh build.sh -u demo -m admin:master

此时，在app/会创建demo目录，在nginx/conf.d会创建demo.conf文件。

3、启动服务

$ docker-compose up -d

此时，再执行docker-compose ps会发现创建了三个镜像。然后，配置hosts使sample.demo.testdomain.com指向当前机器，然后访问http://sample.demo.testdomain.com 返回phpinfo()信息，说明创建成功。

三、部署架构说明

TIPS: 这个方案仅适用于小公司or敏捷项目团队联调测试环境的部署，同时也可以作为Docker学习入门的case，并不适用于有一定规模的生产环境。

在“开发机”上仅仅安装docker、docker-compose、git之后就能跑起来Nginx、PHP的应用，当然得益于docker容器化的思想。其实这个的实现也仅仅利用了容器化的这个特性，最终docker-compose打包的整个服务会长驻内存，无需太多的管理成本。

最终的实现还具备两个特点：

基于这个实现的boilerplate你可以轻易的迁移到其他项目，以及其他语言；
每个sample管理每个应用的仓储地址、环境变量配置、更新代码后的钩子等操作；

其实现原理为：通过脚本文件，管理docker-compose隐射到宿主机的配置、源码，同时将docker-compose暴露出来以实现服务的管理。架构图如下：

1、docker-compose配置文件：`docker-compose.yml`

先看docker-compose的配置文件docker-compose.yml（篇幅原因，删掉了一部分配置）：

version: '3'
services:
    # 所有的PHP环境构建在app容器里
    php:
        build: ./php
        expose:
            - "9000"
    # nginx容器
    nginx:
        build: ./nginx
        # 端口映射
        ports:
            - "80:80"
        # 依赖关系声明，先跑php所有服务
        depends_on:
            - "php"
    # jenkins容器
    jenkins:
        image: jenkins:latest
        ports:
            - "8080:8080"
            - "50000:50000"

这其实就是一个普通的PHP开发环境示例：可以看到就php、nginx、jenkins三个基本容器，除了jenkins，其他的容器均使用Dockerfile（build配置）来构建。

2、构建脚本：`build.sh`

由于在docker中实现了nginx配置文件及php源码文件的映射到宿主机，需要通过管理宿主机上文件就可以管理代码的发布和部署了，build.sh就是用来做这件事情的。

当然了，如果需要在部署代码完成之后，做重启、编译等操作，通过sample目录下的钩子就可以实现了。

具体实现可以参考build.sh源码。

四、详细配置

1、开发测试环境域名配置

在nginx/conf.d/sample修改测试环境域名，示例中使用的testdomain.com改成自己的测试环境域名即可。

另外，建议把测试域名泛解析到部署这台服务的机器。

2、`docker-compose.yml`配置说明

docker-compose的配置文件基本不需要修改，只需要关注：nginx是80端口映射到80端口，jenkins是8080端口，而php-fpm的9000端口不对外开放即可。

当然了，如果php环境需要安装依赖，就需要修改./php/Dockerfile。此外，如果需要添加其他的语言环境，就需要添加一个容器的声明。

3、模块配置

1）部署脚本`build.sh`

业务模块的配置基本是通过部署脚本build.sh来操作的。执行./build.sh提示如下：

Example:
  ./build.sh -u xiongwilee -m php:online,service:online
Usage:
  -u 必填，角色名                       示例：default
  -m 选填，要更新代码的业务模块         示例：php:online,service:online
  -e 选填，更新业务模块对应的环境变量   示例：php:true,service:false
  -d 选填，删除角色                     示例：default

2）PHP模块

新增角色实时上是根据php/sample目录创建了一个角色名对应的文件夹。在sample里只有四个文件：

a. 仓储配置

.gitaddress：声明当前模块的远程仓储地址

b. 钩子

on_add.sh：创建角色时下载PHP模块代码完成之后的回调钩子，用已更新环境变量等文件，执行./build.sh -u {name}会被调用
on_upd.sh：某个模块更新完成之后的回调钩子，用以编译、重启服务等操作，执行./build.sh -u {name} -m web:master会被调用
on_env.sh：更新环境变量的钩子，执行./build.sh -u {name} -m web:master -e web:true都会被调用。

c. 示例目录`app/sample/sample`：

在sample目录下还有个sample目录，这个是一个php模块示例；新增角色之后访问sample.{name}.testdomain.com就可以来测试是否成功新增。

3）Nginx配置

a. `nginx/conf.d`目录

和php/sample目录一样，在nginx/conf.d下也有个sample文件，这个也是在新增角色时使用的示例配置文件。注意，新增角色会把sample中的${name}替换成当前角色名。

b. `nginx/log`目录

nginx/log目录及nginx所有日志文件的宿主机映射目录。

4）Jenkins配置方案

jenkins默认开启8080端口，你可以直接通过http://jenkins.testdomain.com:8080访问jenkins服务。具体初始化过程这里不详述。

a. 安装插件获取当前用户名

在通过Jenkins执行build.sh脚本时，上文提到的角色名怎么获取呢？其实就是jenkins的用户名，你可以通过创建多个jenkins的用户来创建测试环境角色。

参考jenkins插件-Build User Vars Plugin简单说明安装jenkins插件。

安装完成之后就可以通过BUILD_USER环境变量获取当前jenkins的用户名了（当然了，新建jenkins用户的用户名最好是拼音或英文）。

b. Docker镜像中的Jenkins与宿主机通信

由于jenkins存在Docker镜像中，每次jenkins操作需要执行build.sh都需要使镜像中的jenkins与宿主机通信。这里使用的方法是，在jenkins的镜像添加到宿主机的信任关系。

然后就可以通过ssh apple@{jenkins内网IP} "sh build.sh"来直接执行宿主机里的脚本了（这里肯定还有更优雅的方法）。

c. 添加job

添加一个任务后只需要配置两项：

general：“参数化构建过程”：
- 选择 "String Parameter"，添加"web"、"web-fe"、"service"字段
- 选择"Boolean Parameter"，添加"web_env"、“service_env”字段。
构建："Execute Shell"：

echo "正在将 web-fe:${web_fe},web:${web},service:${service}  部署到 ${BUILD_USER_ID} 环境"

ssh apple@{jenkins内网IP} "sh ~/docker-compose/build.sh -u ${BUILD_USER_ID} -m web-fe:${web_fe},web:${web},service:${service} -e web:${web_env},service:${service_env}";

这样，通过这个任务就可以直接在jenkins中执行宿主机中的build.sh脚本，从而实现新增角色、更新代码的操作了。

最后，如果需要在PHP的服务基础上集成其他语言的服务，比如Nodejs，涉及到的改动有：

添加Nodejs镜像：docker-compose.yml
添加部署任务：build.sh
- 创建及删除角色流程
- 部署流程
nginx配置文件示例：nginx/conf.d/sample

五、贡献

欢迎提供其他更专业的思路，欢迎提issue、fork；也可以邮件联系：xiongwilee[at]foxmail.com。