Gogs+Jenkins+Docker 自動化部署.NetCore

環境說明

---

• 騰訊雲輕量伺服器, 配置 1c 2g 6mb ,系統是 ubuntu 20.14，Docker 和 Jenkins 都在這臺伺服器上面，
• 群暉218+一臺，Gogs 在這臺伺服器上。

Docker安裝

---

• 解除安裝舊的 Docker
  sudo apt-get remove docker docker-engine docker.io containerd runc

• 更新 apt 包索引並安裝包以允許 apt 通過 HTTPS 使用儲存庫

  sudo apt-get update
  
  sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
  

• 新增 Docker 官方的 GPG 金鑰
  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

• 安裝 Docker
  sudo apt-get install docker-ce docker-ce-cli containerd.io

• 通過執行 hello-world 驗證 Docker 是否已正確安裝。輸出 Hello from Docker! 表示安裝成功
  sudo docker run hello-world

• 不同的系統安裝方式可以查閱 docker 官方安裝說明

Gogs安裝

---

Gogs 是一款用 Go 語言開發的輕量級極易搭建的自助 Git 服務。 選擇 Gogs 主要因為它相對於 Gitlab 動則幾個G的內用暫用率來說輕太多了。Gogs 會大大減低系統消耗，跑起來也就佔用100mb記憶體。我的 Gogs 是跑在群暉上面的，效果都是一樣，都是在 Docker 中託管

• 拉取 Gogs 映象
  sudo docker pull gogs/gogs

• 建立 Gogs 檔案掛載路徑
  mkdir -p /var/gogs

• 啟動容器 6022 是 https，6080 是 http，可以通過 docker ps 命令來檢視是否啟動成功。
  docker run -d --name=my_gogs -p 6022:22 -p 6080:3000 -v /var/gogs:/data gogs/gogs

• 容器啟動後通過 http://xxxxxxxx:6080 進行 Gogs 的初始配置
  

• 資料庫型別建議選擇 linux 自帶的 SQLite3 ，支撐十幾個人左右的團隊使用足夠了。域名填寫 Gogs 所在伺服器的域名或者 ip 地址。http 埠號和容器內部埠一致，應用 URL 填寫訪問 Gogs 的域名埠或 ip 埠，點選安裝後註冊一個新使用者登陸即可
  

• Gogs安裝完成後新建一個 Demo 倉庫稍後使用
  

• Gogs 官方文件

Docker中託管.NetCore服務

---

• 新建一個 WebApi 專案
  

• 專案中增加一個 DockerFile 檔案並且簡單配置

# 指定依賴版本
FROM mcr.microsoft.com/dotnet/aspnet:5.0-buster-slim 
WORKDIR /app

COPY . /publish
WORKDIR /publish
# 設定Docker容器對外暴露埠
EXPOSE 80
# 設定時區
RUN /bin/cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \
    && echo 'Asia/Shanghai' >/etc/timezone 
# 程式入口
ENTRYPOINT ["dotnet", "DemoWebApi.dll"]

• 釋出Api服務，如果釋出檔案中沒有 DockerFile 檔案需要手動修改專案檔案，釋出成功後將釋出檔案 copy 到伺服器指定的資料夾中

    <ItemGroup>
        <None Update="Dockerfile">
            <CopyToOutputDirectory>Always</CopyToOutputDirectory>
        </None>
    </ItemGroup>

• 進入伺服器剛 copy 的釋出檔案根路徑下，執行 docker build -t {REPOSITORY}:{TAG} . 命令 通過 DockerFile 來生成 Docker 映象檔案，REPOSITORY 是映象的名字，TAG 是標籤。譬如 docker build -t demo:v1 .
  
  

• 通過 docker images 命令來檢視生成的所有映象
  

• 映象生成成功後就可以通過映象建立並執行容器了。執行 docker run --name demoapi -dp 5009:80/tcp demo:v1 命令建立並執行容器
  -d：後臺執行容器，並返回容器ID；
  -p：指定埠對映，格式為：主機(宿主)埠:容器埠，容器的埠就是你程式啟動的埠，建議直接在專案中寫死。
  -- name：容器名字

• 執行後可以通過 docker ps 檢視所有執行起來的容器狀態，需要檢視所有容器可以使用 docker ps -a 命令
  

• 用 postman 測試一下是否部署成功了
  

• 列舉一些docker常用命令

  • docker restart {容器id} #重啟容器
  • docker start {容器id} #啟動容器
  • docker attach {容器id} # 這樣進入容器退出會導致容器也退出，attach 可以使用者看容器的標準輸出
  • docker attach {容器id} --sig-proxy=false # 加上引數不會導致同期退出
  • docker exec -it {容器id} /bin/bash # 進入容器需要在容器中執行命令需要使用 exec 命令
  • docker logs {容器id} -f # 跟蹤日誌輸出 -f 跟蹤日誌輸出
  • docker rm -f {容器id} # 刪除已經停止的容器
  • docker rmi {REPOSITORY:TAG} # 刪除指定映象
  • docker image prune # 刪除懸空映象，也就是沒有被容器引用的映象

