?(不要錯過!)【CI/CD技術專題】「Jenkins實戰系列」(3)Jenkinsfile+DockerFile實現自動部署

李浩宇Alex發表於2021-08-05

每日一句

沒有人會因學問而成為智者。學問或許能由勤奮得來,而機智與智慧卻有懶於天賦。

前提概要

  • Jenkins下用DockerFile自動部署Java專案,專案的部署放心推向容器化時代機制。
  • 本節需要對jenkinsfile有點了解,對dockerfile有點了解,對shell有點了解,對docker有點了解

環境準備

新建-構建一個Maven專案

需要提一下,現在新安裝的沒有這個選項,需要在外掛裡安裝一下 Maven Integration

java配置,其他配置檢視以前文章

釋出到伺服器,DockerFile部署自動構建

Publish SSH配置

執行流程

  1. jenkins拉取程式碼倉庫中的程式碼
  2. jenkins執行jenkinsfile檔案(可指定檔名)
  3. 先在jenkins所在的伺服器將拉取的專案build成docker映象
  4. 將映象釋出到映象倉庫
  5. 在應用伺服器的節點上將該映象拉取下來(私有倉庫需要使用者名稱/密碼)
  6. 在應用伺服器上執行該映象

jenkins配置

建立一個Pipeline SCM專案 jenkins專案名為sample-tezst (和釋出的工程名保持一致)

  • Definition選擇 【Pipeline Script from SCM】

  • Branch Specifier(blank for 'any'):選擇分支

  • Additional Behaviours: 新增郵箱通知的傳送者

  • Script Path: 填寫使用專案中的Jenkinsfile檔案的名字

應用工程配置

在工程的根目錄下建立Dockerfile檔案和Jenkins_docker檔案

jenkinsfile_docker檔案內容如下:

docker整合docker部署
pipeline {
    agent {label 'master'}
    tools{
        maven 'maven'
    }
    environment {
        GIT_PROJECT_ADDR="git@gitee.com:uncleqiao/springboot-test.git" //專案的git地址
        JENKINS_WORKSPACE="/root/.jenkins/workspace"    //jenkins存放檔案的地址
        PROJECT_NAME="${JOB_NAME}"  			        // 專案名
        JAR_NAME="sample-tezst-0.0.1-SNAPSHOT.jar"   // 專案生成的jar的名字
        IMAGE_NAME="sample-tezst"                    // 映象名一般和專案名相同
        IMAGE_ADDR="repository/qiao_namespace/${IMAGE_NAME}"    // 映象的位置
        VERSION_ID="${BUILD_ID}"
    }
    stages {
        stage('pullCode'){
            steps{
                echo 'This is a pullCode step'
                //git branch: "${BRANCH}", credentialsId: '1001', url: "${GIT_PROJECT_ADDR}"
                checkout scm
            }
        }
        stage('Build') {
            steps{
                echo 'This is a Build step'
                // 在有Jenkinsfile同一個目錄下(專案的根目錄下)
                sh 'mvn clean package -Dmaven.test.skip=true'
            }
        }
        // 建立目錄(如果不存在),並把jar檔案上傳到該目錄下
        stage('ssh') {
            steps{
                echo 'push jar to target server'
                sh '''
                    ole_image_id=`docker images|grep ${IMAGE_NAME}|grep ${VERSION_ID}|awk '{print $3}'`
                    if [[ -n "${ole_image_id}" ]]; then
                        docker rmi -f ${ole_image_id}
                    fi
                    docker build -f  Dockerfile --build-arg jar_name=${JAR_NAME} -t ${IMAGE_NAME}:${VERSION_ID} .
                    new_image_id=`docker images|grep ${IMAGE_NAME}|grep ${VERSION_ID}|awk '{print $3}'`
                    sudo docker tag ${new_image_id} ${IMAGE_ADDR}:${VERSION_ID}
                    sudo docker push ${IMAGE_ADDR}:${VERSION_ID}
                '''
            }
        }
        stage('run') {
            // 在應用伺服器節點 test
            agent {
                node {
                    label 'test'
                    //customWorkspace "${SERVER_TARGET_PATH}"  //此引數會初始化目錄 注意填寫
                }
            }
            options {
                // 不讓它切換到節點上自動從倉庫拉取專案
                skipDefaultCheckout()
            }
            steps {
                echo 'pull image and docker run'
                withEnv(['JENKINS_NODE_COOKIE=dontKillMe']) {
                    sh '''
                        sudo docker login --username=yourusername --password=yourpassword ccr.ccs.tencentyun.com
                        sudo docker pull ${IMAGE_ADDR}:${VERSION_ID}

                        container_id=`docker ps|grep ${IMAGE_ADDR}:${VERSION_ID}|awk '{print $1}'`
                        if [ -n "${container_id}" ]; then
                        	docker rm -f "${container_id}"
                        fi
                        old_pid=`ps -ef|grep ${JAR_NAME}|grep -v grep|awk '{print $2}'`
                        if [[ -n $old_pid ]]; then
                            kill -9 $old_pid
                        fi
                        old_image=`docker images|grep ${IMAGE_ADDR}|grep ${VERSION_ID}`
                        if [[ -n $old_image ]]; then
                            old_image_id=`echo ${old_image}|awk '{print $3}'`
                            docker rmi -f ${old_image_id}
                        fi
                        sudo docker run --name "${PROJECT_NAME}_${VERSION_ID}" -p 9001:8081 -d ${IMAGE_ADDR}:${VERSION_ID}
                    '''
                }
            }
        }
    }
}

