在docker中运行ASP.NET Core Web API应用程序

写字哥 發表於 2016-8-17 21:40:00

在docker中运行ASP.NET Core Web API应用程序

本文是一篇指导快速演练的文章，将介绍在docker中运行一个ASP.NET Core Web API应用程序的基本步骤，在介绍的过程中，也会对docker的使用进行一些简单的描述。对于.NET Core以及docker的基本概念，网上已经有很多文章对其进行介绍了，因此本文不会再详细讲解这些内容。对.NET Core和docker不了解的朋友，建议首先查阅与这些技术相关的文档，然后再阅读本文。
<h1>先决条件</h1>
要完成本文所介绍的演练任务，需要准备以下环境：
<ul>
<li>Visual Studio 2015，或者Visual Studio Code，用于创建ASP.NET Core的Web API应用程序。本文使用Visual Studio 2015</li>
<li>如果使用Visual Studio 2015，则需要安装.NET Core 1.0.0 – VS 2015 Tooling Preview 2。请点击此处安装</li>
<li>Microsoft .NET Core SDK，可以到微软官方网站下载安装</li>
<li>一台装有Ubuntu 14.04.4 LTS的机器，可以是虚拟机。在Ubuntu中安装docker CLI。可以按照docker网站上的步骤进行安装</li>
<li>如果希望在Windows下使用docker，请确保Windows机器满足下面的需求：
<ul>
<li>64位Windows 10 Pro、Enterprise或者Education版本（Build 10586以上版本，需要安装1511 November更新）</li>
<li>在系统中启用Hyper-V。如果没有启用，Docker for Windows在安装过程中会自动启用Hyper-V（这个过程需要重启系统）</li>
</ul>
</li>
</ul>
有关Docker for Windows的内容，我会在另外的文章中介绍。
<h1>演练步骤</h1>
<h2>使用Visual Studio 2015创建一个ASP.NET Core的Web API应用程序</h2>
打开Visual Studio 2015，在新建项目的对话框中选择.NET Core分类下的ASP.NET Core Web Application (.NET Core)项目模板，给项目命名为DockerWebAPI，然后单击确定按钮。
<img style="background-image: none; padding-top: 0; padding-left: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214000468-797277572.png" alt="image" width="886" height="568" border="0">
在New ASP.NET Core Web Application (.NET Core)对话框中，选择Web API，然后点击确定按钮。
<img style="background-image: none; padding-top: 0; padding-left: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214001562-878847683.png" alt="image" width="786" height="613" border="0">
项目成功创建后，在解决方案浏览器中可以看到如下项目结构：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214002843-1983926992.png" alt="image" width="347" height="390" border="0">
在此也不对ASP.NET Core的应用程序结构做过多介绍了。接下来，我们修改一下自动产生的ValuesController，使得GET方法返回当前机器的机器名，如下：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214003796-1933042459.png" alt="image" width="439" height="230" border="0">
 
打开Program.cs文件，在构建WebHostBuilder的连贯方法链中，加入UseUrls调用，以便我们的应用程序可以接受来自任何IP的请求。这就使得应用程序在docker容器中也能接受HTTP请求：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214004750-1660046626.png" alt="image" width="411" height="203" border="0">
OK，编译后，在命令行使用dotnet run运行这个应用程序：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214005671-1710815287.png" alt="image" width="659" height="384" border="0">
打开浏览器，测试一下我们的应用，运行成功：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214007234-505522208.png" alt="image" width="546" height="250" border="0">
<h2>将ASP.NET Core Web API应用程序编译成Docker Image</h2>
首先，进入项目根目录（也就是包含有project.json文件的这个目录），使用dotnet publish命令发布应用程序。这就会把编译后的DLL连同依赖项一起，全部复制到bin/Debug/netcoreapp1.0/publish目录下。此时，使用WinSCP类似的软件，将该目录下的所有内容全部复制到Ubuntu的机器上（当然，如果是在Windows 10下使用Docker，也就不需要这个复制的步骤）。复制完成后，在Ubuntu系统中可以看到所有的这些文件：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214008515-2099196195.png" alt="image" width="982" height="584" border="0">
我们顺便在Ubuntu中测试一下这个应用程序，看ASP.NET Core Web API是否能够在Linux的系统中与Windows下有着相同的用户体验。此时，在这个目录下运行dotnet DockerWebAPI.dll命令（要运行dotnet命令，就需要在Ubuntu中安装.NET Core CLI，也可以到微软官方网站下载安装，但对于本文的演练来说，这一步是不一定需要的），可以看到下面的界面：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214010421-409940141.png" alt="image" width="623" height="423" border="0">
使用curl命令测试一下：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214011765-1533961925.png" alt="image" width="623" height="423" border="0">
测试成功。
接下来，在这个包含有DockerWebAPI.dll文件的目录下，新建一个Dockerfile文件，使用vim或者nano等文本编辑器，输入以下内容（#开头的行为注释行，可以不输入）：
<pre class="brush: text;"># 基于microsoft/dotnet:latest构建Docker Image
FROM microsoft/dotnet:latest