到這裡服務已經在 Docker 完成了託管，但是每次釋出都需要 build 新的映象，然後停止老的容器，在建立一個新的容器，無形中增加了工作量。Jenkins 可以替我們完成這些工作

Jenkins安裝

---

• Jenkins 是依賴 java 的，所以需要安裝 java 的 sdk，這裡選擇 java8
  sudo apt-get install openjdk-8-jdk

• 安裝 LTS 版本的 Jenkins

wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > \
    /etc/apt/sources.list.d/jenkins.list'
sudo apt-get update
sudo apt-get install jenkins

• 檢視執行狀態 systemctl status jenkins 正常會輸出如下內容
  

• Jenkins 預設埠是 8080，安裝成功後通過 http://xxxx:8080 即可訪問，第一步需要先解鎖，管理員密碼會在安裝成功後輸出，也可以通過命令 cat /var/lib/jenkins/secrets/initialAdminPassword
  

• 輸入密碼後進入初始化頁面，選擇安裝推薦外掛
  

• 外掛安裝進度，需要一些些時間
  

• 結束後建立管理賬號登入即可，進入系統管理，選擇外掛管理，搜尋gogs外掛後安裝。
  

• 安裝後需要重啟一下 Jenkins，訪問連結 http://xxxx:8080/restart 後點選重啟，或者通過執行 service jenkins restart 重啟
  

• 為了方便執行指令碼，需要讓 Jenkins 以 root 使用者來執行，編輯檔案 vim /etc/sysconfig/jenkins 或 vim /etc/default/jenkins 取消 JENKINS_USER 註釋，並把值設定成 JENKINS_USER="root" 後修改資料夾許可權

chown -R root:root /var/lib/jenkins
chown -R root:root /var/cache/jenkins
chown -R root:root /var/log/jenkins

• jenkins 常用操作
  • 啟動 service jenkins start
  • 重啟 service jenkins restart 或訪問 http://xxxx:8080/restart
  • 停止 service jenkins stop 或訪問 http://xxxx:8080/exit
  • 重新載入配置檔案 http://xxxx:8080/reload

使用Jenkins自動化

---

• 因為需要在伺服器上 build 專案，所以需要安裝 .NetCore 環境，可以查閱 微軟官方文件 自行安裝

• 把新建的專案推送到 Gogs 倉庫中後點選倉庫高階設定
  

• 選擇 Web 鉤子，新增新 Gogs 的 Web 鉤子
  

• 配置 Web 鉤子，推送地址前面是 Jenkins 的訪問連結，後面 job 名字可以自己定義，選擇只有在 push 的時候觸發鉤子，也可以自己選定事件
  

• 新增後重新點選管理 Web 鉤子，選擇剛才新建的鉤子，點選測試推送來驗證是否正常，丟擲的異常如果是 job 未定義說明鉤子是正常的，如果是其他的異常可以檢視推送地址是否正確，以及 Jenkins 上的 Gogs 外掛是否正確安裝
  

• 回到 Jenkins 頁面，新建一個任務，任務名就是之前 Gogs 裡面的 job 名字，選擇構建自由風格的軟體專案
  

• 新增倉庫配置，Repository URL 是你的倉庫地址，點選新增你的倉庫憑據資訊，最後指定操作的分支
  

• 構建選擇執行shell指令碼，指令碼也可以放在伺服器上這裡呼叫就行，為了方便就直接寫在這裡
  
  

# 判斷是否存在demo映象是否存在
docker images | grep demo &> /dev/null
if [ $? -ne 0 ]
then
   # 不存在不做處理
	echo "not existed demo"
else
    # 如果映象存在預設認為容器也是在執行狀態
	echo "existed demo"
   	# 停止刪除容器和映象
    docker stop demoapi
    docker rm -f demoapi
    docker rmi demo:v1
fi

# 重新build後生成映象並執行容器
cd DemoWebApi/
# 釋出到到指定路徑
dotnet publish -c Release -o /publish
# 進入路徑生成映象後啟動容器
cd /publish
docker build -t demo:v1 .
docker run --name demoapi -dp 5009:80/tcp demo:v1 

• 儲存後點選立即構建驗證一下，如果構建失敗可以在控制檯輸出中檢視詳細構建過程和錯誤資訊
  

• 回到 Gogs 的管理 Web 鉤子頁面重新推送，成功後 Jenkins 會自動構建釋出，之後只要 Push 到 Master 分支就會自動釋出
  
  

總結

---

簡單記錄了自己折騰的全過程，Jenkins 和 Docker 還有很多功能，要在使用過程中慢慢了解。