關(guān)于Jenkins + Docker + ASP.NET Core自動(dòng)化部署的問題(避免踩坑)

更新時(shí)間：2021年05月13日 15:55:40 作者：xiaoxiaotank

這篇文章主要介紹了關(guān)于Jenkins + Docker + ASP.NET Core自動(dòng)化部署的問題,本文給大家?guī)砹薲ocker安裝方法及一些注意事項(xiàng)，內(nèi)容有點(diǎn)小長(zhǎng)，希望朋友們耐心看完，一定有收獲

本來沒想著要寫這篇博客，但是在實(shí)操過程中，一個(gè)是被網(wǎng)絡(luò)問題搞炸了心態(tài)（真心感覺網(wǎng)絡(luò)能把人搞瘋，別人下個(gè)包、下個(gè)鏡像幾秒鐘搞定，我看著我的幾KB小水管真是有苦說不出），另一個(gè)就是這里面坑還是有一些的，寫出來也是為了讓大家避免重復(fù)踩坑

幾個(gè)注意點(diǎn)：

下方shell命令絕大部分都需要管理員權(quán)限，所以如果你使用的用戶不是root，則都要加上sudo
對(duì)于較復(fù)雜的命令我都提供了注釋版和無注釋版，無注釋版是為了讓你復(fù)制起來方便

準(zhǔn)備工作

CentOS 7.x
Docker
Jenkins
一份支持 docker 的 ASP.NET Core 應(yīng)用程序代碼，可以直接用我的：https://github.com/xiaoxiaotank/MyAspNetCoreApp

安裝Docker

官方文檔：https://docs.docker.com/engine/install/centos/

1.如果你選擇的是一個(gè)新系統(tǒng)，則建議首先更新 yum 和系統(tǒng)內(nèi)核

yum update

2.確保卸載舊版docker

/var/lib/docker/ 下的鏡像、容器、卷和網(wǎng)絡(luò)都會(huì)保留
舊版本中Docker被命名為docker或docker-engine，現(xiàn)在被命名為docker-ce

yum remove docker \
           docker-client \
           docker-client-latest \
           docker-common \
           docker-latest \
           docker-latest-logrotate \
           docker-logrotate \
           docker-engine

3.安裝 yum-utils（其提供了yum-config-manager，下方要用到）

yum install -y yum-utils

4.配置 yum 阿里云 docker 倉庫docker官方倉庫： https://download.docker.com/linux/centos/docker-ce.repo

yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

5.安裝 docker

yum install -y docker-ce docker-ce-cli containerd.io

6.配置 docker 鏡像加速器獲取加速器

地址：https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["這里填入你的加速器url"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

7.查看 docker 信息

docker info

8.hello-world 測(cè)試

docker run hello-world

安裝并初始化Jenkins

官方文檔：https://www.jenkins.io/doc/book/installing/docker/

先說一下：官方文檔中使用了鏡像docker:dind來執(zhí)行docker命令和運(yùn)行程序容器，我感覺完全沒啥必要，而且引入這玩意會(huì)帶來很多額外的問題，所以我沒用它。

如果你想了解dind，請(qǐng)?jiān)L問這里和這篇博客

安裝Jenkins

1.創(chuàng)建Dockerfile文件

vim Dockerfile

2.在Dockerfile文件中填入以下內(nèi)容

Tag參考：https://hub.docker.com/r/jenkins/jenkins
注意：不要使用過時(shí)的鏡像 ~~jenkins~~，而應(yīng)該使用鏡像 jenkins/jenkins

FROM jenkins/jenkins:lts-jdk11
USER root
RUN apt-get update && apt-get install -y apt-transport-https \
       ca-certificates curl gnupg2 \
       software-properties-common
RUN curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
RUN apt-key fingerprint 0EBFCD88
RUN add-apt-repository \
       "deb [arch=amd64] https://download.docker.com/linux/debian \
       $(lsb_release -cs) stable"

# 安裝 docker-ce-cli 才能在 jenkins 中發(fā)送 docker 命令到 docker daemon
RUN apt-get update && apt-get install -y docker-ce-cli

3.構(gòu)建鏡像

docker build . -t myjenkins

如果出現(xiàn)警告：[Warning] IPv4 forwarding is disabled. Networking will not work.

其實(shí)就是說你的linux沒有開啟 Ipv4 數(shù)據(jù)包轉(zhuǎn)發(fā)功能

可以先嘗試重啟docker解決

systemctl restart docker

如果無效，則

# 1. 打開 sysctl.conf
vim /etc/sysctl.conf

# 2.添加下面一行
net.ipv4.ip_forward=1

# 3.重啟 network 和 docker
systemctl restart network && systemctl restart docker

4.運(yùn)行Jenkins注釋版

docker run \
  --name jenkins \                                      # 給容器起個(gè)名字，叫做 jenkins
  --detach \                                            # 以后臺(tái)分離模式運(yùn)行
  --publish 8080:8080 \                                 # host 8080端口映射容器8080端口
  --publish 50000:50000 \                               # host 50000端口映射容器50000端口
  --volume jenkins-data:/var/jenkins_home \             # 卷 jenkins-data 映射容器路徑/var/jenkins_home，這樣就可以在host上直接修改jenkins配置了
  --volume /var/run/docker.sock:/var/run/docker.sock \  # host 上的docker sock映射容器的docker sock，這樣容器內(nèi)的docker命令都會(huì)發(fā)送到host上的docker中來執(zhí)行
  myjenkins                                             # 使用剛剛構(gòu)建的鏡像 myjenkins 來運(yùn)行容器

