摘要
任何簡單操作的背後,都有一套相當複雜的機制。本文將以SpringBoot應用的在Docker環境下的打包部署爲例,詳細講解如何使用Jenkins一鍵打包部署SpringBoot應用。
Jenkins簡介
Jenkins是開源CI&CD軟件領導者,提供超過1000個插件來支持構建、部署、自動化,滿足任何項目的需要。我們可以用Jenkins來構建和部署我們的項目,比如說從我們的代碼倉庫獲取代碼,然後將我們的代碼打包成可執行的文件,之後通過遠程的ssh工具執行腳本來運行我們的項目。
Jenkins的安裝及配置
Docker環境下的安裝
- 下載Jenkins的Docker鏡像:
docker pull jenkins/jenkins:lts
- 在Docker容器中運行Jenkins:
docker run -p 8080:8080 -p 50000:5000 --name jenkins \
-u root \
-v /mydata/jenkins_home:/var/jenkins_home \
-d jenkins/jenkins:lts
Jenkins的配置
- 運行成功後訪問該地址登錄Jenkins,第一次登錄需要輸入管理員密碼:http://192.168.6.132:8080/
image.png
- 使用管理員密碼進行登錄,可以使用以下命令從容器啓動日誌中獲取管理密碼:
docker logs jenkins
- 從日誌中獲取管理員密碼:
image.png
- 選擇安裝插件方式,這裏我們直接安裝推薦的插件:
image.png
-
進入插件安裝界面,聯網等待插件安裝:
image.png
- 安裝完成後,創建管理員賬號:
image.png
-
進行實例配置,配置Jenkins的URL:
image.png
- 點擊系統管理->插件管理,進行一些自定義的插件安裝:
image.png
-
確保以下插件被正確安裝:
- 根據角色管理權限的插件:Role-based Authorization Strategy
- 遠程使用ssh的插件:SSH plugin
-
通過系統管理->全局工具配置來進行全局工具的配置,比如maven的配置:
image.png
-
新增maven的安裝配置:
image.png
-
在系統管理->系統配置中添加全局ssh的配置,這樣Jenkins使用ssh就可以執行遠程的linux腳本了:
image.png
角色權限管理
我們可以使用Jenkins的角色管理插件來管理Jenkins的用戶,比如我們可以給管理員賦予所有權限,運維人員賦予執行任務的相關權限,其他人員只賦予查看權限。
- 在系統管理->全局安全配置中啓用基於角色的權限管理:
image.png
-
進入系統管理->Manage and Assign Roles界面:
image.png
- 添加角色與權限的關係:
image.png
-
給用戶分配角色:
image.png
打包部署SpringBoot應用
這裏我們使用
mall-learning
項目中的mall-tiny-jenkins
模塊代碼來演示下如何使Jenkins一鍵打包部署SpringBoot應用。
將代碼上傳到Git倉庫
-
首先我們需要安裝Gitlab(當然你也可以使用Github或者Gitee),然後將
mall-tiny-jenkins
中的代碼上傳到Gitlab中去,Gitlab的使用請參考:10分鐘搭建自己的Git倉庫 -
mall-tiny-jenkins
項目源碼地址:github.com/macrozheng/… -
上傳完成後Gitlab中的展示效果如下:
image.png
- 有一點需要
注意
,要將pom.xml中的dockerHost地址改成你自己的Docker鏡像倉庫地址:
image.png
執行腳本準備
- 將
mall-tiny-jenkins.sh
腳本文件上傳到/mydata/sh
目錄下,腳本內容如下:
#!/usr/bin/env bash
app_name='mall-tiny-jenkins'
docker stop ${app_name}
echo '----stop container----'
docker rm ${app_name}
echo '----rm container----'
docker run -p 8088:8088 --name ${app_name} \
--link mysql:db \
-v /etc/localtime:/etc/localtime \
-v /mydata/app/${app_name}/logs:/var/logs \
-d mall-tiny/${app_name}:1.0-SNAPSHOT
echo '----start container----'
- 給.sh腳本添加可執行權限:
chmod +x ./mall-tiny-jenkins.sh
- windows下的.sh腳本上傳到linux上使用,需要修改文件格式,否則會因爲有特殊格式存在而無法執行:
#使用vim編輯器來修改
vi mall-tiny-jenkins.sh
# 查看文件格式,windows上傳上來的默認爲dos
:set ff
#修改文件格式爲unix
:set ff=unix
#保存並退出
:wq
- 執行.sh腳本,測試使用,可以不執行:
./mall-tiny-jenkins.sh
在Jenkins中創建執行任務
- 首先我們需要新建一個任務:
image.png
- 設置任務名稱後選擇構建一個自由風格的軟件項目:
image.png
- 然後在源碼管理中添加我們的git倉庫地址:http://192.168.6.132:1080/macrozheng/mall-tiny-jenkins
image.png
- 此時需要添加一個憑據,也就是我們git倉庫的賬號密碼:
image.png
- 填寫完成後選擇該憑據,就可以正常連接git倉庫了;
image.png
- 之後我們需要添加一個構建,選擇調用頂層maven目標,該構建主要用於把我們的源碼打包成Docker鏡像並上傳到我們的Docker鏡像倉庫去:
image.png
- 選擇我們的maven版本,然後設置maven命令和指定pom文件位置:
image.png
-
之後添加一個執行遠程shell腳本的構建,用於在我們的鏡像打包完成後執行啓動Docker容器的.sh腳本:
image.png
-
需要設置執行的shell命令如下:/mydata/sh/mall-tiny-jenkins.sh
image.png
-
之後點擊保存操作,我們的任務就創建完成了,在任務列表中我們可以點擊運行來執行該任務;
image.png
- 我們可以通過控制檯輸出來查看整個任務的執行過程:
image.png
- 運行成功後,訪問該地址即可查看API文檔:[http://192.168.6.132:8088/swagger-ui.html]
image.png
作者:java菲
鏈接:https://www.jianshu.com/p/875a738be347
來源:簡書
著作權歸作者所有。商業轉載請聯繫作者獲得授權,非商業轉載請註明出處。