.net猿遇到了小鯨魚，覺得越來越興奮。本來.net猿只是在透過家里那田子窗看外面的世界，但是看著海峽對(duì)岸的蘋果園越來越茂盛，實(shí)在不想再去做一只宅猿了。于是，.net猿決定搭上小鯨魚的渡輪到蘋果園去看看。

.net猿上了小鯨魚渡輪就先問了一個(gè)問題，蘋果園上有能用來編寫c#代碼的和Visual Studio一樣強(qiáng)大的IDE么？這時(shí)，天空閃過一道Gamma射線，艾瑞克神說，給你一個(gè) Visual Studio Code，去玩吧。于是.net猿搭這小鯨魚的快船順利的抵達(dá)了蘋果山，開始了他的吃蘋果之旅。

… … 小編只能憋出來這么多了，還是來干貨吧。

---

今天，我們來看看如何在macOS上使用 Visual Studio Code 開發(fā) Asp.net Core 應(yīng)用，并使用Docker來進(jìn)行開發(fā)調(diào)試和部署。之前在使用 Visual Studio 的時(shí)候，我們看到了良好的集成性，IDE把所有的工具鏈全部配置好了，你要做的只是F5就可以了，今天我們來嘗試一下手工編寫Dockerfile和Docker-Compose文件。另外，既然要開源，我們就徹底一點(diǎn)，這次我們不再使用sqlite或者sql server作為數(shù)據(jù)庫，而采用開源界最流行的mysql作為我們應(yīng)用的后臺(tái)數(shù)據(jù)庫。

準(zhǔn)備開發(fā)環(huán)境

首先我們需要下載和安裝幾個(gè)工具

1. Visual Studio Code 和 .Net Core

Visual Studio Code 是微軟為廣大開發(fā)人員提供的免費(fèi)開源的跨平臺(tái)代碼編輯器，和其它流行的代碼編輯器，如：Sublime, Atom一樣，它非常小，運(yùn)行速度快，同時(shí)通過各種插件支持不同開發(fā)語言的編寫。不同的地方在于，VSC的插件不僅僅提供靜態(tài)的語言高亮，自動(dòng)語法檢測(cè)和完成功能外；還提供更加高級(jí)的編譯器服務(wù)支持，這使得VSC可以在一定程度上替代IDE的功能，進(jìn)行代碼的編譯，調(diào)試和發(fā)布操作。

下載地址：https://code.visualstudio.com
（同樣大家可以在公眾號(hào)中輸入d4dtools獲取最新版本的code安裝包，提供Windows/Mac/Linux不同版本）

Asp.net Core 是一個(gè)跨平臺(tái)的 asp.net 開發(fā)環(huán)境，可以通過以下地址下載macOS上的安裝包

下載地址：http://dot.net

注：如果你之前安裝過asp.net 5或者 rc版的.net core，需要在運(yùn)行以上安裝命令之前先卸載，在d4dtools網(wǎng)盤中下載 dotnet-uninstall-pkgs.sh，運(yùn)行即可。

2. Node.JS和NPM，以及 bower, gulp 和 grunt 等前端工具

Node.js是一個(gè)javascript的運(yùn)行引擎，提供服務(wù)端的javascript運(yùn)行能力，同時(shí)也包含了npm這個(gè)包管理器，可以用來安裝 bower, glup，grunt等前端工具。

下載地址：http://nodejs.org
(d4dtools中包含v4.4.7 LTS安裝包的Windows和Mac版本）

安裝完成后，讓通過以下命令安裝前端工具

npm install bower gulp grunt-cli -g

3. 安裝項(xiàng)目模版生成工具 yeoman 和 asp.net generator

YEOMAN是用來創(chuàng)建項(xiàng)目模版的工具，用慣了Visual Studio的開發(fā)人員一定都很喜歡新建項(xiàng)目的引導(dǎo)工具，選擇自己要用的項(xiàng)目類型就可以創(chuàng)建出一個(gè)可運(yùn)行的基本項(xiàng)目框架，這讓啟動(dòng)一個(gè)項(xiàng)目或者學(xué)習(xí)編程都變的非常容易。Yeman提供了同樣的功能。

運(yùn)行以下命令就可以完成yeoman的安裝

npm install yo -g

在yeoman中提供了不同的generator（模版生成器）來提供不同類型的項(xiàng)目的生成，為了能夠生成asp.net core應(yīng)用，我們需要安裝aspnet generator

npm install generator-aspnet -g

安裝好以后就可以創(chuàng)建項(xiàng)目了

你也可以自己創(chuàng)建generator，可以參考 aspnet generator 的 github 源代碼來學(xué)習(xí)。
https://github.com/omnisharp/generator-aspnet

4. Docker for Mac

與 Docker for Windows 一樣，我們可以在macOS上安裝Docker for Mac來支持Docker環(huán)境的管理。

下載地址：https://www.docker.com/products/docker
(d4dtools網(wǎng)盤：Docker.dmg）

至此，我們的開發(fā)環(huán)境就準(zhǔn)備完畢了。

創(chuàng)建asp.net core webapp

使用以上這些工具，我們就可以很順暢的建立應(yīng)用程序了

1. 創(chuàng)建項(xiàng)目模版

首先創(chuàng)建一個(gè)應(yīng)用目錄，源代碼目錄

mkdir aspnet-mysql cd aspnet-mysql mkdir src

然后進(jìn)入src目錄使用yoman創(chuàng)建項(xiàng)目

cd src yo aspnet

選擇 Web Application [without Membership and Authorization]作為項(xiàng)目類型，Bootstrap作為前端框架，并給出應(yīng)用名稱aspnet-mysql

回車后，yeoman創(chuàng)建項(xiàng)目中的代碼文件結(jié)構(gòu)，并運(yùn)行 bower install 完成所需要的javascript/css的安裝

然后運(yùn)行以下命令，完成asp.net的nuget依賴包安裝

cd aspnet-mysql dotnet restore

最后，鍵入以下命令打開 Visual Studio Code

code .

這時(shí)，VSC會(huì)自動(dòng)生成以下配置文件，用于配置VSC中的開發(fā)調(diào)試工具鏈

.vscode/launch.json .vscode/task.json

現(xiàn)在，你就可以切換到調(diào)試視圖，并點(diǎn)擊運(yùn)行按鈕開始調(diào)試你的應(yīng)用了，你也可以在代碼中設(shè)置斷點(diǎn)，像在Visual Studio中一樣進(jìn)行單步調(diào)試，查看變量數(shù)值的變化。

2. 創(chuàng)建mysql容器作為開發(fā)數(shù)據(jù)庫

數(shù)據(jù)庫的開發(fā)一般會(huì)要求我們先安裝一個(gè)數(shù)據(jù)庫引擎在自己的機(jī)器上，現(xiàn)在使用docker，我們可以在容器中運(yùn)行一個(gè)數(shù)據(jù)庫引擎。這樣做有很多好處，1）自己的機(jī)器可以很干凈，不用擔(dān)心各種程序之間互相沖突；2）數(shù)據(jù)庫隨用隨開，不用的時(shí)候就關(guān)掉，不必占用資源；3）可以每次都用干凈的數(shù)據(jù)庫進(jìn)行調(diào)試，不用操心恢復(fù)數(shù)據(jù)狀態(tài)；如果需要的話，也可以把容器中的數(shù)據(jù)卷內(nèi)容同步到本機(jī)上。

要這樣做，首先你需要一臺(tái)容器化主機(jī)，可以參考本系列第二篇 《docker4dotnet ＃2 容器化主機(jī)》中的做法

這里我使用了一臺(tái)運(yùn)行在本地的vmwarefusion中的docker主機(jī)

首先通過以下命令將docker命令重定向到這臺(tái)主機(jī)中

eval $(docker-machine env {machine-name})

運(yùn)行以下命令啟動(dòng)一臺(tái)mysql數(shù)據(jù)庫容器，創(chuàng)建一個(gè)叫做ef的數(shù)據(jù)，并將3306端口暴露給本地環(huán)境

docker run --name mysql-dev -e MYSQL_ROOT_PASSWORD=P2ssw0rd -e MYSQL_DATABASE=ef -p 3306:3306 -d mysql

參數(shù)說明：

• name: 給容器起個(gè)名字叫做mysql-dev，這樣便于后邊管理用，如果不給名字的話docker會(huì)給一個(gè)隨機(jī)名字

• -e: 配置容器的環(huán)境變量，這里我配置了

• • MYSQL_ROOT_PASSWORD ： root用戶密碼

  • MYSQL_DATABASE: 新數(shù)據(jù)庫名稱，mysql容器會(huì)按照要求創(chuàng)建一個(gè)ef為名稱的空數(shù)據(jù)庫

• -p: 暴露端口，將3306端口暴露出來，便于管理

如果你本地沒有mysql的鏡像，docker會(huì)到docker hub去下載，如果已經(jīng)有了鏡像那么啟動(dòng)真的是毫秒級(jí)的，啟動(dòng)完成后你就可以使用管理工具連接到這個(gè)容器上，這里我用的MySQL Workbench

你可以看到 ef 數(shù)據(jù)庫已經(jīng)創(chuàng)建好了。

3. 配置asp.net應(yīng)用使用mysql作為Entity Framework數(shù)據(jù)源

默認(rèn)的asp.net 應(yīng)用程序在Windows上使用sql server或者localdb作為數(shù)據(jù)源，在非windows系統(tǒng)上使用的是sqlite。這里，localdb和sqlite都只能作為開發(fā)調(diào)試用途，如果需要投入生產(chǎn)就需要使用sql server，對(duì)應(yīng)到開源產(chǎn)品，我們可以選用mysql作為sql server的替代品。在上一步中我們已經(jīng)配置好了用于開發(fā)的mysql服務(wù)器（容器），現(xiàn)在我們需要對(duì)應(yīng)用程序進(jìn)行配置，讓Entity Framework可以使用mysql作為數(shù)據(jù)源。

這里，我們使用的是由國(guó)內(nèi)開發(fā)人員貢獻(xiàn)的開源庫，github地址如下：
https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql

首先在 project.json 文件的 dependencies 配置節(jié)中加入以下引用：

"Pomelo.EntityFrameworkCore.MySql": "1.0.0-prerelease-20160726"

同時(shí)添加一個(gè)nuget.config配置文件，并在里面添加Pomelo的源地址，這主要是因?yàn)檫@個(gè)nuget庫現(xiàn)在還沒有正式發(fā)布，發(fā)布以后就不用進(jìn)行這個(gè)配置了

<?xml version="1.0" encoding="utf-8"?> <configuration><packageSources><add key="NuGet official package source" value="https://nuget.org/api/v2/" /><add key="PomeloMysql" value="https://www.myget.org/F/pomelo/api/v2/"/></packageSources> </configuration>

然后再次運(yùn)行 dotnet restore，這次需要添加 –configfile nuget.config這個(gè)參數(shù)確保dotnet restore可以正確使用nuget源

dotnet restore --configfile nuget.config

4. 添加 MVC Model到項(xiàng)目中

現(xiàn)在我們就可以在項(xiàng)目中創(chuàng)建我們的實(shí)體類了，并且為了演示方便，我在還添加了一些示例數(shù)據(jù)。

代碼文件?https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/Models/Blog.cs

?

然后在starup.cs中的ConfigureServices方法中添加依賴注入代碼

services.AddDbContext(options=>options.UseMySql(Configuration.GetConnectionString("Mysql")));

在Configure方法中調(diào)用SampleData.InitDB來創(chuàng)建示例數(shù)據(jù)

await SampleData.InitDB(app.ApplicationServices);

代碼文件：https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/Startup.cs

在 appsetting.json 中創(chuàng)建名為Mysql的連接字符串

"ConnectionStrings": {"DefaultConnection": "Data Source=aspnetweb01.db","Mysql": "Server={docker machine ip};database=ef;uid=root;pwd=P2ssw0rd;"}

代碼文件：https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/appsettings.json

確保 uid及pwd參數(shù)與docker run命令中的MYSQL_DATABASE，MYSQL_ROOT_PASSWORD一致
[docker machine ip]地址可以通過以下命令獲取

docker-machine ip

現(xiàn)在，再次使用VSC啟動(dòng)應(yīng)用進(jìn)行調(diào)試，你可以看到在mysql中的ef數(shù)據(jù)中Blogs和Users兩個(gè)表已經(jīng)創(chuàng)建并且寫入了示例數(shù)據(jù)。

使用Docker打包發(fā)布應(yīng)用

以上我們已經(jīng)完成了asp.net應(yīng)用的創(chuàng)建，并且使用了一個(gè)運(yùn)行在容器中的mysql進(jìn)行開發(fā)調(diào)試，現(xiàn)在我們需要將這個(gè)應(yīng)用使用docker打包并運(yùn)行在容器中。

1. 創(chuàng)建Dockerfile

使用yoman創(chuàng)建的應(yīng)用本身就已經(jīng)包含了一個(gè)Dockerfile，我們只需要進(jìn)行簡(jiǎn)單修改即可
文件內(nèi)容如下

FROM microsoft/dotnet:latest COPY . /app WORKDIR /app RUN ["dotnet", "restore", "--configfile", "nuget.config"] RUN ["dotnet", "build"] EXPOSE 5000/tcp ENTRYPOINT ["dotnet", "run", "--server.urls", "http://0.0.0.0:5000"]

代碼鏈接：https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/Dockerfile

這個(gè)文件很簡(jiǎn)單，我們來看看它都做了些什么：

• FROM microsoft/dotnet:latest 告訴docker build使用microsoft/dotnet這個(gè)鏡像的最新版作為我們的base image

• COPY . /app 將本機(jī)上Dockerfile所在目錄的所有文件拷貝到容器的/app目錄中

• WORKDIR /app 設(shè)置容器使用/app作為工作目錄，這樣后續(xù)的操作就都在這個(gè)目錄中進(jìn)行

• RUN dotnet restore 和 RUN dotnet build告訴docker build要執(zhí)行dotnet restore和dotnet build兩個(gè)命令，同時(shí)使用nuget.config作為restore的配置文件

• EXPOSE 5000/tcp 暴露5000端口

• ENTRYPOINT [“dotnet”, “run”, “–server.urls”, “http://0.0.0.0:5000”]，設(shè)置容器入口為dotnet run命令，這個(gè)命令將啟動(dòng)我們應(yīng)用

2. 構(gòu)建容器鏡像并運(yùn)行容器

現(xiàn)在，我們就可以運(yùn)行以下命令完成容器構(gòu)建了

docker build -t {image name}.

其中 {image name} 你可以隨便起，我這里用的是ups216/aspnet-mysql，這是我后面要上傳到docker hub上所用的名字

這里在dotnet restore這一步會(huì)比較慢，因?yàn)樾枰螺d所有的依賴包。

注：在日常開發(fā)中，你可以將先用常用包創(chuàng)建一個(gè)自己的base image，替換Dockerfile中的microsoft/dotnet，這樣就不用每次都重新下載包了。

現(xiàn)在鍵入docker images命令就可以看到我們新創(chuàng)建的image了

運(yùn)行

docker run --name aspnet-msyql-dev -p 5000:5000 ups216/aspnet-msyql

你可以看到我們的容器現(xiàn)在也正確連接到了mysql容器的對(duì)外端口上了。在瀏覽器中輸入docker主機(jī)的ip地址：5000端口，我們的應(yīng)用就完全在容器中跑起來了。

在docker ps中看到的2個(gè)容器是這樣的

3. 生產(chǎn)部署打包

以上過程中我們已經(jīng)將應(yīng)用部署到了容器中，并且連接到另外一個(gè)容器中運(yùn)行的mysql服務(wù)。但是，我們這個(gè)連接是通過mysql容器暴露給主機(jī)的端口來連接的，這樣做在開發(fā)過程中會(huì)比較方便，因?yàn)槟憧梢匀萜鞯膶?shí)用工具連接到mysql進(jìn)行操作，但是如果要進(jìn)行對(duì)外發(fā)布就不是個(gè)好主意了。