無注釋版

docker run \
  --name jenkins \
  --detach \
  --publish 8080:8080 \
  --publish 50000:50000 \
  --volume jenkins-data:/var/jenkins_home \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  myjenkins

5.更換Jenkins插件源

前面我們將容器內(nèi)的路徑 /var/jenkins_home 映射到了volume jenkins-data，而所有的docker volume 都存放在目錄 /var/lib/docker/volumes/下

打開hudson.model.UpdateCenter.xml

vim /var/lib/docker/volumes/jenkins-data/_data/hudson.model.UpdateCenter.xml

將文件中的url改為清華大學(xué)官方鏡像：

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

即：

<?xml version='1.1' encoding='UTF-8'?>
<sites>
  <site>
    <id>default</id>
    <!--原 url： https://updates.jenkins.io/update-center.json -->
    <url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url>
  </site>
</sites>

重啟 Jenkins：

docker restart jenkins

初始化Jenkins

訪問：http://<host-ip>:8080輸入管理員初始密碼查看管理員初始密碼：

cat /var/lib/docker/volumes/jenkins-data/_data/secrets/initialAdminPassword

選擇“安裝推薦的插件”

經(jīng)過漫長(zhǎng)的等待之后，由于網(wǎng)絡(luò)環(huán)境、依賴項(xiàng)的問題，很可能出現(xiàn)某些插件安裝失敗，不過咱們先點(diǎn)擊“繼續(xù)”，進(jìn)去再修復(fù)

接下來創(chuàng)建一個(gè)自己的管理員帳號(hào)，確認(rèn)jenkins url

進(jìn)來后，jenkins的主頁面就長(zhǎng)這個(gè)樣子

我們先來修復(fù)一下安裝失敗的插件

點(diǎn)擊左側(cè)菜單欄“Manage Jenkins”，將jenkins升級(jí)為最新版

在 Update Center 頁面時(shí)記得勾選最下方的“安裝完成后重啟Jenkins(空閑時(shí))”

自動(dòng)化配置和部署

點(diǎn)擊jenkins頁面左側(cè)菜單第一個(gè)“新建任務(wù)”，填入任務(wù)名，選擇自由風(fēng)格

填入如下配置信息，并保存

shell命令如下：

image_tag=`date +%Y%m%d%H%M%S`;
echo $image_tag;

# build鏡像并且打上tag
docker build -t myapp:$image_tag .;
docker images;

# 停止并刪除舊版 myapp container
CID=$(docker ps | grep "myapp" | awk '{print $1}')
echo $CID
if [ "$CID" != "" ];then
  docker stop $CID
  docker rm $CID
fi

# 把剛剛build出來的鏡像跑起來
docker run -p 5000:80 --name myapp -d myapp:$image_tag;
docker ps -a;
docker logs myapp;

點(diǎn)擊左側(cè)菜單“立即構(gòu)建”，來部署我們的AspNetCoreApp，并查看“控制臺(tái)輸出”，當(dāng)最終出現(xiàn)“Finished: SUCCESS”時(shí)表示部署成功

訪問：http://<host-ip>:5000/hello （注意加上hello）

2021-05-12T15:28:43.9032704+00:00: Hello !

此時(shí)查看docker中正在運(yùn)行的容器：

CONTAINER ID   IMAGE                  COMMAND                  CREATED             STATUS             PORTS                                                                                      NAMES
e167a135f7a0   myapp:20210512152453   "dotnet MyAspNetCore…"   2 minutes ago       Up 2 minutes       0.0.0.0:5000->80/tcp, :::5000->80/tcp                                                      myapp
e83a2570c334   myjenkins              "/sbin/tini -- /usr/…"   About an hour ago   Up About an hour   0.0.0.0:8080->8080/tcp, :::8080->8080/tcp, 0.0.0.0:50000->50000/tcp, :::50000->50000/tcp   jenkins

注意事項(xiàng)

1. 關(guān)于 jenkins blueocean 等插件下載安裝

如果jenkins想要安裝插件 bluocean 等，不要學(xué)官網(wǎng)將安裝命令放放在Dockerfile中，即使加了參數(shù)--jenkins-update-center來指定加速源，也不建議這樣做。因?yàn)槲覄傞_始也想著盡量自動(dòng)化，可是因?yàn)榫W(wǎng)絡(luò)問題，導(dǎo)致插件一直下載安裝失敗，從而導(dǎo)致鏡像一直構(gòu)建失敗，白白浪費(fèi)了我兩三個(gè)小時(shí)（真的很痛苦）

另外，你也可以在安裝jenkins時(shí)，直接使用鏡像 jenkinsci/blueocean ，該鏡像包含了 blueocean 的相關(guān)插件。

2. 關(guān)于 myapp 容器端口映射 5000 : 80

因?yàn)槲业?Dockerfile 文件中向外暴露的端口是80，所以我用host的端口5000映射了容器端口80，這個(gè)地方要按照你的實(shí)際情況來做出更改。

3. 如果你對(duì) dind (docker in docker) 感興趣

如果你想了解dind，請(qǐng)?jiān)L問這里和這篇博客

以上就是關(guān)于Jenkins + Docker + ASP.NET Core自動(dòng)化部署的問題的詳細(xì)內(nèi)容，更多關(guān)于Jenkins + Docker + ASP.NET Core自動(dòng)化部署的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: