本文簡要說一下ASP.NET Core 在Docker中部署以及docker-compose的使用 (ASP.NET Core 系列目錄)。 系統環境為CentOS 8 。
一、概述
簡單說一下Docker的幾個概念：
記得上學的時候流行一種安裝操作系統的方式，叫GHOST，大概是這樣的：
進入PE系統打開GHOST軟件，點擊“local”,然后選擇“Partition”,最后選擇“From Image”，選擇一個.gho后綴文件，就開始系統安裝了。
安裝好系統之后，根據自己的需求又安裝了一些常用軟件，然后為了避免下次重裝系統還要安裝這些，可以將現在狀態的系統再次用GHOST備份一下，生成一個.gho后綴的鏡像文件，這個鏡像又可以用來安裝系統。
一個.gho文件可以用來為多台電腦安裝系統，每個被安裝好的系統又可以被備份成一個.gho文件文件。
而類比Docker，有這樣幾個概念：
- Image(鏡像)：有點像.gho后綴的鏡像文件。
- Container(容器)：就像用.gho安裝成功的一個操作系統。
- Repository(倉庫)：存放鏡像的倉庫，像Git一樣可以有公有的倉庫也可以有私有的。微軟的倉庫地址為：
但實際上Docker不是一個操作系統，也不像一個虛擬機一樣，它是要共享宿主的內核的。
而且一般建議一個容器只跑一個進程，不像操作系統那樣可以多進程運行。（雖然也可以通過一些方法在一個Docker容器中跑多個應用，但不建議這樣做。）
二、安裝docker
說明：安裝CentOS 8 選擇了最小安裝，此處就不說了，下面說一下Docker的安裝過程。
- 安裝一些必要的系統工具：
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
- 添加軟件源信息：
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
- 更新 yum 緩存：
sudo yum makecache fast
- 安裝 Docker-ce：
sudo yum -y install docker-ce
- 啟動 Docker 后台服務
sudo systemctl start docker
注意：安裝Docker-ce的時候可能報錯：package docker-ce …… requires containerd.io >= 1.2.2-3, but none of the providers can be installed
是因為containerd.io版本過低，可去下面網站查看新版本：
https://download.docker.com/linux/centos/7/x86_64/edge/Packages
- 下載：
wget https://download.docker.com/linux/centos/7/x86_64/edge/Packages/containerd.io-1.2.6-3.3.el7.x86_64.rpm
- 安裝：
yum -y install containerd.io-1.2.6-3.3.el7.x86_64.rpm
再次執行sudo yum -y install docker-ce安裝即可。
三、Docker的幾個常見命令
- 搜索遠程存儲庫中的鏡像，例如MongoDB的鏡像
docker search mongo
- 拉取倉庫中的鏡像
docker pull mongo
- 列出本地鏡像。
docker images
可以看到本地鏡像中包了mongo鏡像。
- 運行鏡像生成一個容器
docker run --name mongotodocker -p 27088:27017 -d mongo
含義: 用鏡像mongo運行生成一個容器，名字為mongotodocker ，將容器內的端口27017映射到主機的27088端口。-p 指的是端口映射。 -d是說后台運行容器，並返回容器ID；
- 列出所有容器。
docker ps -a
可以看到剛運行起來的容器。
- 停止容器
docker stop mongotodocker
- 刪除容器。
docker rm mongotodocker
- 刪除鏡像
docker rmi mongo
具體每個命令都有一些參數可用，這里只是簡單介紹一下使用方法。具體的文檔網上很多，不一一說明了。
四、注冊Docker賬號
注冊一個賬號（可選項），地址：https://hub.docker.com/ ，可以在上面建自己的倉庫。
五、創建一個ASP.NET Core 項目，生成並運行Docker鏡像
新建一個名為DockerComposeDemo的API項目，直接發布，拷貝發布的文件到CentOS系統中，例如/home/aspcore目錄。並在該目錄新建一個文本文件名為Dockerfile，內容如下：
FROM mcr.microsoft.com/dotnet/core/aspnet:3.0-buster-slim AS base
WORKDIR /app EXPOSE 80 COPY . . ENTRYPOINT ["dotnet", "DockerComposeDemo.dll"]
含義是：引用包含3.0運行時的鏡像，這個鏡像在遠程倉庫中，若本地沒有提前pull下來，會先執行pull操作獲取到本地。然后將工作目錄設為/app ， 拷貝發布的項目文件，設置進程的入口是通過dotnet運行DockerComposeDemo.dll。
執行如下命令：
cd /home/aspcore
docker build -t dockertest .
注意第二行后后面有個'.'不能少。 含義就是按照Dockerfile文件中設置的規則生成名為dockertest的鏡像。
此時執行docker images命令可以看到本地鏡像中已經有了 mcr.microsoft.com/dotnet/core/aspnet:3.0-buster-slim 和 dockertest 兩個鏡像。
運行這個鏡像生成容器：
docker run --name aspdocker -p 8080:80 -d dockertest
生成一個名為aspdocker 的容器，並將容器的80端口映射到主機的8080端口。訪問項目默認提供的controller：http://192.168.183.230:8080/WeatherForecast
可以看到能正常訪問。
六：使用docker-compose
因為一個Docker容器只建議運行一個應用，那么一個項目就可能會存在多個容器被運行，可能包含多個項目、數據庫等，這時候就需要對這些容器進行統一的管理，從構建運行開始到運行后狀態的監控等。
這時候有個簡易的方法就是docker-compose，它可以完成多個Docker的統一管理，包括Docker鏡像構建、容器運行、相關配置以及Docker之間的依賴關系等。
下面舉個簡單例子，這個DockerComposeDemo項目需要搭配一個MongoDB數據庫，這樣除了該項目外還需要一個Docker容器運行MongoDB數據庫。
這時候用docker-compose就方便多了。docker-compose的核心是docker-compose.yml文件，看一下對應這個例子的文件內容：
version: '3.4'
services:
demomvc:
image: thisdemoimage
build:
context: .
dockerfile: Dockerfile
environment:
- ASPNETCORE_DBCONN=mongodb://192.168.183.230:27089
- ASPNETCORE_DBNAME=dockerdb ports: - "5103:80" depends_on: - mongodocker mongodocker: image: mongo ports: - "27089:27017"
在services節點下定義了demomvc和mongodocker兩個服務，一個是ASP.NET Core的項目，一個是MongoDB數據庫。
每個節點下的image參數指定了采用的鏡像名稱，ports指定端口映射。此處的MongoDB設置未涉及持久化，實際使用時要注意設置。
ASP.NET Core的項目的thisdemoimage鏡像是不存在的，下面指定了build方法。當然也可以先創建好鏡像然后在這里使用就像mongo服務的設置一樣。
depends_on表示本服務對另一個服務的依賴，本例中就是ASP.NET Core項目依賴MongoDB項目。
environment用於設置環境變量，作用是什么呢？
有一些設置，比如本例中的數據庫連接，如果將連接字符串寫在了項目中的appsettings.json中，而這個文件被“固化”到鏡像中了，是不能修改的，除非重新生成鏡像，非常麻煩。
所以可以通過這樣的環境變量在外面設置。
將項目引用NuGet包MongoDB.Driver, 修改WeatherForecastController的get方法：
[HttpGet] public IEnumerable<WeatherForecast> Get() { var rng = new Random(); _mongoHelper.InsertOne(new WeatherForecast { Date = DateTime.Now.AddDays(1), TemperatureC = rng.Next(-20, 55), Summary = Summaries[rng.Next(Summaries.Length)] }); return _mongoHelper.FindList<WeatherForecast>(); }
每次都是先插入一條，然后返回所有記錄。這里簡要的寫了一個mongoHelper：
public class MongoHelper { private readonly IMongoDatabase database; public MongoHelper(IConfiguration configuration) : this(configuration["ASPNETCORE_DBCONN"], configuration.GetSection("ASPNETCORE_DBNAME").Value) { } public MongoHelper(string ConnectionString,string DBName) { MongoClient mongoClient = new MongoClient(ConnectionString); database = mongoClient.GetDatabase(DBName); } public List<T> FindList<T>(FilterDefinition<T> filter = null, string collectionName = null) { collectionName ??= typeof(T).Name; filter ??= new BsonDocument(); var collection = database.GetCollection<T>(collectionName); return collection.Find(filter).ToList(); } public void InsertOne<T>(T model, string collectionName = null) { collectionName ??= typeof(T).Name; var collection = database.GetCollection<T>(collectionName); collection.InsertOne(model); } }
連接字符串采用 IConfiguration中的設置。
這里有個不算技巧的技巧，為了方便在非Docker的情況下測試，依然可以在appsettings.json文件中設置MongoDB的連接字符串，當部署到Docker中的時候，通過Docker環境變量配置的連接字符串會覆蓋appsettings.json中的配置。
這是因為在講述IConfiguration的文章中說過，系統是先加載appsettings.json中的設置，后加載環境變量中的設置的，二者的key相同，所以最終會以環境變量中的配置為准。
重新發布項目並將文件拷貝到/home/aspcore目錄，其中的dockerfile文件不變，添加本例中的docker-compose.yml文件。
docker-compose是需要單獨下載安裝的, 執行命令:
sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
如果提示權限錯誤，需執行如下命令：
sudo chmod +x /usr/local/bin/docker-compose
安裝好之后執行 docker-compose --version 驗證是否安裝成功。
都准備好了，執行如下命令：
cd /home/aspcore
docker-compose up
執行成功后訪問 http://192.168.183.230:5103/WeatherForecast 進行測試。
七、Windows下開發
我們都知道，VisualStudio經常“貼心”的幫我們做好多事，例如Git的圖形化操作。對於Docker也是如此。
若要在Windows環境下開發及調試Docker，可按下面步驟完成。
首先需下載並安裝Docker Desktop
頁面上有個圖標：
，點擊下載。安裝
后右下角會有 圖標，右鍵可以做一些設置。
它支持Windows和Linux兩種主機
通過docker version 命令可以看出當前主機類型。也可以右鍵點擊右下角的圖標，有個Switch to ……的選項，可以知道當前主機類型，點擊后切換到另一種類型。
命令切換：C:\Program Files\Docker\Docker\DockerCli.exe -SwitchDaemon
解決方案啟用Docker支持：
新建項目的時候，勾選啟用Docker支持：
已有項目可以右鍵點擊項目，添加Docker支持：
兩種方式都會要求選擇主機類型是Windows還是Linux。
此時Visual Studio幫我們會在項目中添加一個名為Dockerfile的文件：
FROM mcr.microsoft.com/dotnet/core/aspnet:3.0-buster-slim AS base WORKDIR /app EXPOSE 80 FROM mcr.microsoft.com/dotnet/core/sdk:3.0-buster AS build WORKDIR /src COPY ["DockerDemo/DockerDemo.csproj", "DockerDemo/"] RUN dotnet restore "DockerDemo/DockerDemo.csproj" COPY . . WORKDIR "/src/DockerDemo" RUN dotnet build "DockerDemo.csproj" -c Release -o /app/build FROM build AS publish RUN dotnet publish "DockerDemo.csproj" -c Release -o /app/publish FROM base AS final WORKDIR /app COPY --from=publish /app/publish . ENTRYPOINT ["dotnet", "DockerDemo.dll"]
這個文件和上面例子中我們自己創建的優點不同，它包含了4個From，第一個和最后一個和我們自己創建的有點像，只是Visual Studio幫我們自動添加了SDK鏡像的拉取、項目的編譯、項目發布的過程。
這里用到了兩個鏡像，第一個From調用了微軟官方的包含ASP.NET Core 3.0 的運行時版鏡像。第二個From用到了包含.Net Core 3.0的SDK的鏡像，因為我們需要對項目進行生成和發布操作。
通過添加Docker的支持，可以使用Visual Studio開發並將項目自動發布到Docker進行調試。但選擇系統環境為Windows的時候速度很快，選擇Linux的時候由於網絡問題非常慢。網上有臨時的解決方案。
如果多個項目想采用docker-compose管理，在上面添加docker支持的圖中可以看到有一個“容器業務流程協調程序支持”， 添加它就會自動生成一個docker-compose.yml文件。
Docker-Compose主要用於當前主機中的docker的管理，對於多主機的集群管理，就需要Docker Swarm或者Kubernetes了。