Docker如何安装jenkins实现微服务多模块打包

发布时间：2022-09-06 17:19:48 作者：iii
来源：亿速云阅读：274

Docker如何安装Jenkins实现微服务多模块打包

引言

在现代软件开发中，微服务架构已经成为一种流行的设计模式。微服务架构将应用程序拆分为多个独立的服务，每个服务都可以独立开发、部署和扩展。然而，随着服务数量的增加，管理和部署这些服务变得越来越复杂。Jenkins强大的持续集成和持续交付（CI/CD）工具，可以帮助我们自动化构建、测试和部署微服务。本文将介绍如何使用Docker安装Jenkins，并通过Jenkins实现微服务多模块的自动化打包。

1. Docker安装Jenkins

1.1 安装Docker

在开始之前，确保你的系统上已经安装了Docker。如果尚未安装，可以参考以下步骤进行安装。

1.1.1 在Ubuntu上安装Docker

# 更新包索引
sudo apt-get update

# 安装必要的包以允许apt通过HTTPS使用仓库
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common

# 添加Docker的官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加Docker的稳定版仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# 更新包索引
sudo apt-get update

# 安装Docker CE
sudo apt-get install docker-ce

1.1.2 在CentOS上安装Docker

# 更新包索引
sudo yum update -y

# 安装必要的包
sudo yum install -y yum-utils device-mapper-persistent-data lvm2

# 添加Docker的稳定版仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# 安装Docker CE
sudo yum install -y docker-ce

1.2 启动Docker服务

安装完成后，启动Docker服务并设置为开机自启。

# 启动Docker服务
sudo systemctl start docker

# 设置Docker服务开机自启
sudo systemctl enable docker

1.3 拉取Jenkins镜像

使用Docker拉取Jenkins官方镜像。

docker pull jenkins/jenkins:lts

1.4 运行Jenkins容器

使用以下命令运行Jenkins容器。

docker run -d -p 8080:8080 -p 50000:50000 --name jenkins -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts

-d：后台运行容器。
-p 8080:8080：将容器的8080端口映射到主机的8080端口。
-p 50000:50000：将容器的50000端口映射到主机的50000端口，用于Jenkins代理通信。
--name jenkins：为容器指定一个名称。
-v jenkins_home:/var/jenkins_home：将Jenkins的数据目录挂载到主机的jenkins_home卷中，以便持久化数据。

1.5 访问Jenkins

在浏览器中访问http://localhost:8080，你将看到Jenkins的初始化页面。首次访问时，Jenkins会要求你输入初始管理员密码。

# 查看初始管理员密码
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

将输出的密码粘贴到Jenkins页面中，然后按照提示完成Jenkins的初始化设置。

2. 配置Jenkins

2.1 安装必要的插件

在Jenkins初始化完成后，建议安装以下插件：

Git Plugin：用于从Git仓库拉取代码。
Maven Integration Plugin：用于构建Maven项目。
Pipeline：用于定义流水线任务。
Docker Pipeline：用于在流水线中操作Docker容器。

你可以通过Manage Jenkins -> Manage Plugins -> Available来搜索并安装这些插件。

2.2 配置JDK和Maven

在Manage Jenkins -> Global Tool Configuration中，配置JDK和Maven。

JDK：选择系统自带的JDK或手动安装JDK。
Maven：选择系统自带的Maven或手动安装Maven。

2.3 配置Git

确保Jenkins服务器上已经安装了Git，并在Manage Jenkins -> Global Tool Configuration中配置Git路径。

3. 创建Jenkins流水线任务

3.1 创建流水线任务

在Jenkins主界面，点击New Item，输入任务名称，选择Pipeline，然后点击OK。

3.2 配置流水线任务

在任务配置页面，找到Pipeline部分，选择Pipeline script from SCM，然后配置以下内容：

SCM：选择Git。
Repository URL：输入你的Git仓库地址。
Credentials：如果有需要，配置Git仓库的认证信息。
Branch Specifier：输入要构建的分支，例如*/main。
Script Path：输入Jenkinsfile的路径，例如Jenkinsfile。