同時(shí)，我希望能夠?qū)eb應(yīng)用和mysql容器一同部署，形成一個(gè)完整的應(yīng)用部署包。這時(shí)，就需要借助docker-compose來完成了。

首先，我們創(chuàng)建一個(gè)用于生產(chǎn)環(huán)境的配置文件，appsettings.Production.json，內(nèi)容如下：

{"ConnectionStrings": {"DefaultConnection": "Data Source=aspnetweb01.db","Mysql": "Server=db;database=ef;uid=ef;pwd=P2ssw0rd;"},"Logging": {"IncludeScopes": false,"LogLevel": {"Default": "Debug","System": "Information","Microsoft": "Information"}}}

代碼鏈接：https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/appsettings.Production.json

這里我們主要修改了Mysql的連接字符串，使用db作為數(shù)據(jù)庫，并使用ef作為連接用戶。

然后，我們創(chuàng)建一個(gè) docker-compose.yml 文件，內(nèi)容如下：

version: '2'services:db:image: mysqlrestart: alwaysenvironment:MYSQL_ROOT_PASSWORD: P2ssw0rdMYSQL_DATABASE: efMYSQL_USER: efMYSQL_PASSWORD: P2ssw0rdweb:build: .depends_on:- dblinks:- dbports:- "5000:5000"restart: alwaysenvironment:ASPNETCORE_ENVIRONMENT: Production

