.Net Core in Docker - 在容器內編譯發佈並運行

原文: .Net Core in Docker - 在容器內編譯發佈並運行

Docker能夠說是如今微服務，DevOps的基礎，我們.Net Core天然也得上Docker。.Net Core發佈到Docker容器的教程網上也有很多，可是今天仍是想來寫一寫。
你搜.Net core程序發佈到Docker網上通常常見的有兩種方案：

• 一、在本地編譯成Dll文件後經過SCP命令或者WinSCP等工具上傳到服務器上，而後構建Docker鏡像再運行容器。該方案跟傳統的發佈很像，麻煩的地方是每次都要打開相關工具往服務器上覆制文件。

• 二、在服務端直接經過Git獲取最新源代碼後編譯成Dll而後構建Docker鏡像再運行容器。該方案免去了往服務器複製文件這步操做，可是服務器環境須要安裝.Net Core SDK 來編譯源代碼。
  自從用了Docker簡直懶的不能自理，我既不想手工複製文件到服務器，也不想在服務器裝.Net Core環境。顯然只要Docker鏡像包含.Net Core SDK環境就能夠在Docker內幫咱們編譯代碼而後運行，這樣連咱們的服務器都不用裝啥.Net Core的環境拉。

  在Docker內編譯發佈.Net Core程序並運行

  新建一個Asp.net Core MVC項目

  咱們使用一個Asp.net Core MVC程序來演示如何發佈到Docker並運行。
  
  使用vs新建一個Asp.net core mvc項目

public class HomeController : Controller
    {
        public IActionResult Index()
        {
            return Content($"Core for docker , {DateTime.Now} , verson 2");
        }
    }

修改HomeController下的index Action，直接輸出一段文字

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
            .UseKestrel(op =>
            {
                op.ListenAnyIP(5000);
            })
            .UseStartup<Startup>();

修改Program下的CreateWebHostBuilder方法，讓Kestrel監聽5000端口

本地運行一下試試

推送源碼到代碼倉庫

把咱們的代碼推送到對應的Git倉庫，方便咱們從部署服務器上直接拉取最新的代碼。

X:\workspace\CoreForDocker>git remote add origin https://gitee.com/kklldog/CoreForDocker.git

X:\workspace\CoreForDocker>git push -u origin master
Username for 'https://gitee.com': xxx@gmail.com
Password for 'https://xxx@gmail.com@gitee.com':
Counting objects: 88, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (83/83), done.
Writing objects: 100% (88/88), 527.07 KiB | 2.43 MiB/s, done.
Total 88 (delta 7), reused 0 (delta 0)
remote: Powered By Gitee.com
To https://gitee.com/kklldog/CoreForDocker.git
 * [new branch]      master -> master
Branch 'master' set up to track remote branch 'master' from 'origin'.

添加Dockerfile文件

在CoreForDocker下新增一個Dockerfile文件，注意沒有任何擴展名。咱們須要基於microsoft/dotnet:latest這個鏡像構建一個新的鏡像。而且在構建的過程當中直接對源碼進行編譯併發布。

FROM microsoft/dotnet:latest
WORKDIR /app
COPY /. /app
RUN dotnet restore
RUN dotnet publish -o /out -c Release
EXPOSE 5000
ENTRYPOINT ["dotnet", "/out/CoreForDocker.dll"]

大概解釋下Dockerfile的意思：
FROM microsoft/dotnet:latest:使用dotnet的最新鏡像，這個鏡像其實對應的應該就是2.2-sdk這個鏡像，裏面包含了dotnet-core 2.2 sdk
WORKDIR /app:指定工做目錄爲app
COPY /. /app：複製宿主機當前目錄的內容到容器的app文件夾
RUN dotnet restore:還原nuget包
RUN dotnet publish -o /out -c Release：編譯併發布程序集到容器的out目錄
EXPOSE 5000:暴露5000端口
ENTRYPOINT ["dotnet", "/out/CoreForDocker.dll"]:容器啓動的時候執行dotnet命令，參數爲/out/CoreForDocker.dll

Dockerfile的文件屬性設置爲始終複製
新建好Dockerfile後git push到代碼倉庫。

在服務器上構建Docker鏡像

這裏以Ubuntu爲例，ssh登陸到服務器後使用git clone命令拉取源代碼。

git clone https://gitee.com/kklldog/CoreForDocker.git

進入源碼目錄

cd CodeForDocker\CodeForDocker

使用docker build命令構建新的鏡像，注意不要忘記最後一個'.'

docker build -t image_code4docker .

運行容器

若是以上步驟都沒有報錯，那麼恭喜你鏡像已經構建成功了，咱們可使用此鏡像運行Docker容器了。

docker run -d --name code4docker -p 5000:5000 -v /ect/localtime:/ect/localtime image_core4docker

使用image_core4docker鏡像運行一個名爲core4docker的容器，綁定宿主機的5000到容器的5000口。其中須要注意的是-v參數映射宿主機的/ect/localtime文件夾到容器的/ect/localtime文件夾，由於通過實踐發現容器中的時區有可能跟宿主機不一致，須要映射宿主機的/ect/localtime讓容器的時區跟宿主機保持一致。

訪問一下服務器的5000端口，發現可以正確返回數據表示咱們的Asp.net Core程序在容器中運行成功了

之後當咱們對源碼進行修改，並提交後，咱們只需在服務器上拉取最新的代碼而後使用docker build，docker run命令來再次生成鏡像並運行容器。可是手工輸入docker build，docker run的命令好像也很麻煩，參數又那麼多，太煩了。

使用shell腳本簡化操做

爲了偷懶不想敲那麼長的命令，咱們能夠構建一個腳本，把命令一次性寫好，之後只要運行一次腳本就能夠了。
使用vim新建一個publish.sh的文件

vim publish.sh

鍵盤上按i進入編輯模式，輸入如下內容

cd CoreForDocker/CoreForDocker
git pull
docker stop core4docker
docker rm core4docker
docker rmi image_core4docker
docker build -t image_core4docker .
docker run --name core4docker -d -p 5000:5000 -v /etc/localtime:/etc/localtime image_core4docker

以上命令，不光有新建鏡像跟運行容器的命令，還有移除原來的容器跟鏡像的命令
按ecs進入命令模式，退出保存

:wq

讓咱們模擬修改一下源代碼，並提交到代碼倉庫

public IActionResult Index()
    {
        return Content($"Core for docker , {DateTime.Now} , version 2");
    }

再次修改homecontroller的index action，輸出內容上新增一個version
ssh登陸到服務器，運行publish.sh文件

/bin/bash publish.sh

跑完以後咱們再次訪問下服務器的5000口，數據返回正確，表示服務器上跑的已是最新的程序了

總結

經過以上演示咱們基本瞭解如何經過git跟docker配合在Ubuntu服務器上不安裝.Net Core SDK來發布.Net Core 程序到容器中運行，而且經過shell腳本的方式再次簡化發佈。可是儘管這樣每次發佈都須要ssh到服務器上而後運行腳本，特別是開發環境可能常常須要發佈，仍是以爲麻煩。有沒有什麼辦法讓咱們push代碼後服務器自動就開始部署最新的代碼的到容器中運行了呢？ 後面我會介紹下如何經過jenkins跟webhook來作CICD。