使用 dotnet core 和 Azure PaaS服务进行devOps开发（Web API 实例）

Posted 2021-04-16 dotNET跨平台

引子

这一篇文章将用一个完整的实例，给大家介绍如何基于dotnet core（微软.NET的最新版本，支持跨平台，跨设备的应用开发，详情请参考 https://www.microsoft.com/net 开发一个Web API Service，并且利用Azure的PaaS服务来实现部署，以及持续的开发运营（devops）。

这篇文章的难度不高，但会作为一个操作指南，后续很多文章，如果涉及到这块基础工作，都会引用这篇文章。本文所演示的范例代码，可以通过 https://github.com/chenxizhang/dotnetcoreapisample 下载。

1、安装dotnet core SDK

目前的最新版本是2.1.3，你可以根据需要下载到不同的版本，请注意安装SDK，而不是Runtime。

• https://www.microsoft.com/net/download/windows

• https://www.microsoft.com/net/download/linux

• https://www.microsoft.com/net/download/macos

2、安装开发工具 visual studio code

3、创建Web API 项目

在命令行工具中运行 dotnet new webapi –o dotnetcoreapisample

4、运行Web API 项目

即便不做任何修改，在命令行工具中运行dotnet run即可运行这个项目。

在浏览器中访问 http://localhost:5000/api/values 如果你也看到下面的效果，恭喜你，你的项目已经运行成功了。

在命令行中输入 code . 会自动打开Visual Studio Code。如果你打开Controllers目录下面的ValuesController.cs 文件，你可以看到如下代码，跟上面的网页返回结果对照一下，你会觉得现在编写一个Web API 真的非常简单啊。

5、增加数据实体

虽然上面的代码能运行，但我们真正要做的一个Web API服务，是希望能给用户提供创建订单，修改订单，查询订单，甚至删除订单的服务。所以，请先删除掉上面这个ValuesController.cs 文件。我会演示怎么样一步一步地将一个订单服务实现出来。

所有的服务都离不开数据，我们将使用Entity Framework来实现数据层服务。所以我们要先定义订单这个数据接口的实体。

请增加一个目录，Models，然后增加第一个代码文件 Order.cs

namespace dotnetcoreapisample.Models{    using System;    public class Order{        public int Id { get; set; }        public DateTime OrderDate { get; set; }        public int Quantity { get; set; }        public decimal UnitPrice { get; set; }        public string Product { get; set; }

    }

}

6、创建数据服务

光有数据实体是不够的，我们还需要定义一个数据服务，或者也可以成为数据上下文服务。请在Models目录中，再创建下面这样一个类：SampleDbContext.cs

namespace  dotnetcoreapisample.Models{    using System;    using Microsoft.EntityFrameworkCore;    using System.Linq;   
    public class SampleDbContext:DbContext{        public SampleDbContext(DbContextOptions<SampleDbContext> options):base(options){
            
        }        public DbSet<Order> Orders { get; set; }


    }
    
}

7、注入数据服务

dotnet core提供了一种非常好的编程模型，我们可以在程序启动的时候，将必要的数据服务对象注入进去，然后在后续的业务服务中就可以直接使用它。

定位到Startup.cs这个文件，在顶部先添加两个命名空间的引用 using Microsoft.EntityFrameworkCore; 和 using dotnetcoreapisample.Models;

然后在 ConfigureServices 这个方法里面，第一行添加如下代码 services.AddDbContext<SampleDbContext>(_=>_.UseInMemoryDatabase("Sample"));

这句代码的意思是，使用一个在内存中的数据库。作为快速开发和测试目的，这是最方面的。当然，如果你真的想要有一个实际的数据库文件，Entity Framework支持几乎所有的数据源，尤其是对sqlite和SQL Server的支持非常好，请参考 https://docs.microsoft.com/en-us/aspnet/core/data/ef-rp/intro

8、创建Web API 服务

这是最后一步了，请在Controllers目录中增加一个OrderController.cs的文件，代码如下

