asp.net core結合Gitlab-CI實現自動化部署

GitLab ASP.NETCore · 發表 2018-09-26 19:53:00

摘要： 0、目錄整體架構目錄：ASP.NET Core分散式專案實戰-目錄一、前言在之前的文章中寫過k8s+Jenkins+GitLab-自動化部署asp.net core專案的topic，這次講解一下gitlab-ci的CI/CD，說實話，自...

0、目錄

整體架構目錄： ofollow,noindex"> ASP.NET Core分散式專案實戰-目錄

一、前言

在之前的文章中寫過 k8s+Jenkins+GitLab-自動化部署asp.net core專案的topic，這次講解一下gitlab-ci的CI/CD，說實話，自動化部署是在是非常的舒服，而且gitlab-ci很適合中小專案的部署，大專案推薦使用k8s。

閱讀目錄：

1、gitlab-ci及gitlab-runner說明

2、部署環境介紹

3、安裝gitlab和gitlab-runner

4、asp.net core專案配置

二、Gitlab-CI及Gitlab-Runner說明

1、GitLab-CI

即GitLab上的CI功能，持續整合功能

可以實現程式碼提交後自動測試、編譯、釋出、部署等自動化工作

持續整合是一種軟體開發實踐，即團隊開發成員經常整合它們的工作，通過每個成員每天至少整合一次，也就意味著每天可能會發生多次整合。

2、GitLab-Runner

GitLab在接收到程式碼提交事件時，通過.gitlab-ci.yml的配置資訊與對應節點上的runner進行互動。

Runner需要在CI上進行註冊後方可使用。

Runner相當於代替人工在安裝了Runner的伺服器上執行yml檔案上的配置。通常由GitLab上的專案更新觸發。

三、環境介紹

IP（CentOS7）	元件
192.168.161.140	gitlab、Docker
192.168.161.142	gitlab-runner、Docker、git、dotnet sdk

四、安裝gitlab和gitalb-runner

0、Docker安裝的命令請看我之前寫的文章

傳送門： Docker系列之CentOS7安裝Docker（一）

1、在140這臺伺服器上在Docker上執行gitalb

此gitlab由於是測試，因此沒有進行資料的掛載，在生產環境中需要用到資料的掛載。

命令如下：這邊要注意一下 gitlab需要用到22埠，而CentOS伺服器ssh連線也是用22埠，因此需要讓gitalb使用。具體操作可以看： CentOS伺服器安裝Telnet來遠端連線伺服器

docker run --detach --hostname localhost --publish 443:443 --publish 80:80 --publish 22:22 --name gitlab --restart always gitlab/gitlab-ce:latest

這樣即可執行成功

2、在142伺服器上安裝git

在gitalb-ci.yml 檔案中我有用到git 來進行拉取程式碼到本地伺服器上的。

命令：

yum install -y git

3、在伺服器上安裝dotnet SDK

gitlab-ci.yml檔案中git拉取完程式碼後需要把程式碼進行編譯、釋出出來，因此需要用到dotnet sdk。

在安裝.NET之前，您需要註冊Microsoft金鑰，註冊產品儲存庫並安裝所需的依賴項。這隻需要每臺機器完成一次。開啟命令提示符並執行以下命令：

sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpm

安裝.NET SDK，更新可用於安裝的產品，然後安裝.NET SDK。在命令提示符中，執行以下命令：

sudo yum update 
sudo yum install libunwind libicu 
sudo yum install dotnet-sdk-2.0.0

4、現在可以在伺服器上安裝gitlab-runner了

安裝gitlab-runner的方式很多，有使用gitlab儲存庫的，以及手動安裝，具體的可以參考官方給出的方案，這邊我採用手動安裝gitlab-runner

下載二進位制檔案

# Linux x86-64
sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64

賦予許可權：

sudo chmod +x /usr/local/bin/gitlab-runner

建立gitlabCI使用者：

sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

安裝並作為執行服務：

sudo /usr/local/bin/gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo /usr/local/bin/gitlab-runner start

5、現在就開始註冊我們的gitlab-runner啦

註冊runner需要配合我們的gitlab來操作。

第一步：我們先開啟一下我們的gitlab，切換到我們的Runners欄目

在這裡我們可以看到一個是 url和token，這兩個內容是我們必須的。

第二步：切換回我們的伺服器上

執行命令註冊：

gitlab-runner register

接下來要填寫的資訊比較多，具體請看下面的內容。

注：第一個和第二個不要寫錯了，直接複製即可。

註冊完成後即可在gitlab Runners 中可以看到

第三步：點選修改一下 runner

把此欄目的勾選一下，否則在自動化部署時專案無法監測到runner的存在，除非專案上傳的時候帶上tag標籤。

然後我們選擇一下此runner 掛鉤的專案。我們選擇專案，點選後面的 “Enable”即可。

到目前為止gitlab配置完成，現在配置一下asp.net core專案吧

五、asp.net core專案配置

注：我已經把專案程式碼上傳到github上，可供下載： gitlabci

1、建立一個asp.net core webapi專案

在專案中新增 .gitlab-ci.yml 檔案，該檔案是用來配置Runner對當前專案進行的操作。

variables:
GIT_STRATEGY: none
stages:
- test
test_job:
stage: test
only: 
- master
script:
- cd /home/gitproject
- rm -rf /home/gitproject/gitrunner
- git clone http://root:[email protected]/Team/gitrunner.git
- cd ./gitrunner
- dotnet build --configuration Release 
- rm -rf /home/project/gitrunner
- docker stop gitci
- docker rm gitci
- docker rmi gitciimages
- dotnet publish -c Release --output /home/project/gitrunner
- cd /home/project/gitrunner
- docker build -t gitciimages .
- docker run -d -v /home/project/gitrunner:/code -p 5001:80 --name gitci --restart always gitciimages

具體的引數說明可以參考 gitlab官網給出的。 gitlab-ci.yml 配置

2、當然在專案裡面也需要 Dockerfile檔案

Dockerfile，並且把Dockerfile檔案設定為始終複製，不然在釋出的過程中會丟失檔案。

FROM microsoft/aspnetcore
COPY . /code
WORKDIR /code
EXPOSE 5001
CMD ["dotnet","gitlabcicd.dll"]

3、現在我們就可以使用 git上傳程式碼啦

上傳後我們就可以在 gitlab Commits裡面檢視啦

進入執行檢視

4、自此即可在我們的142伺服器上的docker 檢視到我們所執行的容器啦。

六、總結

上面的runner安裝之前講解了一種，其實還有很多種，具體可以看一下官方給出的案例。

到目前為止發現自動化部署是在是太方便了。有gitlab- CI/CD、以及k8s CI/CD，當然還有gitlab結合jenkins CI/CD，有興趣的同學可以看看我之前的文章。歡迎給我留言

注：我已經把專案程式碼上傳到github上，可供下載： gitlabci

參考文件

官方文件：https://docs.gitlab.com/runner/install/linux-repository.html

註冊runner：https://docs.gitlab.com/runner/register/index.html

gitlab-ci.yml 配置：https://docs.gitlab.com/ee/ci/yaml/README.html#only-and-except-simplified

DotnetSDK：https://www.microsoft.com/net/download/linux-package-manager/centos/sdk-2.0.0

asp.net Core 交流群： 787464275 歡迎加群交流

如果您認為這篇文章還不錯或者有所收穫，您可以點選右下角的【推薦】按鈕精神支援，因為這種支援是我繼續寫作，分享的最大動力！

作者：LouieGuo