注意:

if [ -n str ] 這個命令在使用的時候如果str為空,也是true,可以使用 if [ -n ${str} -a "${str}x" != "x" ]或者使用if [[ -n ${str} ]]來判斷
shell語法中,$()` 和 `` (兩個單引號) 可以在子shell中執行命令,但是這兒$()不支援

idea沒有jenkinsfile的語法提示,很容易出錯,這個很難受

步驟一:拉取專案 在【pullCode】步驟中

checkout scm , 這個scm是建立jenkins流水線時選擇的,屬於特殊變數,代表了你的倉庫資訊,自動從倉庫中獲取專案

步驟二: 【Build】

將拉取下來的專案進行編譯並打包

步驟三:【build_image】

將打包好的專案build成docker映象,然後推送到映象倉庫(這裡可以分成兩步)

獲取已經存在的映象
ole_image_id=`docker images| grep ${IMAGE_NAME} | grep ${VERSION_ID}|awk '{print $3}'`
刪掉存在的映象
if [[ -n "${ole_image_id}" ]]; then
	docker rmi -f ${ole_image_id}
fi
  • 通過專案根目錄下的Dockerfile來構建映象
    • -f:[filename] --build-arg <key=value> 給Dockerfile傳遞引數
    • -t:映象的名稱:版本 這裡我將jenkins的構建次數當作映象的版本
docker build -f Dockerfile --build-arg jar_name=${JAR_NAME} -t ${IMAGE_NAME}:${VERSION_ID} .
獲取構建好的映象的id
new_image_id=`docker images | grep ${IMAGE_NAME} | grep ${VERSION_ID} | awk '{print $3}'`
根據生成的映象,tag出一個名稱空間不同的映象
sudo docker tag ${new_image_id} repoistory/qiao_namespace/${IMAGE_NAME}:${VERSION_ID}
將映象倉庫能夠識別的映象推送到倉庫
sudo docker push repoistory/qiao_namespace/${IMAGE_NAME}:${VERSION_ID}

步驟四:【run】

應用伺服器拉取專案並且執行, 這一步要選擇節點(應用伺服器,如果是叢集,就不用節點用scp登陸吧)

登陸到映象倉庫
sudo docker login --username=yourusername --password=yourpassword repository
從倉庫中拉取剛才生成的映象
sudo docker pull repository/qiao_namespace/${IMAGE_NAME}:${VERSION_ID}
檢視已經存在的容器, 存在則刪掉 存在則刪掉 這裡應該是一個陣列,有點小問題,待修改
container_id=`docker ps | grep ${IMAGE_ADDR}:${VERSION_ID} | awk '{print $1}'`
if [ -n "${container_id}" ]; then
	docker rm -f "${container_id}"
fi
檢視已經執行的同版本的專案, 存在則刪掉
pid=`ps -ef | grep ${JAR_NAME}| grep -v grep | awk '{print $2}'`
if [[ -n $pid ]]; then
	kill -9 $pid
fi
檢視已經存在的映象
old_image=`docker images|grep ${IMAGE_ADDR}|grep ${VERSION_ID}`
if [[ -n $old_image ]]; then
	old_image_id=`echo ${old_image}|awk '{print $3}'`
    docker rmi -f ${old_image_id}
fi

執行容器

sudo docker run --name "${PROJECT_NAME}_${VERSION_ID}" -p 9001:8081 -d ${IMAGE_ADDR}:${VERSION_ID}

Dockerfile

檔案內容如下

FROM repository/qiao_namespace/myjdk8:v1
預設jar包的名字 注意分隔符為 :- 這裡是由jenkinsfile中build dockerfile時傳遞過來的
ARG jar_name={jar_name:-sample-teszt-0.0.1-SNAPSHOT.jar}
RUN 用於容器內部執行命令
RUN mkdir -p /usr/local/project
WORKDIR /usr/local/project
將專案放到/usr/local/project下
COPY ./target/sample-teszt-0.0.1-SNAPSHOT.jar ./
EXPOSE 8081
CMD java -jar -Dserver.port=8081 springboot-test-0.0.1-SNAPSHOT.jar

執行完畢後我們登陸到應用伺服器,看到容器已經啟動

相關文章