dotnet core 微服务教程

这个教程主要是对于第一次使用dotnet core开发的同学。

运行环境是在centos 7 ，

使用了docker容器。

即这是一篇运行在linux的docker容器上的微服务的简单应用。

一. 安装.NET SDK

　　安装.NET之前，先安装一些依赖，运行下面的命令

sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpm

　　安装成功后，再安装.NET SDK

sudo yum update　　//对整个系统升级
sudo yum install dotnet-sdk-2.2　　//安装.net sdk

　　检验下是否安装成功

dotnet

二.创建服务

　　运行下面的命令

dotnet new webapi -o myMicroservice --no-https
cd myMicroservice

　　dotnet会创建一个webapi类型的应用。

　　-o ：表示会创建一个名字为myMicroservice的目录

　　--no-https ：表示这个应用运行的时候不需要https证书，这是为了部署时方便

　　cd myMicroservice：表示进入到这个新创建的目录

　　上面的命令运行以后会生成一些文件，这里对部分文件进行讲解：

　　myMicroservice.csproj：定义了这个应用引用 的一些 libraries

　　Startup.cs：包含所有的setting和应用启动时的配置文件

　　Controllers/ValuesController.cs：是一个简单的api

[Route("api/[controller]")]
[ApiController]
public class ValuesController : ControllerBase
{
    // GET api/values
    [HttpGet]
    public ActionResult<IEnumerable<string>> Get()
    {
        return new string[] { "value1", "value2" };
    }
}

三.运行服务

dotnet run

输入：http://localhost:5000/api/Values 浏览效果

四.安装Docker

　　这里得说下，我这个安装的有点曲折，本来准本在win7上直接装windows版的，后来发现得win10才行，没办法，装了个Vmware虚拟机，又想着虚拟机都装了，干脆装个linux吧，然后就下了Centos，然后发现中间使用的时候网络有问题，又各种搜，最后把虚拟机的网络设置设置成了桥接，网络能用了，因为下面有用到y　　um命令，所以必须保证网络可用。

　　这里先把网址给出来，有需要的同学可以看下官网的安装说明(有3中方式，这里只介绍一种yum方式)：docker的Centos安装

　　1.首先安装一些必要的包。yum-utils是用来提供yum-config-manager工具的，devicemapper驱动依赖的是device-mapper-persistent-data 和 lvm2两个包。

　sudo yum install -y yum-utils \
  device-mapper-persistent-data \
  lvm2

　　

　　2.安装稳定的库

sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

　　3.列出库中可用的docker版本，选择版本安装

yum list docker-ce

　　4.安装指定的版本。

sudo yum install docker-ce

　　5.启动并加入开机启动

$ sudo systemctl start docker
$ sudo systemctl enable docker

　　6.检验是否安装成功

docker --version

五.添加Docker元数据(Docker metadata)

　　想要让docker镜像(docker image)运行，你需要一个Dockerfile文件。这个文件中包含怎么把应用打包成镜像的说明。

　　1.进入应用目录

cd myMicroservice

　　2.新增一个Dockerfile

echo . > Dockerfile

　　把下面的内容复制到里面

FROM microsoft/dotnet:2.2-aspnetcore-runtime AS base
WORKDIR /app

FROM microsoft/dotnet:2.2-sdk AS build
WORKDIR /src
COPY myMicroservice.csproj myMicroservice/
RUN dotnet restore myMicroservice/myMicroservice.csproj
WORKDIR /src/myMicroservice
COPY . .
RUN dotnet build myMicroservice.csproj -c Release -o /app

FROM build AS publish
RUN dotnet publish myMicroservice.csproj -c Release -o /app

FROM base AS final
COPY --from=publish /app .
ENTRYPOINT ["dotnet", "myMicroservice.dll"]

六.创建一个Docker镜像

docker build -t mymicroservice .

　　docker build命令使用Dockerfile中的信息建立一个docker镜像

　　-t mymicroservice：把镜像命名为 mymicroservice

　　. :表示Dockerfile在当前目录

列出可用的镜像

docker image ls

七. 运行Docker镜像

执行下面的命令

docker run -it --rm -p : mymicroservice

访问下面的网址：http://localhost:3000/api/values

好了，结束。

以上操作经过验证，如果有问题可以参考网址如下：

https://dotnet.microsoft.com/learn/web/aspnet-microservice-tutorial/run-docker 微软microservice教程

https://docs.docker.com/install/linux/docker-ce/centos/ docker安装教程

https://www.cnblogs.com/yufeng218/p/8370670.html docker安装相关