using Microsoft.AspNetCore.Mvc;using dotnetcoreapisample.Models;using System.Collections.Generic;using System.Linq;namespace dotnetcoreapisample.Controllers{
    [Route("api/[controller]")]    public class OrdersController:Controller{        private SampleDbContext context;        public OrdersController(SampleDbContext ctx){
            context = ctx;
        }

        [HttpGet]        public IEnumerable<Order> Get(){            return context.Orders;
        }

        [HttpGet("{id}")]        public Order Get(int id){            return context.Orders.FirstOrDefault(x=>x.Id == id);
        }

        [HttpPost]        public void Post([FromBody]Order value){
            context.Orders.Add(value);
            context.SaveChanges();
        }

        [HttpPut("{id}")]        public void Put(int id,[FromBody]Order value){            var found = context.Orders.FirstOrDefault(x=>x.Id == id);            if(found!=null){
                found.OrderDate = value.OrderDate;
                found.Product =value.Product;
                found.Quantity =value.Quantity;
                found.UnitPrice =value.UnitPrice;

                context.SaveChanges();
            }
        }

        [HttpDelete("{id}")]        public void Delete(int id){            var found = context.Orders.FirstOrDefault(x=>x.Id == id);
            context.Orders.Remove(found);
            context.SaveChanges();
        }
    }
}

9、运行和测试Web API服务

完成上面的工作后，你就可以通过按下F5键（或者执行dotnet run命令）运行这个项目了。我用Fiddler来模拟用户请求，下面展示了四个不同的脚本。

创建订单

查询订单

此时我们可以看到，系统已经创建了一个订单，编号为1（这是自动编号的）。

修改订单

如果再次查询订单，你可以看到数据已经修改了

删除订单

一切看起来还不错，接下来给大家介绍一下如何采用Azure云平台进行部署，以及通过Azure的PaaS服务实现开发运营一体会（devops）的实践。

10、创建Azure的应用程序服务（App Service）

理论其实并不高深，关键看怎么能有效地实现开发和运维的一体化，很大程度上，这个当然取决于平台和工具，其根本在于要实现智能和自动化。另外，devops会逼迫我们重新对应用架构进行一些思考，模组化和微服务化会成为一个自然而然的选择。这个我在后面会有专门的文章给大家解读。本文先用实例来让大家感受一下。

我这里推荐的平台是微软的Azure云平台，它不仅仅是一个强大的IaaS平台，提供了全球质量保证和安全合规的基础架构服务（计算，网络，存储等），同时更重要的是，它是一个PaaS平台，对于广大的业务应用开发人员来说，使用Azure提供的工具，可以事半功倍地实现devops，将更多精力集中在应用逻辑而不是服务器配置、监测、部署更新等工作上面。

闲话少说，如果你还没有Azure账号，可以申请试用。接下来可以参考我的步骤来看看如何将我们刚才创建的这个Web API项目部署到Azure，并且实现基于代码更新的应用自动发布。

登录到Azure的管理门户后，选择“应用程序服务”，然后添加一个“Web应用”

在接下来的窗口中完成资源配置，请注意，作为测试场景的话，你甚至可以选择免费的一种应用服务计划。这里还可以打开Application Insight（这个目前也是免费的服务）。

配置这个应用服务的部署选择，此时逐渐解开了Azure 作为 devops 平台的面纱了。在下图中可以选择“本地Git存储库”作为部署源

虽然你可以看到很多其他的选项，但本篇文章是入门的，所以不做一一展开。下面我们设置一下部署的凭据。

11、配置和远程部署

回到之前的Visual Studio Code的界面，打开命令行窗口，通过git init 命令初始化本地的git存储库，然后执行git add *和git commit -m 'init' 这两条命令完成初始化提交到本地。最后，通过下面的命令添加远程存储库。

接下来，运行 git push azure master这条命令，此时会弹出一个对话框，请输入上一步创建的用户名和密码，这个提交过程可能会比较长，尤其是第一次。这是因为它不仅仅会将代码上传到代码库，而且后台会启动一系列的操作，来进行编译和部署。下面是在我这边的输出结果。

