[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

林曉lx發表於2022-06-08
使用Docker容器方案可以快速安全地將專案部署到客戶的伺服器上,作為公司專案,需要解決兩個問題:

1. 需要搭建一個私有的Docker倉庫,以便安全的儲存映象

2. 需要一套自動化釋出方案,實現程式碼到應用部署的自動化流程

大致流程如下

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

在java世界中有很多文章介紹了Docker+Jenkin的自動化部署方式,這次來看看如何用這一套工具實現.Net 應用的釋出。

編寫DockerFile

以Soa專案為例MatoApps/Soa: 一個輕量級的微服務庫,基於.Net 6 + Abp框架 可快速地將現有專案改造成為面向服務體系結構,實現模組間鬆耦合。 (github.com)

Soa/sample/MainHost/Soa.GatewaySample.Web.Host/Dockerfile

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443
EXPOSE 44311

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["sample/MainHost/Soa.GatewaySample.Web.Host/Soa.GatewaySample.Web.Host.csproj", "sample/MainHost/Soa.GatewaySample.Web.Host/"]
COPY ["sample/MainHost/Soa.GatewaySample.Web.Core/Soa.GatewaySample.Web.Core.csproj", "sample/MainHost/Soa.GatewaySample.Web.Core/"]
COPY ["sample/MainHost/Soa.GatewaySample.Application/Soa.GatewaySample.Application.csproj", "sample/MainHost/Soa.GatewaySample.Application/"]
COPY ["sample/MainHost/Soa.GatewaySample.Core/Soa.GatewaySample.Core.csproj", "sample/MainHost/Soa.GatewaySample.Core/"]
COPY ["sample/Services.Abstract/Soa.Sample.IService2/Soa.Sample.IService2.csproj", "sample/Services.Abstract/Soa.Sample.IService2/"]
COPY ["src/Soa/Soa.csproj", "src/Soa/"]
COPY ["sample/Services.Abstract/Soa.Sample.IAuthorizedService/Soa.Sample.IAuthorizedService.csproj", "sample/Services.Abstract/Soa.Sample.IAuthorizedService/"]
COPY ["sample/Services.Abstract/Soa.Sample.IService1/Soa.Sample.IService1.csproj", "sample/Services.Abstract/Soa.Sample.IService1/"]
COPY ["sample/MainHost/Soa.GatewaySample.EntityFrameworkCore/Soa.GatewaySample.EntityFrameworkCore.csproj", "sample/MainHost/Soa.GatewaySample.EntityFrameworkCore/"]
COPY ["src/Soa.Client/Soa.Client.csproj", "src/Soa.Client/"]
RUN dotnet restore "sample/MainHost/Soa.GatewaySample.Web.Host/Soa.GatewaySample.Web.Host.csproj"
COPY . .
WORKDIR "/src/sample/MainHost/Soa.GatewaySample.Web.Host"
RUN dotnet build "Soa.GatewaySample.Web.Host.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Soa.GatewaySample.Web.Host.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Soa.GatewaySample.Web.Host.dll"]
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 

搭建CI/CD伺服器

CI/CD伺服器用於將程式碼端到倉庫的自動化釋出,假設你已經擁有一臺CentOS 7的伺服器,IP地址為192.168.31.69,並且已經安裝好了Docker和Jenkins。

安裝私有倉庫

sudo docker pull registry
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

設定啟動方式為後臺任務,埠為5000,並設定隨docker服務一同啟動

sudo docker run -d -p 5000:5000 --restart always  registry
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

更改docker.service

sudo nano /usr/lib/systemd/system/docker.service
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

在ExecStart命令後面新增引數,新增本機IP地址到registry中 

[Service]
ExecStart=/usr/bin/dockerd --insecure-registry 192.168.31.69:5000
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

重啟docker服務 

sudo systemctl daemon-reload
sudo systemctl restart docker
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

[可選]安裝並執行whalerator,whalerator是一個docker映象倉庫視覺化工具,可以提供類似Docker Hub的方式瀏覽映象

 jevonsflash/whalerator: Portable front end for Docker Registry (github.com)

sudo docker run -d -p 8081:80 --restart always whalerator/whalerator
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 測試

下載從dockerhub上下載一個倉庫,再將他提交到私有倉庫中

sudo docker pull jevonsflash/soasampleauthorizedservicehost:latest
sudo docker tag jevonsflash/soasampleauthorizedservicehost:latest 192.168.31.69:5000/soasampleauthorizedservicehost:latest
sudo docker push 192.168.31.69:5000/soasampleauthorizedservicehost
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

防火牆開啟8081與8082埠以便外部環境可以訪問

firewall-cmd --zone=public --add-port=8081/tcp --permanent
firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --reload
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

在同網段下的瀏覽器中輸入 http://192.168.31.69:8081, 將跳轉至管理頁面

選擇Anonymous匿名登陸,輸入192.168.31.69:5000,點選Submit

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 可以看到soasampleauthorizedservicehost:latest已經存在於倉庫內了[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

配置Jenkins 

首先配置Jenkins的shell指令碼許可權

sudo visudo
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 在檔案末尾新增規則,這樣執行sudo命令時將跳過root管理員密碼驗證

jenkins         ALL=(ALL) NOPASSWD:ALL
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

重啟jenkins 

sudo systemctl restart jenkins
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

在同網段下的瀏覽器開啟http://192.168.31.69:8080, 開啟Jenkins管理介面

Dashboard - 新建任務,選擇“構建一個自由風格的軟體專案” 

這裡暫且命名為test

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 在原始碼管理中填寫Git倉庫地址,並且填寫正確的鑑權資訊

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 在構建中新增一個“執行 shell” 步驟

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 在命令中輸入以下內容

sudo docker build -f ./sample/MainHost/Soa.GatewaySample.Web.Host/Dockerfile -t 192.168.31.69:5000/soasampleauthorizedservicehost --no-cache --target final ./
sudo docker push 192.168.31.69:5000/soasampleauthorizedservicehost
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

這些命令將在構建時,在原始碼拉取後執行

  1. 將指定 ./sample/MainHost/Soa.GatewaySample.Web.Host/Dockerfile構建映象,並命名為192.168.31.69:5000/soasampleauthorizedservicehost
  2. 將192.168.31.69:5000/soasampleauthorizedservicehost映象推送至私有docker倉庫

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

  至此搭建CI/CD伺服器工作結束。

測試和釋出

返回Dashboard,在test專案下選擇“立即構建”

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

等待構建成功

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 再次開啟 http://192.168.31.69:8081, 開啟Docker倉庫管理頁面,可以發現釋出時間已更新

[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 至此部署工作結束。

在客戶機上需要安裝Docker並且配置好IP地址,當然CI/CD伺服器需要對映到一個公網IP地址上,以便客戶的伺服器拉取映象

[Service]
ExecStart=/usr/bin/dockerd --insecure-registry [CI/CD伺服器地址]
[學習筆記]使用Docker+Jenkin自動化流水線釋出.Net應用

 

 


相關文章