0
0

Docker搭建Jenkins 实现自动部署教程

文章目录

概要

Jenkins 和 GitLab 是两个流行的工具，通常一起使用来实现持续集成和持续交付（CI/CD）。以下是如何在 Jenkins 中集成 GitLab 的基本步骤：

  1. 安装 Jenkins： 首先，在服务器上安装 Jenkins。可以从 Jenkins 的官方网站（https://www.jenkins.io/download/）下载适用于您操作系统的安装包，并按照安装说明进行安装 或者 使用Docker容器。
  2. 安装 GitLab 插件： 在 Jenkins 中安装 GitLab 插件，以便与 GitLab 服务器进行集成。您可以通过 Jenkins 管理面板的插件管理器来安装该插件。
  3. 配置 Jenkins 项目： 在 Jenkins 中创建一个新的项目（或者使用现有的项目）。 在项目配置中，选择 GitLab 作为版本控制工具，并提供 GitLab 仓库的 URL。 配置 Jenkins 如何获取源代码，您可以选择通过 SSH 密钥或者 GitLab 的访问令牌进行认证。 配置构建触发器，例如当 GitLab 上的特定分支有新的提交时触发构建。
  4. 配置构建步骤： 在 Jenkins 项目中添加构建步骤，例如构建、测试、部署等。您可以使用 Jenkins 的插件来执行这些步骤，或者通过调用 shell 脚本来执行相关操作。

环境安装

linux上进行docker安装有两种方式：

  1. Docker自动化安装
  2. Docker手动安装

可以根据该文章的步骤进行安装：https://blog.csdn.net/weixin_44876263/article/details/136714078?spm=1001.2014.3001.5502

搭建Jenkins容器

  1. 拉取jenkins镜像
docker pull jenkins/jenkins:lts-alpine-jdk17
  1. 生成jenkins容器
#!/bin/bash

# 设置变量
PORT=8081
PROJECT_DIR="/opt/cx/docker/jenkins"

# 创建目录结构
mkdir -p "$PROJECT_DIR/jenkins_home"
mkdir -p "$PROJECT_DIR/logs"

# 运行 Jenkins 容器
docker run -d \
  --restart=always \
  --privileged=true \
  --name jenkins \
  -u root \
  -p "$PORT:8080" \
  -v "$PROJECT_DIR/jenkins_home:/var/jenkins_home" \
  -v "$PROJECT_DIR/logs:/var/log/jenkins" \
  -v "/var/run/docker.sock:/var/run/docker.sock" \
  -v "/etc/localtime:/etc/localtime" \
  jenkins/jenkins:lts-alpine-jdk17

注意：如果需要在jenkins的docker容器中去构建docker或者打包镜像的话需要进入容器内，安装docker命令行工具，Docker CLI 提供了丰富的命令和选项，可以用于构建、运行、管理和监视 Docker 容器。

  1. docker exec -it jenkins /bin/sh
  2. apk add docker-cli
  1. 通过shell脚本运行生成jenkisn容器在这里插入图片描述
  2. 登陆网址，测试jenkins是否运行成功在这里插入图片描述

配置Jenkins

  1. 首次登陆，根据密码提示地址，找到初始密码，修改jenkins密码并登陆进行设置
  2. 安装相应的插件

在这里插入图片描述

安装插件

  1. gitLab（代码管理）在这里插入图片描述
  2. pipeline（流水线）（jenkins推荐安装时自动安装）在这里插入图片描述在这里插入图片描述在这里插入图片描述在这里插入图片描述
  3. SSH（远程登录连接）

在这里插入图片描述

  1. NodeJs（前端构建）

在这里插入图片描述

  1. Role（jenkins用户权限控制插件）在这里插入图片描述
  2. SonarQube（代码检测插件）在这里插入图片描述
  3. 记录job的历史更新记录插件（可找到历史命令脚本）在这里插入图片描述

在jenkins容器中安装JDK、Maven、Node等环境（位置docker jenkins_home中）

jdk：jenkins docker 一般会自带jdk版本（自带的最方便）

jdk最好在docker容器中安装openjdk使用，不会出现no found的情况

在这里插入图片描述

mavan：将maven的压缩包解压到相应位置

node：

  1. 进入jenkins对应容器中docker exec -it [对应容器id] bash
  2. 安装nodejs ， apk add --no-cache nodejs
  3. 再将需要的其他版本node的压缩包解压到相应位置 或者 可以在jenkins中选择自动安装node版本

