详解.NET Core+Docker 开发微服务

.net core发布很久了,因为近几年主要使用java，所以还没使用过.net core，今天正好有一个c#写的demo，需要做成服务，不想再转成java来实现，考虑使用.net core来尝下鲜，目标是开发一个微服务，然后部署到docker swarm集群，供其他应用调用。

环境准备

下载.net core的最新版本2.1.3, 安装后打开命令行验证：

出现下面的输出，就代表安装成功了

dotnet

usage: dotnet [options]
usage: dotnet [path-to-application]

options:
 -h|--help   display help.
 --info   display .net core information.
 --list-sdks  display the installed sdks.
 --list-runtimes display the installed runtimes.

path-to-application:
 the path to an application .dll file to execute.

然后是vs code安装c#插件，

以及安装nuget插件，方便管理扩展。

创建工程

使用dotnet new name创建项目，其中name是项目类型，具体如下：

c:\users\jqpeng>dotnet new --help
使用情况: new [选项]

选项:
 -h, --help   显示有关此命令的帮助。
 -l, --list   列出包含指定名称的模板。如果未指定名称，请列出所有模板。
 -n, --name   正在创建输出的名称。如果未指定任何名称，将使用当前目录的名称。
 -o, --output  要放置生成的输出的位置。
 -i, --install  安装源或模板包。
 -u, --uninstall  卸载一个源或模板包。
 --nuget-source  指定在安装期间要使用的 nuget 源。
 --type    基于可用的类型筛选模板。预定义的值为 "project"、"item" 或 "other"。
 --force    强制生成内容，即使该内容会更改现有文件。
 -lang, --language 根据语言筛选模板，并指定要创建的模板的语言。


模板            短名称    语言    标记
----------------------------------------------------------------------------------------------------------------------------
console application        console   [c#], f#, vb  common/console
class library          classlib   [c#], f#, vb  common/library
unit test project         mstest    [c#], f#, vb  test/mstest
nunit 3 test project        nunit    [c#], f#, vb  test/nunit
nunit 3 test item         nunit-test   [c#], f#, vb  test/nunit
xunit test project        xunit    [c#], f#, vb  test/xunit
razor page          page    [c#]    web/asp.net
mvc viewimports         viewimports  [c#]    web/asp.net
mvc viewstart          viewstart   [c#]    web/asp.net
asp.net core empty        web    [c#], f#   web/empty
asp.net core web app (model-view-controller)  mvc    [c#], f#   web/mvc
asp.net core web app        razor    [c#]    web/mvc/razor pages
asp.net core with angular       angular   [c#]    web/mvc/spa
asp.net core with react.js      react    [c#]    web/mvc/spa
asp.net core with react.js and redux    reactredux   [c#]    web/mvc/spa
razor class library        razorclasslib  [c#]    web/razor/library/razor class library
asp.net core web api        webapi    [c#], f#   web/webapi
global.json file         globaljson       config
nuget config          nugetconfig       config
web config          webconfig       config
solution file          sln         solution

examples:
 dotnet new mvc --auth individual
 dotnet new classlib --framework netcoreapp2.1
 dotnet new --help

开发微服务，可以dotnet new mvc，创建一个mvc项目，然后vs code打开即可。

工程实现

实现就简单了，按部就班coding就可以，和几年前的.net mvc没有本质区别：

新建一个apicontroller,添加一个方法：

public jsonresult search(string tfsid)
 {
  try
  {
  return json(new { success = true, data = pailitaoapi.searchbytfsid(tfsid) });
  }
  catch (exception ex)
  {
  console.writeline(ex.message);
  return json(new { success = false, data = "search failed!" }); ;
  }
 }

然后删掉默认的模板文件，将homecontroler里的代码清理掉，保留index，减小包体积

public string index()
 {
  return "api";
 }

主要代码ok！

docker 镜像编译

按照官方指南，我们编写dockefile，主要是通过microsoft/dotnet:2.1-sdk as build实现编译,通过microsoft/dotnet:2.1-aspnetcore-runtime来运行，具体见下面，注意pailitao.dll需要修改成你项目的名称：

from microsoft/dotnet:2.1-sdk as build
workdir /app

# copy csproj and restore as distinct layers
copy *.csproj ./
run dotnet restore

# copy everything else and build app
copy . ./
run dotnet publish -c release -o out

from microsoft/dotnet:2.1-aspnetcore-runtime as runtime
workdir /app
copy --from=build /app/out ./
expose 80
entrypoint ["dotnet", "appname.dll"]

简单分析：

build时，先dotnet restore

通过dotnet publish -c release -o out 编译release版本dll

然后构建runtime，从build环境将out 目录拷贝出来

然后expose 80端口，设置entrypoint 为‘dotnet appname.dll'

微服务cicd

首先是构建，先将代码放入svn, 在jenkins里新建*模式项目，build里使用build/publish docker image：

然后部署，构建好image后，通过shell执行部署：

docker service rm pailitaoservice
docker service create --name pailitaoservice --replicas 1 --publish 15001:80 192.168.86.8:5000/pailitaoservice

最后，测试下服务：