里面的內(nèi)容基本上可以從字面意思讀懂，這里主要?jiǎng)?chuàng)建了db和web兩個(gè)容器，web容器依賴db容器，并通過db這個(gè)名字鏈接過去，同時(shí)設(shè)置asp.net core的environment環(huán)境變量為Production。

對(duì)應(yīng)以上我們?cè)赼ppsettings.Production.json文件中做的修改，你就可以理解我們通過Production這個(gè)環(huán)境變量配置我們的應(yīng)用去到一個(gè)叫做db的mysql服務(wù)器上鏈接名為ef的數(shù)據(jù)庫，并且使用ef作為用戶名。

現(xiàn)在，你只需要運(yùn)行以下這一個(gè)命令就可以完成這兩個(gè)容器的啟動(dòng)了

docker-compose up

以上代碼都已經(jīng)發(fā)布到我的github上，地址如下：

https://github.com/ups216/aspnet-mysql/

如果你按照本文的第一部分安裝了所有工具，那么你應(yīng)該可以直接用行docker-compose up來啟動(dòng)這個(gè)應(yīng)用；以下我錄制了一段簡(jiǎn)單的視頻(3分鐘)來演示這個(gè)過程。

相關(guān)閱讀：

• docker4dotnet #1 – 前世今生 & 世界你好

• docker4dotnet #2 容器化主機(jī)

• docker – 你應(yīng)該知道的10件事

• DockerCon 2016 – 微軟帶來了什么？?

---

請(qǐng)關(guān)注微信公眾號(hào) 【devopshub】，獲取更多關(guān)于DevOps研發(fā)運(yùn)維一體化的信息

內(nèi)容轉(zhuǎn)載自公眾號(hào)

DevOps 了解更多

總結(jié)

以上是生活随笔為你收集整理的docker4dotnet #3 .net猿和小鲸鱼的苹果山之旅的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。