注意： apk add --no-cache nodejs 这一步是必须的 否则构建前端可能会出现env: ‘node’: No such
file or directory的错误

在这里插入图片描述

配置JDK、Maven、Node环境

  1. 全局属性配置 系统管理——>系统配置——>全局属性在这里插入图片描述
  2. gitLab配置在这里插入图片描述
  3. SSH配置

在jenkins_home中加入私钥文件（用于远程访问其他服务器等）

在这里插入图片描述
在这里插入图片描述

注意：首次访问远程服务器时，需要在jenkins的docker容器内 输入命令ssh xxx.xxx.xxx.xxx 访问其他服务器
授权成功后，jenkins才能无阻碍的访问其他服务器，否则jenkins执行脚本会访问失败
如果id_rsa 不行，那么就再加到 /root/.ssh/id_rsa 里面去
jenkins没足够权限访问 就 chmod 600 ~/.ssh/id_rsa
在这里插入图片描述

被访问的服务器需要填入公钥
在这里插入图片描述

注意：若jenkins是docker运行，若id_rsa文件（ssh私钥）不存在需要将id_rsa文件生成在容器内的jenkins_home目录下，才会生效

在这里插入图片描述

在SSH Server中加入需要远程连接的服务器，填写完成后，可以点击Test Configuration 查看是否成功

注意：远程连接的服务器需要在该服务器的/root/.ssh/authorized_keys文件中加入公钥
在这里插入图片描述

配置 全局工具配置

1. Maven 配置

在这里插入图片描述

2. JDK 安装

在这里插入图片描述

3. git安装

在这里插入图片描述

4. Maven安装

在这里插入图片描述

5. NodeJs安装

在这里插入图片描述

Jenkins自动部署pipeline脚本

前端

1. 编写脚本

pipeline {
    agent any
    
    environment {   
        //远程服务器上的目标目录路径。
        remoteDirectory ='/opt/cx/docker/xxxxxxx/nginx/html' ///front'
        //要发送到远程服务器的本地文件路径
        localFile = "/var/jenkins_home/workspace/${env.JOB_NAME}"
        
        //仓库地址和ID
        credentialsId = 'xxxxxxxxxxxxxxxxxxxxxx'
        url = 'http://xxxxxxxxxxxxxxxxxxxxxxxxxxxx.git'
        
        // 指定的node版本
        node = 'node20'
        
        //打包环境
        environment = 'test'
    }
    

    stages {
        stage('拉取代码') {
            steps {
              checkout(
                    [$class: 'GitSCM',
                        branches: [[name: "${commit}"]], // 使用选定的提交版本
                        doGenerateSubmoduleConfigurations: false,
                        extensions: [],
                       userRemoteConfigs: [[credentialsId: "$credentialsId", url: "$url"]]]
                )
            }
        }
        
        stage('构建静态资源') {
            steps {
                dir("$localFile"){
                    nodejs("$node") {
                        sh 'npminstall -g'
                        sh 'pnpminstall'
                        sh "pnpm run build:$environment"
                        sh 'tar -zcf ./dist/dist.tar.gz ./dist/*'
                    }
                }     
            }
        }
        stage('部署静态资源') {
            steps {
                script {
                    echo '发送pc前台静态资源压缩包到服务器'
                    // 多个IP地址字符串
                    def serverIps = "${ServerIp}"
                    // 使用逗号分割IP地址列表
                    def ipList = serverIps.split(',')

                    // 循环遍历IP地址列表
                    ipList.each { ip ->
                        // 构建远程服务器地址
                        def remoteServer = "root@${ip}"
                        // 使用SSH命令部署代码到远程服务器
                        sh "scp $localFile/dist/dist.tar.gz $remoteServer:$remoteDirectory/"
                        sh "ssh $remoteServer 'sudotar -zxf $remoteDirectory/dist.tar.gz -C $remoteDirectory'"
                        sh "ssh $remoteServer 'rm -rf $remoteDirectory/dist.tar.gz'"
                    }
                }
            }
        }
        stage('清理工作区'){
             steps {
                script {
                    // 进入目录并删除它
                    deleteDir()}}}}}

2. 执行结果
在这里插入图片描述

后端

1. 设置构建参数
请添加图片描述
在这里插入图片描述

2. 编写脚本