# 进入docker中的/usr/local/src目录
RUN cd /usr/local/src

# 创建DockerWebAPI目录
RUN mkdir DockerWebAPI

# 设置工作路径
WORKDIR /usr/local/src/DockerWebAPI

# 将当前文件夹下的所有文件全部复制到工作目录
COPY *.* ./

# 向外界暴露5000端口
EXPOSE 5000

# 执行dotnet DockerWebAPI.dll命令
CMD ["dotnet", "DockerWebAPI.dll"]</pre>
关于Dockerfile的定义，我们暂不讨论，请参考Docker的官方文档。
仍然在当前目录下，执行以下命令，创建Docker Image：
<pre class="brush: text;">docker build -t daxnet/docker-webapi .</pre>
注意，千万别省略了最后一个点号，它表示采用当前路径的Dockerfile来生成Docker Image。如果是第一次生成，由于需要下载microsoft/dotnet:latest这个Docker Image作为基础Image，所以会比较慢（国内网速原因，你懂的）。如果成功的话，大致可以看到以下画面：
<img style="background-image: none; padding-top: 0; padding-left: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214013156-619625648.png" alt="image" width="849" height="548" border="0">
<h2>在Docker Container中运行ASP.NET Core Web API应用程序</h2>
现在，我们就可以使用docker run来执行刚才产生的Docker Image了。docker run会把Docker Image加载到Docker Container中，然后执行由Dockerfile指定的命令（也就是dotnet DockerWebAPI.dll命令）。docker run的命令如下：
<pre class="brush: text;">docker run -it -p 8080:5000 daxnet/docker-webapi</pre>
在这条命令中：
<ul>
<li>-it参数表示需要提供一个模拟的shell环境，并要求有用户交互功能，这样当我们按下Ctrl+C的时候，就可以停止我们的应用程序</li>
<li>-p 8080:5000参数表示需要将Docker Container的5000端口映射到主机环境的8080端口，也就是客户端可以直接通过8080端口访问我们的应用程序</li>
<li>daxnet/docker-webapi参数指定了需要运行的Docker Image。此处采用默认的latest标签</li>
</ul>
运行后，可以看到如下界面：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214014812-1471019178.png" alt="image" width="849" height="548" border="0">
让我们测试一下，在Linux中使用curl命令调用我们的服务，注意，与之前的测试相比，端口号需要由5000改为8080：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214016625-113192999.png" alt="image" width="849" height="548" border="0">
当然，也可以在另一台机器的浏览器中调用：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214017453-661134725.png" alt="image" width="546" height="250" border="0">
事实上，这时返回的机器名，已经是Docker容器的ID值了：
<img style="background-image: none; padding-top: 0; padding-left: 0; margin: 0; display: inline; padding-right: 0; border-width: 0" title="image" src="https://images2015.cnblogs.com/blog/119825/201608/119825-20160817214018265-1529954738.png" alt="image" width="515" height="135" border="0">
<h1>总结</h1>
本文通过快速地对各个步骤的描述，介绍了使用Visual Studio 2015创建ASP.NET Core WebAPI应用程序，并在Docker中运行该应用程序的方法。有些地方可能描述得不是很清楚，如有疑问欢迎留言讨论。今后争取能够更多地分享Visual Studio 2015、Docker、.NET Core等相关的实践经验。 
来源：https://www.cnblogs.com/daxnet/p/5782019.html

頁: [1]

琼殿技术论坛's Archiver

在docker中运行ASP.NET Core Web API应用程序