PS C:	empdotnetcoreapisample> git push azure master
Counting objects: 9, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (7/7), done.
Writing objects: 100% (9/9), 7.90 KiB | 899.00 KiB/s, done.
Total 9 (delta 5), reused 0 (delta 0)
remote: Updating branch 'master'.
remote: Updating submodules.
remote: Preparing deployment for commit id '3adc61d27e'.
remote: Generating deployment script.
remote: Running deployment command...
remote: Handling ASP.NET Core Web Application deployment.
remote: ............................................................
remote:   Restoring packages for D:homesite
epositorydotnetcoreapisample.csproj...
remote:   Restore completed in 755.48 ms for D:homesite
epositorydotnetcoreapisample.csproj.
remote: .....
remote:   Generating MSBuild file D:homesite
epositoryobjdotnetcoreapisample.csproj.nuget.g.props.
remote:   Generating MSBuild file D:homesite
epositoryobjdotnetcoreapisample.csproj.nuget.g.targets.
remote:   Restore completed in 10.36 sec for D:homesite
epositorydotnetcoreapisample.csproj.
remote: .............................................................
remote: Microsoft (R) Build Engine version 15.4.8.50001 for .NET Core
remote: Copyright (C) Microsoft Corporation. All rights reserved.
remote:
remote: ................................................
remote:   dotnetcoreapisample -> D:homesite
epositoryinRelease
etcoreapp2.0dotnetcoreapisample.dll
remote: ...........
remote:   dotnetcoreapisample -> D:localTemp8d546e10a232b37
remote: KuduSync.NET from: 'D:localTemp8d546e10a232b37' to: 'D:homesitewwwroot'remote: Copying file: 'dotnetcoreapisample.deps.json'remote: Copying file: 'dotnetcoreapisample.dll'remote: Copying file: 'dotnetcoreapisample.pdb'remote: Copying file: 'dotnetcoreapisample.PrecompiledViews.dll'remote: Copying file: 'dotnetcoreapisample.PrecompiledViews.pdb'remote: Copying file: 'dotnetcoreapisample.runtimeconfig.json'remote: Finished successfully.
remote: Running post deployment command(s)... remote: Deployment successful. To https://dotnetcoreapisample.scm.azurewebsites.net:443/dotnetcoreapisample.git 37b30a5..3adc61d master -> master

我们可以很清楚地看到代码上传后，触发了一个部署的事件，该部署脚本先会拉取所有依赖的包，然后执行构建，最后将文件复制到指定的一个目录。这种自动化的过程就是devops的基石。当然，现在的dotnet core的平台无关性也给部署带来了极大的便利。

12、查看Web API的运行结果

在完成部署后，我们回到Azure的门户，在应用服务的“部署选项”可以看到已经部署的记录，最新的一次部署被标记为 “活动”状态。

点击某一次部署，还可以看到详细信息

如果我们对于当前这次部署不满意，还可以随时选择其他部署，并且选择“重新部署”操作，这样就可以快速进行应用的回滚。

好了，我们最后可以在浏览中输入 https://dotnetcoreapisample.azurewebsites.net/api/orders ，如果返回一个空白的数组“[]” ，说明这个服务是正常工作的。因为我们使用的是内存数据库，所以每次部署后，都会将数据清空，这就是为什么第一次返回空白数组的原因。

结语

使用Azure的PaaS服务来部署Web 应用，通过简单配置后，开发人员只需要关注代码本身，在本地调试后，将代码推送到Azure，后台将自动进行构建和部署，由于有版本控制，所以随时可以根据需要进行前滚和回滚。基于Azure平台进行应用开发，无缝地融入了devops，可以极大地改善开发和运维流程，提高研发效率和质量。本文只是一个开始，我在后续还会介绍各种不同的场景。

原文：http://www.cnblogs.com/chenxizhang/p/8067824.html

---