pipeline {
    agent any
    
    environment {
        // 远程服务器上的目标目录路径
        remoteDirectory ='/opt/cx/project/xxxx'
        //jenkins中项目的目录路径
        localDir ="/var/jenkins_home/workspace/${env.JOB_NAME}"
        //后端jar包
        jar ='xxxxxxxxxx.jar'
        // 要发送到远程服务器的本地文件路径
        localFile ="$localDir/target/$jar"
        // 远程jar包地址
        remoteJarPath ="$remoteDirectory/$jar"
        
        // 指定的JDK工具
        jdkTool ='jdk11'
        // 指定的Maven工具
        mavenTool ='apache-maven-3.6.3'
        
        //仓库地址和ID
        credentialsId ='xxxxxxxxxxxxxxxxxxxxxx'
        url ='http:xxxxxxxxxxxxxx.git'
        
        //打包环境
        environment ='test'
        
        //需要发送的配置文件
        applicationName ="application-${environment}.yaml"
        applicationPath ="$localDir/src/main/resources/${applicationName}"}
    
    
    stages {
        stage('拉取代码'){
            steps {
                checkout([$class:'GitSCM',
                        branches: [[name: "${commit}"]],
                        doGenerateSubmoduleConfigurations: false,
                        extensions: [],
                        // Git仓库的URL和凭证
                        userRemoteConfigs: [[credentialsId: "$credentialsId", url: "$url"]]])}}
        
        stage('maven编译'){
            tools {
                // 使用指定的JDK和Maven工具
                jdk jdkTool
                maven mavenTool
            }
            steps {
               // 使用Maven编译项目
               sh"mvn -f pom.xml clean -P $environment package -Dmaven.test.skip=true"}}
        
        stage('发送jar包'){
            steps {
                script {
                // 多个IP地址字符串
                def serverIps ="${ServerIp}"
                // 使用逗号分割IP地址列表
                def ipList = serverIps.split(',')
                    
                // 循环遍历IP地址列表
                ipList.each {ip ->
                    // 定义远程服务器地址
                    def remoteServer ="root@${ip}"
                    // 使用SCP命令发送jar包到远程服务器
                    sh"scp $localFile$remoteServer:$remoteDirectory/"}}}}
        
        stage('部署代码'){
            steps {
                script {
                    // 多个IP地址字符串
                    def serverIps ="${ServerIp}"
                    // 使用逗号分割IP地址列表
                    def ipList = serverIps.split(',')

                    // 循环遍历IP地址列表
                    ipList.each {ip ->
                        // 构建远程服务器地址
                        def remoteServer ="root@${ip}"
                        // 发送文件 application 到远程服务器
                        sh"scp ${applicationPath}${remoteServer}:${remoteDirectory}/application.yaml"
                        // 使用SSH命令部署代码到远程服务器
                        sh"ssh ${remoteServer} '${remoteDirectory}/deploy-jar.sh'"}}}}

    stage('清理工作区'){
             steps {
                script {
                    // 删除工作区文件
                    deleteDir()}}}}}
    
    //若需要sonarqube代码扫描可以用下面的脚本
    // stage('代码扫描'){
    //      tools {
    //             jdk "jdk17" // the name you have given the JDK installation using the JDK manager (Global Tool Configuration)
    //         }
        
    //     steps {
    //          dir(workspace){
    //               script{
    //               // 引入SonarQubeScanner工具；sonar-scanner 与前面在Global Tool Configuration中配置的Name值一致
    //               scannerHome = tool 'sonarqube_scanner'   //sonarqube扫描器名
    //           }
    //              //引入SonarQube服务器环境；sonarqube 与前面在System Configuration 配置的Name值一致
    //             withSonarQubeEnv('sonarqube_severs'){    //sonarqube服务器名
    //               //windows环境使用 bat
    //                 sh"${scannerHome}/bin/sonar-scanner "+
    //                 "-Dsonar.host.url=${SONAR_HOST_URL} " +  //sonar服务地址
    //                 "-Dsonar.language=java " + 
    //                 "-Dsonar.projectKey=xxxxxxx " +  //项目ID
    //                 "-Dsonar.projectName=xxxxxxx " + //项目名称
    //                 "-Dsonar.projectVersion=0.0.1-SNAPSHOT " + 
    //                 "-Dsonar.login=admin " + //sonar登录账号 
    //                 "-Dsonar.password=xxxxxxx " +  //sonar登录密码
    //                 "-Dsonar.sourceEncoding=UTF-8 " + 
    //                 "-Dsonar.sources=. " + 
    //                 "-Dsonar.exclusions=**/test/**,**/target/**,**/resources/static/** " + 
    //                 "-Dsonar.java.binaries=. " //target 检测（maven编译后得到的文件）
    //             }
    //          }
    //     }
    // }}

