建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯網營銷解決方案
Jenkins部署SpringBoot的Docker鏡像步驟詳解
前面我們介紹了K8S+Docker+Maven插件打包部署SpringCloud微服務項目，在實際應用過程中，很多項目沒有用到K8S和微服務，但是用到了Docker和SpringBoot，所以，我們這邊介紹，如果使用Jenkins+jib-maven-plugin插件打包部署SpringBoot項目的Docker鏡像。
在來賓等地區(qū)，都構建了全面的區(qū)域性戰(zhàn)略布局，加強發(fā)展的系統(tǒng)性、市場前瞻性、產品創(chuàng)新能力，以專注、極致的服務理念，為客戶提供網站建設、成都做網站 網站設計制作按需搭建網站,公司網站建設,企業(yè)網站建設,品牌網站制作,全網營銷推廣,成都外貿網站建設,來賓網站建設費用合理。
網上有多種Docker打包插件使用說明，講解最多的是Spotify開源的，Spotify官方已不再推薦使用docker-maven-plugin插件進行打包，而是推薦其最新的docker打包插件dockerfile-maven-plugin，但是dockerfile-maven-plugin也已經很久沒有更新了，在使用方面也有局限性，比如：只支持在本機Docker的鏡像build、tag、push。
經過幾個插件的對比，發(fā)現Google開源的Jib插件功能更強大，它可以不寫Dockerfile，不需要在本地安裝Docker環(huán)境就能實現Docker打包，而且一直在更新，所以這里選擇這個插件作為我們的Docker打包插件。Jib構建Java的Docker和OCI映像，不需要在本機安裝Docker daemon，也不需要深入掌握Docker最佳實踐。它可以作為Maven和Gradle的插件以及Java庫使用。
下面介紹Jib（ jib-maven-plugin插件 ）如何將SpringBoot應用程序分層打包Docker鏡像，充分利用Docker的鏡像分層復用機制，解決網絡限制和占用大量磁盤空間的問題。
Jib（ jib-maven-plugin插件 ）構建的三個參數：
- buildTar：本地構建，不需要Docker daemon就可以將鏡像生成tar文件，保存在工程的target目錄下。
- dockerBuild：將構建的鏡像存到當前環(huán)境的Docker daemon。
- build：將構建的鏡像推送到遠程倉庫，官方倉庫或者Harbor私有倉庫。
一、SpringBoot項目jib-maven-plugin插件配置說明
我們這里主要使用buildTar命令，將Docker鏡像文件打包在本地，然后通過Jenkins插件發(fā)布到服務器運行，這樣可以不需要搭建使用私有Docker鏡像倉庫Harbor。
- 打包命令：
-Dimage可以在打包時自定義鏡像名稱和版本，這個可以在Jenkins腳本時使用，如果不配置默認使用pom.xml里面配置的鏡像名稱和版本，如果不設置版本，默認版本是latest。
clean package -Ptest -Dimage=gitegg:1.0.1 jib:buildTar -f pom.xml- docker鏡像載入命令：
docker load用來載入鏡像包，但是不能對載入的鏡像重命名；docker import用來載入容器包，但兩者都會恢復為鏡像，可以為鏡像指定新名稱；經過測試，jib-maven-plugin插件生成的Docker鏡像文件jib-image.tar只能通過docker load載入，并且在pom.xml配置中format不能選擇OCI（K8S時使用OCI），否則載入不了。
docker load --input jib-image.tar- 可以將jib-maven-plugin插件的打包命令綁定到Maven的生命周期：
install
build
- 將Docker鏡像推送到私有鏡像倉庫Harbor，當然這里不需要，但是可以配置鏡像名稱和鏡像版本，當在運行打包命令時，沒有加參數-Dimage，就會取此處的配置。
私有倉庫地址/項目名稱/${project.artifactId}:${project.version}
私有倉庫用戶名
私有倉庫密碼
- volumes 創(chuàng)建容器內的目錄，當SpringBoot項目記錄日志等需要自定義的目錄地址時，此處需要定義容器內的目錄；SpringBoot使用的內嵌Tomcat容器默認使用/tmp作為工作目錄，這里可以不配置/tmp的valumes。
/tmp
/log
- workingDirectory 容器內的工作目錄，容器啟動時執(zhí)行的命令會在容器內的此目錄下執(zhí)行。
/gitegg - format 使用OCI構建OCI容器映像。這里直接注釋掉不要使用，否則docker load時不能載入，在K8S里面可以使用，所以這里不使用這個format。
OCI 下面是SpringBoot項目中pom.xml的jib-maven-plugin插件配置信息：
······
······
3.3.2
······
······
com.google.cloud.tools
jib-maven-plugin
${jib.maven.plugin.version}
install
build
true
openjdk:11-jre
${docker.harbor.addr}/${docker.harbor.project}/${project.artifactId}:${project.version}
${docker.harbor.username}
${docker.harbor.password}
-Xms512m
-Xmx8g
/tmp
/log
/gitegg
Asia/Shanghai
USE_CURRENT_TIMESTAMP
二、服務器Docker運行環(huán)境配置
前面我們講了如何安裝Docker，以及相關配置，所以這里不再贅述，直接按照自己的服務器實際情況進行安裝配置Docker即可，這里講解如何為運行SpringBoot的Fat Jar做環(huán)境準備，以及說明鏡像包傳輸到服務器之后執(zhí)行的部署腳本。
1、部署及備份目錄準備
- 新建 /opt/tmp 目錄，用于Jenkins打包后，通過 Publish Over SSH插件將包傳輸到服務器的臨時目錄。
- 新建 /opt/bak 目錄，用于存儲所有部署過的包備份，方便后續(xù)版本回滾。此目錄可能會占用很大空間，所以需要選擇一個磁盤空間大的掛載目錄。
- 新建 /opt/script 目錄，用于Jenkins將包傳輸完成之后，執(zhí)行安裝、備份操作的相關命令腳本。
- 新建 /data/container/docker_server/tmp 目錄，用于映射容器內/tmp目錄，/tmp目錄是SpringBoot內置Tomcat默認運行目錄。
- 新建 /data/container/docker_server/logs目錄，用于映射容器內/var/log目錄，/var/log目錄是項目配置的日志存放目錄，映射到宿主機之后，方便查看不同級別的日志。
mkdir -p /opt/tmp /opt/bak /opt/script /data/container/docker_server/tmp /data/container/docker_server/logs
chmod -R 777 /opt/tmp /opt/bak /opt/script /data/container/docker_server/tmp /data/container/docker_server/logs2、部署腳本編寫說明
- 定義入參，可以通過Jenkins任務將參數傳入腳本中，我們定義了下面5個參數：
container_name=gitegg-server ： 容器名稱image_name=gitegg-server ： 鏡像名稱version=latest ： 鏡像版本image_port=8182 ： 宿主主機端口映射server_port=8080 ： 容器內服務端口 - 對參數進行檢查，是否未傳入參數，這里根據自己的實際情況判斷，比如必須傳入哪些參數，就設置參數的個數不能小于幾。
echo "param validate"
if [ $# -lt 1 ]; then
echo "you must use like this : ./publish_docker_server.sh [image port] [server port]"
exit
fi - 入參賦值，如果有參數傳入，則取服務參數，如果沒有參數傳入則取默認值
if [ "$1" != "" ]; then
container_name="$1"
fi
echo "container_name=" $container_name
if [ "$2" != "" ]; then
image_name="$2"
fi
if [ "$3" != "" ]; then
version="$3"
fi
echo "version=" $version
if [ "$4" != "" ]; then
image_port="$4"
fi
echo "image_port=" $image_port
if [ "$5" != "" ]; then
server_port="$5"
fi
echo "server_port=" $server_port- 停止并刪除容器
echo "執(zhí)行docker ps"
docker ps
if [[ "$(docker inspect $container_name 2> /dev/null | grep $container_name)" != "" ]];
then
echo $container_name "容器存在，停止并刪除"
echo "docker stop" $container_name
docker stop $container_name
echo "docker rm" $container_name
docker rm $container_name
else
echo $container_name "容器不存在"
fi- 停止并刪除鏡像
# 刪除鏡像
echo "執(zhí)行docker images"
docker images
if [[ "$(docker images -q $image_name 2> /dev/null)" != "" ]];
then
echo $image_name '鏡像存在，刪除鏡像'
docker rmi $(docker images -q $image_name 2> /dev/null) --force
else
echo $image_name '鏡像不存在'
fi- 備份本次安裝鏡像包
#bak image
echo "bak image" $image_name
BAK_DIR=/opt/bak/docker/$image_name/`date +%Y%m%d`
mkdir -p "$BAK_DIR"
cp "/opt/tmp/jib-image.tar" "$BAK_DIR"/"$image_name"_`date +%H%M%S`.tar- 執(zhí)行安裝鏡像包命令
echo "docker load" $image_name
docker load --input /opt/tmp/jib-image.tar- 執(zhí)行運行命令
echo "docker run" $image_name
docker run -d -p $image_port:$server_port --name=$container_name --restart=always -v /data/container/docker_server/tmp:/tmp -v /data/container/docker_server/logs:/var/log $image_name- 刪除安裝文件，因為前面已經備份過了，所以這里將臨時安裝文件刪除
echo "remove tmp " $image_name
rm -rf /opt/tmp/jib-image.tar- 打印執(zhí)行完成的命令
echo "Docker Server is starting,please try to access $container_name conslone url"3. 完整的安裝部署腳本
container_name=gitegg-server
image_name=gitegg-server
version=latest
image_port=8181
server_port=8080
echo "param validate"
if [ $# -lt 1 ]; then
echo "you must use like this : ./publish_docker_server.sh [image port] [server port]"
exit
fi
if [ "$1" != "" ]; then
container_name="$1"
fi
echo "container_name=" $container_name
if [ "$2" != "" ]; then
image_name="$2"
fi
if [ "$3" != "" ]; then
version="$3"
fi
echo "version=" $version
if [ "$4" != "" ]; then
image_port="$4"
fi
echo "image_port=" $image_port
if [ "$5" != "" ]; then
server_port="$5"
fi
echo "server_port=" $server_port
echo "執(zhí)行docker ps"
docker ps
if [[ "$(docker inspect $container_name 2> /dev/null | grep $container_name)" != "" ]];
then
echo $container_name "容器存在，停止并刪除"
echo "docker stop" $container_name
docker stop $container_name
echo "docker rm" $container_name
docker rm $container_name
else
echo $container_name "容器不存在"
fi
# 刪除鏡像
echo "執(zhí)行docker images"
docker images
if [[ "$(docker images -q $image_name 2> /dev/null)" != "" ]];
then
echo $image_name '鏡像存在，刪除鏡像'
docker rmi $(docker images -q $image_name 2> /dev/null) --force
else
echo $image_name '鏡像不存在'
fi
#bak image
echo "bak image" $image_name
BAK_DIR=/opt/bak/docker/$image_name/`date +%Y%m%d`
mkdir -p "$BAK_DIR"
cp "/opt/tmp/jib-image.tar" "$BAK_DIR"/"$image_name"_`date +%H%M%S`.tar
echo "docker load" $image_name
docker load --input /opt/tmp/jib-image.tar
echo "docker run" $image_name
docker run -d -p $image_port:$server_port --name=$container_name --restart=always -v /data/container/docker_server/tmp:/tmp -v /data/container/docker_server/logs:/var/log $image_name
echo "remove tmp " $image_name
rm -rf /opt/tmp/jib-image.tar
echo "Docker Server is starting,please try to access $container_name conslone url" 三、新建Jenkins配置打包任務，部署SpringBoot項目Docker鏡像
1、Dashboard > 新建任務，輸入任務名稱，選擇“構建一個maven項目”，點擊確定。
2、項目配置，進入到任務配置頁
- 丟棄舊的構建 ：這里在保持構建的最大個數填寫5，當然可以根據自己情況填寫，否則舊的構建包會一直存在占用磁盤空間。
- 源碼管理：配置git代碼地址、用戶名密碼和版本分支，如果是需要用戶名密碼的git庫，那么下面需要選擇訪問的用戶名密碼，這里一定要使用用戶名密碼方式，使用token的方式無法選中?？梢栽谙路絘dd，也可以在Jenkins全局Credentials 中添加，方便其它任務使用。
- 構建觸發(fā)器：可選可不選，這個根據自己的需求選擇，任務在什么情況下出發(fā)構建。
- 構建環(huán)境：這里不需要選擇，在介紹構建NodeJS項目時，需要選中NodeJS環(huán)境。
- Build：這里填寫Maven打包命令，可以添加參數選擇打包環(huán)境test或prod，定義鏡像名稱和版本等。
clean package -Dmaven.test.skip=true -Ptest -Dimage=gitegg jib:buildTar -f pom.xml- Post Steps：將打包后的文件發(fā)送到服務器，并執(zhí)行設置好的腳本，這里選擇Run only if build succeeds，當構建成功時Post。
- Exec command：將打好的包發(fā)布到環(huán)境之后，在環(huán)境上執(zhí)行的部署腳本命令。publish_docker_server.sh 是腳本文件、第一個gitegg 是容器名稱、第二個gitegg 是鏡像名稱、latest 是鏡像版本、8181 是宿主機端口號、8080 是容器內服務口號。
/opt/script/publish_docker_server.sh gitegg gitegg latest 8181 80803、運行構建任務
- 立即構建
- 查看構建日志：點擊立即構建之后，下方會出現進度條，點擊進度條就可以進入構建日志界面。
- 構建成功后，下方會給出構建成功提示，此時登錄遠程服務器查看文件是否部署成功即可。
4、Docker鏡像部署成功之后，可以使用以下Docker常用命令查看運行情況
- 查看鏡像
docker images- 查看有哪些容器在運行
docker ps- 停止容器
docker stop 容器id- 刪除容器、刪除鏡像
docker rm 容器id
docker rmi 鏡像id- 查看容器運行日志
docker logs -f 容器id- 進入到容器
docker exec -it 容器id /bin/bash標題名稱：Jenkins部署SpringBoot的Docker鏡像步驟詳解
網頁網址：http://www.5511xx.com/article/dpjoeso.html
