使用Docker环境Jenkins部署spring boot+maven+dockerfile

落日映苍穹つ 2024-05-08 07:07 9阅读 0赞

## **1、jenkins启动命令踩坑**  ##

如果只是简单启动jenkins很简单，但是当你使用时发现各种缺失，重启后之前的配置又得重头来，对于新手来说这么搞一遍头都大了，但是也可以学到很多东西，哈哈！

首先展示我最终启动并最终使用成功的命令：

sudo docker run -d -u root --privileged --name jenkins -p 49003:8080 -v /opt/docker_jenkens:/var/jenkins_home -v /opt/java/apache-maven-3.6.3:/usr/local/maven -v /opt/java/jdk1.8.0_201:/usr/local/jdk -v /home/admin:/home/admin -v /var/run/docker.sock:/var/run/docker.sock -v /root/.m2:/root/.m2 -v $(which docker):/usr/bin/docker jenkins/jenkins:lts

**其它不重要，重点说一下这么些隔-v挂载目录：**  
**/var/jenkins\_home：**

这个时jenkins启动后的工作目录，后边很多插件或者构建都会保存在这里边，所以这个目录必须挂出来，否则一旦重启jenkins，那就重头来过吧。  
**/usr/local/maven与/usr/local/jdk：**

可以使用jenkins自动安装的，但是挂自己宿主机上自己安装的，总会方便很多。  
**/home/admin：**

没什么东西，就是自己想额外多挂一个目录出来，备用。  
**/var/run/docker.sock:/var/run/docker.sock -v $(which docker):/usr/bin/docker**  
这个是在你想使用jenkins部署docker容器时需要的，否则当你在jenkins中试图使用docker命令时，他会告诉你docker not find。  
**/root/.m2**：

为maven项目服务的目录，默认的maven仓库目录。

## **2、jenkins使用** ##

首次访问会需要做一些账户设置之类的引导配置，这个按照步骤来就行了。进去后首先点击 **>系统设置>全局工具配置 ，把jdk,git,maven这几个java项目必需品配置了**。这时就体现出上边启动时挂载的好处了，直接用上边挂载的Jenkins容器目录就好了，否则你可能会遇到各种错误提示。  
然后安装插件，这个看自己需求了，我安装了maven和SSH插件。安装方式在系统管理-插件管理里边。

## **3、jenkins部署** ##

拿构建一个maven项目来说，首先点击新建任务-取个名字-选择下边“构建一个MAVEN项目”（注意这个选项默认是没有的，只有安装了MAVEN插件才会出现），然后就参考这个博客操作一把。  
https://blog.csdn.net/qq\_38157516/article/details/90139120  
但是这位仁兄给的dockerfile和shell脚本不是我所欲，还是自己搞吧。  
我的dockerfile参考：

FROM java:8
    WORKDIR /var/jenkins_home/my-pro-env
    ADD ./eureka-app.jar /app/
    # 声明服务运行在5001端口
    EXPOSE 5001
    # 执行命令
    CMD ["java","-Dspring.profiles.active=local","-jar","/app/eureka-app.jar"]

这里我遇到的坑，就是jenkins是在docker中运行的，然后dockerfile也是在容器中通过shell脚本去执行的，SO这个ADD命令所指定的路径一定要与shell脚本运行的目录对应上，这个在下边的shell脚本再说。

附加点技能，如果想把上边的java -jar添加的命令改为在docker命令启动时传入（这样方便后续做JVM参数配置和调优），可把CMD最后一句注释，添加下边的命令。

ENV PARAMS=""
    # 执行命令
    #CMD ["java","-Dspring.profiles.active=local","-jar","/app/eureka-app.jar"]
    ENTRYPOINT ["sh","-c","java $PARAMS -jar /app/eureka-app.jar"]

我的shell脚本：