3. 执行结果
在这里插入图片描述

采用Jenkinsfile的方式构建pipeline脚本

在这里插入图片描述
选择 Pipeline script from SCM
在这里插入图片描述
按照该步骤填写，并将Jenkinsfile文件放在项目目录下
在这里插入图片描述
Jenkinsfile文件中的内容与2.编写脚本中的内容一致，只是调用方式改变。

执行结果：
在这里插入图片描述

Role-based Authorization Strategy插件配置用户权限

1.配置用户权限流程

在这里插入图片描述

2.设置Global roles 全局角色设置 和 Item roles 项目设置

在这里插入图片描述

3.配置角色权限范围

在这里插入图片描述

小结

可能遇见的问题：

1. 登陆初始密码后报错，该Jenkins实例似乎已离线。

在这里插入图片描述

解决方案：

原因一：升级站点的链接https://updates.jenkins.io/update-center.json默认是https

修改升级站点的链接

  1. 保留此离线页面，重新开启一个浏览器tab标签页
  2. 输入jenkins登陆网址http://localhost:8080/pluginManager/advanced （自己的登陆地址+路径/pluginManager/advanced ）
  3. 进入该页面最底下，找到【Update Site】，把其中的链接改成http，http://updates.jenkins.io/update-center.json，点击Submit保存，Check now 能够检测当前URL是否能够更新站点；
  4. 提示jenkins，在重新启动jenkins，已经可以重新连网，下载插件在这里插入图片描述

重要：如果改完Http还是不行，请改成如下镜像
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
http://mirror.esuni.jp/jenkins/updates/update-center.json
http://mirror.xmission.com/jenkins/updates/update-center.json

原因二：Jenkins在下载插件之前会检查网络链接，会去读取配置文件的网址Jenkins_home/updates/default.json

修改default.json文件

  • 不管是用本地运行war包的方式启动的Jenkins，还是Docker运行的Jenkins，找到运行目录下(Docker就是挂载出来的目录)
  • 一个叫updates目录，修改里面的default.json文件，把第一个遇到的www.google.com，修改成www.baidu.com
  • 重启jenkins

注意：要先关闭jenkins后才能对该文件进行修改，否则修改保存无法生效
（docker 运行的jenkins 一定要挂载目录（如：Jenkins_home） 否则容器关闭后无法进入容器内修改default.json文件）

在这里插入图片描述

在这里插入图片描述

原因三：Jenkins访问连接被防火墙阻拦

关闭防火墙

  • 检查防火墙状态：systemctl status firewalld.service
  • 手动关闭防火墙：systemctl stop firewalld.service
  • 关闭防火墙开机自启：systemctl disable firewalld.service

原因四：Jenkins版本太老

  • 重新拉取其他版本的jenkins镜像，换一个可能就会成功，一般前面三个原因的不会出现，大概率的镜像版本引起的。
  • 例如：使用jenkins/jenkins:lts-alpine-jdk11 jenkins离线无法下载插件，换成jenkins/jenkins:lts-alpine-jdk17 就能正常运行

2. 前端npm构建找不到，env: ‘node’: No such file or directory

原因：出现问题是docker jenkins 里面没有自动安装node导致找不到这个Node命令
解决方案：手动安装nodejs

# 进入jenkins对应容器中
# docker exec -it [对应容器id] bash
 
# 安装nodejs
# apk add --no-cache nodejs
 
# 检查node
# node -v

3. pipeline执行过程中git参数的commit 版本选择出现 版本无法显示的问题

在这里插入图片描述

原因：原因未知

解决方案：
重新创建一个新的pipeline任务，可能解决该问题。
在这里插入图片描述

标签： docker jenkins servlet
本文转载自: https://blog.csdn.net/weixin_44876263/article/details/136713935
版权归原作者 老友@ 所有， 如有侵权，请联系我们删除。
登录后发布评论

“Docker搭建Jenkins 实现自动部署教程”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

网络安全法-网络运行安全

使用selenium/drissionpage时如何阻止chrome自动跳转http到https

docker desktop 里部署的Open WebUI 管理员密码忘记了的处理方法

在ubuntu20.04中搭建onsite比赛运行环境

利用开源的低代码表单设计器FcDesigner高效管理和渲染复杂表单结构

Kafka学习笔记

【前端】浏览器输入url到页面呈现发生了什么？

文章导航