Docker使用Git实现Jenkins发布、测试项目的详细流程

下面我来详细讲解一下使用Docker、Git和Jenkins进行项目发布和测试的完整攻略。

概述

使用Docker、Git和Jenkins进行项目发布和测试的流程可以概括为以下几步：

编写项目代码并提交到Git仓库；
配置Jenkins服务器，包括安装Docker、配置Jenkins插件和设置Jenkins Job；
使用Jenkins Job拉取项目代码、构建Docker镜像并启动容器；
运行自动化测试并获取测试报告；
如果测试通过，则将新版本的Docker镜像推送到Docker Hub或私有镜像仓库，更新生产环境容器；否则回滚到旧版本的Docker镜像。

下面我们来逐步详细讲解每一步的具体操作和注意事项。

步骤

步骤一：编写项目代码并提交到Git仓库

这一步可以通过使用Git工具或者使用集成开发环境的Git插件实现。首先需要将项目代码和相关依赖打包为一个可运行的项目，例如可以使用Maven构建Java项目，使用npm构建前端项目等。然后将打包好的项目提交到Git仓库，例如GitHub、GitLab等。

步骤二：配置Jenkins服务器

安装Docker

Jenkins服务器需要安装Docker工具，可以通过以下命令在Linux服务器上安装：

sudo apt-get update
sudo apt-get install docker.io

配置Jenkins插件

Jenkins提供了很多与Docker相关的插件，例如docker-plugin、docker-workflow、docker-build-publish等。我们需要根据自己的需求选择并安装插件。以docker-plugin插件为例，在Jenkins控制台选择“插件管理”->“可选插件”，搜索“docker-plugin”关键字并安装。

设置Jenkins Job

在Jenkins控制台选择“新建任务”，选择“自由风格的软件项目”。在任务配置页面，可以设置以下内容：

项目源码：Git仓库地址、分支、认证（如果需要）等；
构建环境：选择“Provide Node & npm bin/ folder to PATH”选项，使得Jenkins可以使用Node和npm命令；
构建：采用自定义命令进行项目构建，例如执行“mvn clean install”命令进行Java项目构建；
构建后操作：执行Docker相关的命令，例如构建Docker镜像、启动Docker容器、执行自动化测试等。

步骤三：使用Jenkins Job拉取项目代码、构建Docker镜像并启动容器

在Jenkins Job配置完成后，就可以开始自动化发布流程了。Jenkins会自动拉取Git仓库的最新版本代码，根据配置的构建命令进行项目构建，并生成Docker镜像和启动容器。示例如下：

# 拉取Git仓库代码
git clone <Git仓库地址> <本地目录>

# 进入项目目录
cd <本地目录>

# 构建Docker镜像
docker build -t <镜像名称> .

# 启动Docker容器
docker run -d --name <容器名称> <镜像名称>

在启动Docker容器时可以配置端口映射、挂载数据卷等参数，使得容器可以与外部进行交互。例如：

docker run -d --name <容器名称> -p 8080:80 -v <宿主机目录>:<容器目录> <镜像名称>

步骤四：运行自动化测试并获取测试报告

随着容器的启动，Jenkins将执行自动化测试脚本并获取测试报告，以判断新版本的项目是否可以成功发布到生产环境。自动化测试可以使用各种语言的测试框架，例如JUnit、Selenium、Protractor等。测试报告可以以HTML格式进行展示，并可以在Jenkins控制台查看。示例如下：

# 执行自动化测试脚本
mvn test

# 获取测试报告
cat target/surefire-reports/*.html

步骤五：发布或回滚

如果自动化测试通过，则可以将新版本的Docker镜像推送到Docker Hub或私有镜像仓库，更新生产环境容器。否则需要回滚到旧版本的Docker镜像。示例如下：

# 推送Docker镜像到Docker Hub
docker login <Docker Hub 地址>
docker push <Docker Hub账号>/<镜像名称>:<版本号>

# 回滚到旧版本的Docker镜像
docker stop <容器名称>
docker rm <容器名称>
docker run -d --name <容器名称> <旧版本镜像名称>

这里需要特别注意，发布新版本容器之前必须先停止并删除旧版本容器，否则新旧容器将会重名并导致冲突。因此可以在Jenkins Job中使用“docker stop”和“docker rm”命令清理旧版本容器。

示例

下面是两个使用Docker、Git和Jenkins进行项目发布和测试的示例：

示例一：Java Web项目

假设我们有一个Java Web项目，使用Maven构建。我们希望将项目发布到Docker容器中进行测试。以下是具体的步骤：

1.在GitHub上创建仓库，并将Java Web项目代码提交到仓库。

2.安装Docker和Jenkins，并安装docker-plugin插件。

3.在Jenkins控制台创建新的自由风格的软件项目。在项目配置页面中设置项目源码和构建环境。构建命令如下：

mvn clean install

4.在“构建后操作”中设置Docker相关的命令。

# 删除旧版本Docker容器
docker stop hello-world
docker rm hello-world

# 构建Docker镜像并启动容器
docker build -t hello-world .
docker run -d --name hello-world -p 8080:8080 hello-world

# 执行自动化测试
mvn test

# 获取测试报告
cat target/surefire-reports/*.html

5.安装JUnit测试框架，在Java Web项目中编写自动化测试脚本。例如：

public class HelloControllerTest {

    private MockMvc mockMvc;

    @Before
    public void setup() {
        mockMvc = MockMvcBuilders.standaloneSetup(new HelloController()).build();
    }

    @Test
    public void testHello() throws Exception {
        mockMvc.perform(MockMvcRequestBuilders.get("/hello"))
                .andExpect(MockMvcResultMatchers.status().isOk())
                .andExpect(MockMvcResultMatchers.content().string("Hello, World!"));
    }

}

6.再次运行Jenkins Job，Jenkins会拉取最新的Java Web项目代码，进行编译、构建Docker镜像、启动Docker容器、执行自动化测试，最后获取测试报告。如果测试通过，则会将新版本的Docker镜像推送到Docker Hub或私有镜像仓库，并更新生产环境容器。否则回滚到旧版本的Docker镜像。

示例二：Web应用项目

假设我们有一个Web应用项目，使用npm构建。我们希望将项目发布到Docker容器中进行测试。以下是具体的步骤：

1.在GitLab上创建仓库，并将Web应用项目代码提交到仓库。

2.安装Docker和Jenkins，并安装docker-build-publish-plugin插件。