echo '================开始构建镜像=============='
    #镜像名称
    IMAGE_NAME='eureka-app'
    #打包后在jenkins的地址
    SOURCE_PATH='/var/jenkins_home/workspace/eureka-app/eureka-app'
    #Dockerfile执行jar包的地址
    BASE_PATH='/var/jenkins_home/my-pro-env'
    echo IMAGE_NAME=$IMAGE_NAME
    
    echo '================复制JAR包==================='
    echo $SOURCE_PATH/target/eureka-app.jar
    cp $SOURCE_PATH/target/eureka-app.jar $BASE_PATH/eureka-app.jar
    cd $BASE_PATH
    pwd
    chmod -R 777 $BASE_PATH/eureka-app.jar
    echo '================复制完成===================='
    
    echo '================当前docker版本=============='
    docker -v
    
    echo '================构建镜像开始================'
    docker build -t $IMAGE_NAME -f $SOURCE_PATH/Dockerfile .
    echo '================构建镜像结束================'
    #输入要推送镜像的地址，根据镜像仓库提示的地址复制
    #echo '================推送镜像开始================'
    #docker login --username=??? --password=??? registry-vpc.cn-beijing.aliyuncs.com
    #docker push $IMAGE_NAME
    #echo '================推送镜像结束================'
    
    echo '================获取容器id=================='
    CID=$(docker ps -a| grep "$IMAGE_NAME" | awk '{print $1}')
    echo 容器id=$CID
    
    echo '================获取镜像id=================='
    IID=$(docker images | grep "$IMAGE_NAME" | awk '{print $3}')
    echo 镜像id=$IID
    
    if [ -n "$CID" ]; then
        echo 存在$IMAGE_NAME容器,停止容器并删除
        docker stop eureka-app
        docker rm eureka-app
        docker run -p 5001:5001 -d --name eureka-app -v $BASE_PATH:$BASE_PATH $IMAGE_NAME
    else
        echo 不存在$IMAGE_NAME容器,开始启动
        docker run -p 5001:5001 -d --name eureka-app -v $BASE_PATH:$BASE_PATH $IMAGE_NAME
    fi

**注意这几个路径：**  
**SOURCE\_PATH：**就是Jenkins容器里边项目打包的路径，注意是jenkins容器里边的路径，不会的，用docker exec -it 容器ID bash进去使用find / -name 项目名找  
**BASE\_PATH：**我们用来放JAR和项目启动挂载路劲，前边说过dockerfile命令中有个ADD命令，会把jar包放到打包的镜像中，此时因为Jenkins会首先执行shell脚本，所以当前的路径会是/var/lib/docker/tmp/docker-builder771981723/这样的，而这个路径里边是没有我们打好的项目jar包的，所以首先在shell命令中，我们把jar包先拷贝到$BASE\_PATH目录下，然后在执行docker build 构建镜像前，把当前目录切换到$BASE\_PATH，这时在执行dockerfile的ADD命令时就没问题了。

docker ps -a保证项目没启动成功会清不了容器导致后边重新构建启动冲突。

如果前边使用到了$PARAMS则在docker run启动命令需要加上：-e

docker run -p 5001:5001 -d --name eureka-app -v $BASE_PATH:$BASE_PATH -e PARAMS=-Dspring.profiles.active=local $IMAGE_NAME

## 4、jenkins连接gitlab ##

（1）如果采用http克隆，则直接在“系统管理”---》“全局凭据管理”里边添加一个用户名和密码的凭据即可。

（2）如果采用ssh克隆，则需要在gitlab上配置jenkins服务器的公钥。此处有个坑点就是网上很多文章写的都是jenkins服务器的公钥但是我们采用的是docker启动，此时再配置jenkins服务器的公钥只会让jenkins部署的服务器能免密拉取，但是jenkins容器中执行克隆代码时仍然提示无权限。

Host key verification failed.
    fatal: Could not read from remote repository.

此时需要docker exec -it jenkins容器ID bash进入容器中执行

ssh-keygen -t rsa         #产生公钥与私钥对

生成两个密钥文件：
    is_rsa 为密钥文件
    id_rsa.pub 为公钥文件

然后再把生成好的公钥放gitlab SSH中，把私钥配置在jenkins的凭据中。

## 5、jenkins容器ssh宿主机 ##

此时需要docker exec -it jenkins容器ID bash进入容器中执行

ssh-keygen -t rsa         #产生公钥与私钥对

生成两个密钥文件：
    is_rsa 为密钥文件
    id_rsa.pub 为公钥文件

然后再把生成好的公钥放宿主机的authorized\_keys。

## 6、 jenkins容器ssh远程服务器无法执行kubectl ##

命名远程服务器自身可以执行kubectl命令，但是在jenkins就是报错：

The connection to the server localhost:8080 was refused - did you specify the right host or port?

是因为使用ssh执行命令和登录后执行Linux所加载的环境变量不同，在使用ssh执行命令时没有加载/etc/profile的环境变量。对此，将/etc/profile目录下kubernetes对应的环境变量添加到/root/.bashrc文件内即可，添加后内容如下，此时再执行时就正常了。

# .bashrc
    
    # User specific aliases and functions
    
    alias rm='rm -i'
    alias cp='cp -i'
    alias mv='mv -i'
    
    # Source global definitions
    if [ -f /etc/bashrc ]; then
            . /etc/bashrc
    fi
    
    export KUBECONFIG=/etc/kubernetes/admin.conf