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

Docker可以說是現在微服務，DevOps的基礎，咱們.Net Core自然也得上Docker。.Net Core發佈到Docker容器的教程網上也有不少，但是今天還是想來寫一寫。
你搜.Net core程式發佈到Docker網上一般常見的有兩種方案：

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

• 2、在服務端直接通過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': [email protected]
Password for 'https://[email protected]@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。