3.3 编写Jenkinsfile

在Git仓库的根目录下创建一个名为Jenkinsfile的文件，内容如下：

pipeline {
    agent any

    environment {
        DOCKER_REGISTRY = 'your-docker-registry'
        DOCKER_IMAGE_NAME = 'your-image-name'
        DOCKER_IMAGE_TAG = 'latest'
    }

    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }

        stage('Build') {
            steps {
                sh 'mvn clean package -DskipTests'
            }
        }

        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }

        stage('Build Docker Image') {
            steps {
                script {
                    def dockerImage = docker.build("${DOCKER_REGISTRY}/${DOCKER_IMAGE_NAME}:${DOCKER_IMAGE_TAG}")
                }
            }
        }

        stage('Push Docker Image') {
            steps {
                script {
                    docker.withRegistry('https://your-docker-registry', 'docker-registry-credentials') {
                        dockerImage.push()
                    }
                }
            }
        }

        stage('Deploy') {
            steps {
                sh 'kubectl apply -f k8s/deployment.yaml'
            }
        }
    }
}

3.4 运行流水线任务

保存配置后，点击Build Now来运行流水线任务。Jenkins将自动拉取代码、构建项目、运行测试、构建Docker镜像、推送镜像到Docker仓库，并部署到Kubernete集群。

4. 微服务多模块打包

4.1 多模块项目结构

假设你的微服务项目是一个多模块的Maven项目，结构如下：

microservice/
├── pom.xml
├── module1/
│   ├── pom.xml
│   └── src/
├── module2/
│   ├── pom.xml
│   └── src/
└── module3/
    ├── pom.xml
    └── src/

4.2 修改Jenkinsfile

为了支持多模块打包，可以在Build阶段中添加多模块构建命令：

stage('Build') {
    steps {
        sh 'mvn clean package -DskipTests -pl module1,module2,module3 -am'
    }
}

-pl：指定要构建的模块。
-am：同时构建依赖的模块。

4.3 构建多模块Docker镜像

如果每个模块需要构建独立的Docker镜像，可以在Build Docker Image阶段中分别构建每个模块的镜像：

stage('Build Docker Image') {
    steps {
        script {
            def dockerImage1 = docker.build("${DOCKER_REGISTRY}/${DOCKER_IMAGE_NAME}-module1:${DOCKER_IMAGE_TAG}", 'module1')
            def dockerImage2 = docker.build("${DOCKER_REGISTRY}/${DOCKER_IMAGE_NAME}-module2:${DOCKER_IMAGE_TAG}", 'module2')
            def dockerImage3 = docker.build("${DOCKER_REGISTRY}/${DOCKER_IMAGE_NAME}-module3:${DOCKER_IMAGE_TAG}", 'module3')
        }
    }
}

4.4 推送多模块Docker镜像

在Push Docker Image阶段中，分别推送每个模块的镜像：

stage('Push Docker Image') {
    steps {
        script {
            docker.withRegistry('https://your-docker-registry', 'docker-registry-credentials') {
                dockerImage1.push()
                dockerImage2.push()
                dockerImage3.push()
            }
        }
    }
}

4.5 部署多模块服务

在Deploy阶段中，分别部署每个模块的服务：

stage('Deploy') {
    steps {
        sh 'kubectl apply -f k8s/module1-deployment.yaml'
        sh 'kubectl apply -f k8s/module2-deployment.yaml'
        sh 'kubectl apply -f k8s/module3-deployment.yaml'
    }
}

5. 总结

通过本文的介绍，你已经学会了如何使用Docker安装Jenkins，并通过Jenkins实现微服务多模块的自动化打包和部署。Jenkins的强大功能和灵活性使得它成为管理复杂微服务架构的理想工具。希望本文能够帮助你在实际项目中更好地应用Jenkins和Docker，提高开发和部署效率。