前言
Docker一直很火熱,一直想把原本的Jenkins自動(dòng)部署工具搬到Docker上面,無奈今年一直忙于各種事情,遲遲未實(shí)施這個(gè)事情,正好迎來了dotnet core 2.0 的正式發(fā)布,升級(jí)項(xiàng)目的同時(shí),順便直接將Jenkins搬到Docker上。為什么要寫這篇文章呢?因?yàn)檎疫^相關(guān)的資料,大多數(shù)文章都是基于Ubuntu 安裝.net core 又或者 GitLab 進(jìn)行持續(xù)集成 自動(dòng)部署等等等,并未有人嘗試過Centos7.3 上部署 Jenkins 并且 構(gòu)建 ASP.NET CORE 2.0 的應(yīng)用。當(dāng)然筆者表示并不知道為什么ubuntu有這么多人青睞。
接下來,筆者將從本片博文中,粗略的教大家怎么安裝Docker 和 Jenkins 并且使用Visual Studio 2017 新建Demo 并實(shí)現(xiàn)自動(dòng)部署,下面話不多說了,來一起看看詳細(xì)的介紹吧。
環(huán)境準(zhǔn)備
硬件配置: 1核1G 1M帶寬。50G硬盤。
系統(tǒng)環(huán)境:CentOS 7.3(64位)
其實(shí)用的就是騰訊云
安裝Docker
其實(shí)安裝Docker的過程,大家可以到Docker官網(wǎng)找到自己相對應(yīng)的安裝文檔進(jìn)行安裝,Docker區(qū)分CE和EE的兩個(gè)版本,具體這兩個(gè)版本有什么區(qū)別,大家自行查閱相關(guān)資料,這里不再概述。教程用的是CE那么就找到對應(yīng)的官方文檔進(jìn)行安裝,以下是教程安裝的步驟
1.更新一下包吧,多更無害
# sudo yum -y update
2.安裝所需的軟件包 (其實(shí)這些騰訊云都具備了,只不過怕有些閹割版的系統(tǒng)缺少,所以貼上命令,安裝過的使用該命令不會(huì)造成傷害)
# sudo yum install -y yum-utils \ device-mapper-persistent-data \ lvm2
3.使用穩(wěn)定版的倉庫(當(dāng)然可以使用最新版或測試版的倉庫,這個(gè)需要官方的說明)
# sudo yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo
4.安裝Docker ce
# sudo yum install docker-ce
tips:在生產(chǎn)系統(tǒng)上,您應(yīng)該安裝特定版本的Docker CE,而不是始終使用最新版本。
5.啟動(dòng)Docker
# sudo systemctl start docker
6.docker通過運(yùn)行hello-world映像驗(yàn)證是否正確安裝。
# docker run hello-world
如果出現(xiàn)以下的界面,就代表安裝成功
配置Docker加速器
此步驟不是必須的,前提是你的環(huán)境有梯子或者網(wǎng)速可以的,那么可以忽略這個(gè)步驟。
$ curl -sSL https://get.daocloud.io/daotools/set_mirror.sh | sh -s https://mirror.ccs.tencentyun.com
使用https://mirror.ccs.tencentyun.com這個(gè)加速地址的前提是你必須要使用騰訊云,該地址外部無法訪問,只有騰訊云才能使用此鏡像地址。你可以使用DaoCloud加速地址,具體另行查閱相關(guān)資料。
安裝Jenkins
首先不直接從Docker Store上直接Pull Jenkins 的 Image 文件,因?yàn)榇龝?huì)需要進(jìn)行dotnet core 的 Docker自動(dòng)部署,需要對宿主機(jī)上的Docker進(jìn)行直接操作,那么需要掛載 Docker 給 Jenkins Image,所以現(xiàn)在需要自己動(dòng)手編寫 Dockerfile 構(gòu)建自定義的Jenkins。
# touch Dockerfile # vim Dockerfile
插入以下內(nèi)容:
FROM jenkins USER root #清除了基礎(chǔ)鏡像設(shè)置的源,切換成騰訊云的jessie源 #使用非騰訊云環(huán)境的需要將 tencentyun 改為 aliyun RUN echo '' > /etc/apt/sources.list.d/jessie-backports.list \ && echo "deb http://mirrors.tencentyun.com/debian jessie main contrib non-free" > /etc/apt/sources.list \ && echo "deb http://mirrors.tencentyun.com/debian jessie-updates main contrib non-free" >> /etc/apt/sources.list \ && echo "deb http://mirrors.tencentyun.com/debian-security jessie/updates main contrib non-free" >> /etc/apt/sources.list #更新源并安裝缺少的包 RUN apt-get update && apt-get install -y libltdl7 && apt-get update ARG dockerGid=999 RUN echo "docker:x:${dockerGid}:jenkins" >> /etc/group # 安裝 docker-compose 因?yàn)榈认聵?gòu)建環(huán)境的需要 RUN curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose RUN chmod +x /usr/local/bin/docker-compose
如果不安裝libltdl7 會(huì)導(dǎo)致如下這個(gè)問題,原因是jenkins容器內(nèi)部沒有這個(gè)包
docker: error while loading shared libraries: libltdl.so.7: cannot open shared object file: No such file or directory Build step 'Execute shell' marked build as failure
在Jenkins操作宿主的Docker的時(shí)候會(huì)出現(xiàn)拒絕訪問的問題,其實(shí)就是容器的jenkins用戶沒有權(quán)限訪問容器外的docker命令,所以 RUN命令 需要把Jenkins用戶加入到Docker用戶組
構(gòu)建Image
# docker build . -t auto-jenkins
出現(xiàn)以上 Successfully 內(nèi)容代表安裝Jenkins成功
在啟動(dòng)Jenkins時(shí),需要先創(chuàng)建一個(gè)Jenkins的配置目錄,并且掛載到docker 里的Jenkins目錄下
# mkdir -p /var/jenkins_home
運(yùn)行 Jenkins
# docker run --name jenkins -p 8080:8080 -p 50000:50000 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $(which docker):/bin/docker \ -v /var/jenkins_home :/var/jenkins_home \ -d auto-jenkins
第一行:構(gòu)建一個(gè)名稱為jenkins的容器 -p 是容器運(yùn)行開放端口
第二行 和第三行: -v 是將宿主機(jī)的docker文件掛載進(jìn)容器里
第四行:建立宿主機(jī)的配置目錄,掛載進(jìn)docker容器里,這樣容器里的Jenkins配置目錄文件就會(huì)映射出來
第五行:使用auto-jenkins Image 并且后臺(tái)啟動(dòng)
這個(gè)時(shí)候 run Jenkins 會(huì)提示成功
執(zhí)行 docker ps 命令后,發(fā)現(xiàn)什么都沒有
執(zhí)行 docker ps -a 命令看看
執(zhí)行 docker start -a jenkins 讓容器前臺(tái)輸出運(yùn)行信息的方式運(yùn)行
不難看出其實(shí) Jenkins 啟動(dòng)已經(jīng)是可以了,只是權(quán)限問題導(dǎo)致這個(gè)錯(cuò)誤的信息。
現(xiàn)在需要看一下Jenkins官方的Dockerfile
知道問題原因,貼上代碼了。
##修改 /var/jenkins 文件夾權(quán)限 # chown -R 1000 /var/jenkins_home
繼續(xù)執(zhí)行運(yùn)行Jenkins 代碼
# docker run --name jenkins -p 8080:8080 -p 50000:50000 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $(which docker):/bin/docker \ -v /var/jenkins_home:/var/jenkins_home \ -d auto-jenkins
這時(shí)你會(huì)看到悲催的信息
容器之前已經(jīng)運(yùn)行過了,所以會(huì)有一個(gè)容器已經(jīng)存在了。哥來給你搽眼淚。執(zhí)行以下命令,刪除原本 run 出來的容器
# docker rm -f jenkins
刪除完容器后,繼續(xù)執(zhí)行運(yùn)行命令
# docker run --name jenkins -p 8080:8080 -p 50000:50000 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $(which docker):/bin/docker \ -v /var/jenkins_home:/var/jenkins_home \ -d auto-jenkins
出現(xiàn)一串字符后,執(zhí)行 docker ps 會(huì)發(fā)現(xiàn)容器已經(jīng)啟動(dòng)了,正常了。這個(gè)時(shí)候是不是可以使用了?別著急,還有很長的路。
配置Jenkins
打開瀏覽器輸入地址 your IP:8080 進(jìn)行訪問,你會(huì)開心的看到這個(gè)界面,看到這個(gè)界面代表你的Jenkins 已經(jīng)安裝成功了,但是需要進(jìn)行配置,現(xiàn)在就教大家怎么去配置
首先,進(jìn)入容器內(nèi)
# docker exec -it jenkins /bin/bash
查看/var/jenkins_home/secrets/initialAdminPassword 文件內(nèi)的密碼
# cat /var/jenkins_home/secrets/initialAdminPassword
其實(shí)不一定要進(jìn)入容器內(nèi)查看密碼,可以直接在宿主機(jī)的環(huán)境下,查看 /var/jenkins//secrets/initialAdminPassword 的內(nèi)容,因?yàn)橹肮P者已經(jīng)將這個(gè)目錄掛載進(jìn)Docker里面了
復(fù)制輸出的內(nèi)容,粘貼到Administrator password,輸入 exit 退出容器,此時(shí)進(jìn)行下一步你會(huì)看到此界面,點(diǎn)擊 Install suggested plugins
等待初始化完畢
到了這一步,自己隨緣去填吧。
使用VS2017創(chuàng)建一個(gè)ASP.NET Core 2.0 Web應(yīng)用程序,并將代碼上傳到git。這里筆者就不演示上傳代碼的過程步驟了。
為你們準(zhǔn)備了一個(gè)地址,方便你們完成本教程:http://git.oschina.net/wenalu/MvcTest
新建一個(gè)自由風(fēng)格的軟件項(xiàng)目,并填名稱 點(diǎn)擊 OK
填寫源代碼管理
勾選 Poll SCM 設(shè)置拉取Git 上代碼的間隔,筆者這里是兩分鐘拉取一次
勾上 Delete workspace before build start 是設(shè)置構(gòu)建前刪除工作區(qū)
勾上 Abort the build if it's stuck 是設(shè)定構(gòu)建的超時(shí)時(shí)間,如果構(gòu)建使用的時(shí)間超過設(shè)定的時(shí)間,那么就認(rèn)為這次的構(gòu)建是失敗的。筆者這里超時(shí)設(shè)置的是10分鐘
增加一個(gè)Execute Shell 腳本,并填寫以下腳本內(nèi)容
#!/bin/bash # 獲取短版本號(hào) GITHASH=`git rev-parse --short HEAD` echo ---------------Remove-Orphans------------------ docker-compose -f ./docker-compose.yml -f ./docker-compose.override.yml -p dockercompose4255153253317384266 down --rmi local --remove-orphans echo ------------------Config----------------------- docker-compose -f ./docker-compose.ci.build.yml -p dockercompose4255153253317384266 config echo ------------------Build------------------------ docker-compose -f ./docker-compose.ci.build.yml -p dockercompose4255153253317384266 up --build echo ---------------Publishing...------------------ docker-compose -f "./docker-compose.yml" -f "./docker-compose.override.yml" -p dockercompose4255153253317384266 up -d --build
應(yīng)用保存,回到項(xiàng)目界面上。點(diǎn)擊立即構(gòu)建進(jìn)行部署工作 SUCCESS
打開瀏覽器,地址輸入 your IP:8088/
遇到的問題
其實(shí)上面的篇幅為了大家能盡快的實(shí)現(xiàn)部署,只是簡要的介紹了途中一些常犯的錯(cuò)誤。其實(shí)在搭建這個(gè)CI環(huán)境的時(shí)候遇到不止這些問題,比如說一開始的 Dockerfile 內(nèi)容并不像教程中的一樣。一開始是這樣的:
FROM jenkins USER root #清除了基礎(chǔ)鏡像設(shè)置的源,切換成阿里云的jessie源 RUN echo '' > /etc/apt/sources.list.d/jessie-backports.list \ && echo "deb http://mirrors.tencentyun.com/debian jessie main contrib non-free" > /etc/apt/sources.list \ && echo "deb http://mirrors.tencentyun.com/debian jessie-updates main contrib non-free" >> /etc/apt/sources.list \ && echo "deb http://mirrors.tencentyun.com/debian-security jessie/updates main contrib non-free" >> /etc/apt/sources.list #更新源并安裝缺少的包 RUN apt-get update && apt-get install -y libltdl7 && apt-get update ARG dockerGid=999 RUN echo "docker:x:${dockerGid}:jenkins" >> /etc/group USER jenkins
當(dāng)你如果在網(wǎng)上找到其他教程,教你如何安裝jenkins,而你使用了類似于這個(gè)內(nèi)容的Dockerfile,那么會(huì)在Jenkins構(gòu)建編譯的時(shí)候產(chǎn)生如下兩個(gè)錯(cuò)誤:
第一:缺少 docker-compose
出現(xiàn)這個(gè)狀況,當(dāng)然是可以解決的。首先進(jìn)入容器,然后找到官方的安裝docker-compose文檔進(jìn)行安裝,jenkins使用的是Linux直接找到對應(yīng)的Linux安裝資料即可。
第二:權(quán)限問題
從容器內(nèi)手動(dòng)安裝 docker-compose 會(huì)出現(xiàn)無法安裝的情況,原因是Jenkins 用戶沒有安裝docker-compose 的權(quán)限
解決上述問題,當(dāng)然可以切換 root 用戶,但是筆者使用最笨最直接的方式,從構(gòu)建鏡像的時(shí)候就直接不使用 jenkins 用戶,所以教程中并沒有最后一句 USER jenkins 。這樣做目的是讓教程步驟更順利
tips:正式生產(chǎn)環(huán)境不建議直接切換到 root 用戶運(yùn)行
運(yùn)行 Jenkins 命令一開始是這樣的:
# docker run --name jenkins -p 8080:8080 -p 50000:50000 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $(which docker):/bin/docker \ -v /var/jenkins:/var/jenkins_home \ -d auto-jenkins
這樣會(huì)造成構(gòu)建的時(shí)候找到一個(gè)根本不存在的目錄上
其實(shí)就是第三句 將/var/jenkins 改成 /var/jenkins_home 就解決這個(gè)問題了。
此時(shí)此刻,如果你曾經(jīng)遇到過這樣的問題,哥現(xiàn)在已經(jīng)給你擦眼淚了。
當(dāng)然這里不僅僅有這些問題的存在,只是有一部分在做這個(gè)教程的時(shí)候沒有截圖,就不再闡述了。
寫在最后
其實(shí)筆者曾Google過這些教程,但是一無所獲,發(fā)覺挺多人使用Ubuntu的,就是找不到一個(gè)Centos的案例。當(dāng)然筆者也不知道他們?yōu)槭裁聪矚g使用Ubuntu。這里把實(shí)施過程的心得分享給大家,是因?yàn)榕潞芏嗳烁P者一樣重滔覆轍,沒有人幫助的日子挺慘的,也就算這么久以來為社區(qū)做些貢獻(xiàn)吧。
好了,
聲明:本網(wǎng)頁內(nèi)容旨在傳播知識(shí),若有侵權(quán)等問題請及時(shí)與本網(wǎng)聯(lián)系,我們將在第一時(shí)間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com