摘要：三部署架構說明這個方案僅適用于小公司敏捷項目團隊聯調測試環境的部署，同時也可以作為學習入門的，并不適用于有一定規模的生產環境。另外，建議把測試域名泛解析到部署這臺服務的機器。模塊配置部署腳本業務模塊的配置基本是通過部署腳本來操作的。

項目地址： https://github.com/xiongwilee...
基本特性：

快捷部署多人nginx+php的開發測試環境，也可以擴展構建其他語言；
基于Docker和docker-compose，不依賴K8S等高級編排工具，成本低廉、部署簡單；
Docker內置集成jenkins，一鍵添加開發測試角色，無需額外配置；
支持微服務架構，適用于小公司or敏捷項目團隊，也可以作為Docker學習入門的case；

在角色分工明確的團隊里，什么樣的條件才算是最優雅的聯調和測試環境？在大廠里肯定都有很多高級的解決方案，比如這些：

docker搭建大規模測試環境的實踐 / 測試開發之路--k8s 下的大規模持續集成與環境治理

DevOps落地實踐：BAT系列：CICD：iPipe vs CCI

阿里 DevOps 轉型實踐

大型團隊的合作框架下，必須依賴更復雜的DevOps架構（參考：DevOps詳解）。但對于成員不多、負責的Web項目工程量也不大的團隊，面臨的問題肯定也更單純：

前后端角色工程解耦，開發環境分離；

工程師只關注業務邏輯本身，持續集成；

環境和角色一鍵創建、一鍵更新、一鍵銷毀，環境之間不受影響；

即便是只有這些需求，在以往的“開發機”的聯調環境里，一旦需要添加開發或者測試人員，或者需要更新nginx的配置，再或者需要更新PHP、Nodejs的版本……對于測試環境的維護來說都是很痛苦的。

注意： 當前部署方案僅依賴：Docker,Docker-compose,git

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

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

此時，在app/會創建demo目錄，在nginx/conf.d會創建demo.conf文件。

$ docker-compose up -d

此時，再執行docker-compose ps會發現創建了三個鏡像。然后，配置hosts使sample.demo.testdomain.com指向當前機器，然后訪問http://sample.demo.testdomain... 返回phpinfo()信息，說明創建成功。

TIPS: 這個方案僅適用于小公司or敏捷項目團隊聯調測試環境的部署，同時也可以作為Docker學習入門的case，并不適用于有一定規模的生產環境。

在“開發機”上僅僅安裝docker、docker-compose、git之后就能跑起來Nginx、PHP的應用，當然得益于docker容器化的思想。其實這個的實現也僅僅利用了容器化的這個特性，最終docker-compose打包的整個服務會長駐內存，無需太多的管理成本。

最終的實現還具備兩個特點：

基于這個實現的boilerplate你可以輕易的遷移到其他項目，以及其他語言；

每個sample管理每個應用的倉儲地址、環境變量配置、更新代碼后的鉤子等操作；

其實現原理為：通過腳本文件，管理docker-compose隱射到宿主機的配置、源碼，同時將docker-compose暴露出來以實現服務的管理。架構圖如下：

先看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配置）來構建。

由于在docker中實現了nginx配置文件及php源碼文件的映射到宿主機，需要通過管理宿主機上文件就可以管理代碼的發布和部署了，build.sh就是用來做這件事情的。

當然了，如果需要在部署代碼完成之后，做重啟、編譯等操作，通過sample目錄下的鉤子就可以實現了。

具體實現可以參考build.sh源碼。

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

另外，建議把測試域名泛解析到部署這臺服務的機器。

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

當然了，如果php環境需要安裝依賴，就需要修改./php/Dockerfile。此外，如果需要添加其他的語言環境，就需要添加一個容器的聲明。

業務模塊的配置基本是通過部署腳本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

新增角色實時上是根據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就可以來測試是否成功新增。

a. nginx/conf.d目錄

和php/sample目錄一樣，在nginx/conf.d下也有個sample文件，這個也是在新增角色時使用的示例配置文件。注意，新增角色會把sample中的${name}替換成當前角色名。

b. nginx/log目錄

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

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。