作者:陈希章 发表于 2017年12月19日
引子
这一篇文章将用一个完整的实例,给大家介绍如何基于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
这个工具同样是支持跨平台的,请通过下面的地址下载安装:https://code.visualstudio.com/Download
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 options):base(options){
}
public DbSet Orders { get; set; }
}
}
7、注入数据服务
dotnet core提供了一种非常好的编程模型,我们可以在程序启动的时候,将必要的数据服务对象注入进去,然后在后续的业务服务中就可以直接使用它。
定位到Startup.cs这个文件,在顶部先添加两个命名空间的引用 using Microsoft.EntityFrameworkCore;
和 using dotnetcoreapisample.Models;
然后在 ConfigureServices 这个方法里面,第一行添加如下代码 services.AddDbContext
这句代码的意思是,使用一个在内存中的数据库。作为快速开发和测试目的,这是最方面的。当然,如果你真的想要有一个实际的数据库文件,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 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来模拟用户请求,下面展示了四个不同的脚本。
创建订单
我们使用POST方法发起请求,地址是http://localhost:5000/api/orders,然后在请求的正文里面用JSON格式表示一个订单信息
查询订单
我们使用GET方法发起请求,地址也是http://localhost:5000/api/orders,在请求的头部里面设置Content-Type为application/json
此时我们可以看到,系统已经创建了一个订单,编号为1(这是自动编号的)。
修改订单
我们使用PUT方法发起请求,地址是http://localhost:5000/api/orders/1,在请求的正文里面,我将要修改的订单信息用JSON表示,请注意,我将单价从200修改为400
如果再次查询订单,你可以看到数据已经修改了
删除订单
最后,我们可以通过DELETE方法发起请求,给定地址是 http://localhost:5000/api/orders/1 来完成删除一个订单的操作
一切看起来还不错,接下来给大家介绍一下如何采用Azure云平台进行部署,以及通过Azure的PaaS服务实现开发运营一体会(devops)的实践。
10、创建Azure的应用程序服务(App Service)
传统的情况,开发人员(和测试人员)做到上面这一步,工作就算结束了。他们会将代码签入到代码库,然后愉快地打卡下班。接下来的工作是什么呢?运维人员会准备虚拟机,安装必要的软件,然后将代码下载下来,编译之后将得到的文件复制到服务器的某个文件夹,沐浴更衣烧香拜佛之后,很有可能Web服务器能正常地启动起来,如果不能,他们就要顶着巨大的压力,跟开发人员打电话,委婉地要求对方帮忙检查一下问题,但是很可能得到的答复是:你是怎么弄的呢,这个明明在我的机器是跑的好好的?上帝保佑,如果这次部署是成功的,但下次如果要更新一个版本,可能是再一次的痛苦的过程。如果说,在以前的时候我们的软件更新并不频繁,这种痛苦还是可以接受的话,现在随着互联网应用开发模式的兴起,业务需求可能三天两头的变化,如此的开发运营割裂的状况,是远远达不到要求的。这也是业界呼唤有更好的工作方式的一个根本原因,devops也就是这么样兴起的。
理论其实并不高深,关键看怎么能有效地实现开发和运维的一体化,很大程度上,这个当然取决于平台和工具,其根本在于要实现智能和自动化。另外,devops会逼迫我们重新对应用架构进行一些思考,模组化和微服务化会成为一个自然而然的选择。这个我在后面会有专门的文章给大家解读。本文先用实例来让大家感受一下。
我这里推荐的平台是微软的Azure云平台,它不仅仅是一个强大的IaaS平台,提供了全球质量保证和安全合规的基础架构服务(计算,网络,存储等),同时更重要的是,它是一个PaaS平台,对于广大的业务应用开发人员来说,使用Azure提供的工具,可以事半功倍地实现devops,将更多精力集中在应用逻辑而不是服务器配置、监测、部署更新等工作上面。
闲话少说,如果你还没有Azure账号,可以申请试用。接下来可以参考我的步骤来看看如何将我们刚才创建的这个Web API项目部署到Azure,并且实现基于代码更新的应用自动发布。
登录到Azure的管理门户后,选择“应用程序服务”,然后添加一个“Web应用”
在接下来的窗口中完成资源配置,请注意,作为测试场景的话,你甚至可以选择免费的一种应用服务计划。这里还可以打开Application Insight(这个目前也是免费的服务)。
配置这个应用服务的部署选择,此时逐渐解开了Azure 作为 devops 平台的面纱了。在下图中可以选择“本地Git存储库”作为部署源
虽然你可以看到很多其他的选项,但本篇文章是入门的,所以不做一一展开。下面我们设置一下部署的凭据。
完成上面这些配置后,我们回到Web应用的概述页面,你会发现现在多出来一个可以用来远程部署的Git存储库地址,请将这个地址复制下来。
11、配置和远程部署
回到之前的Visual Studio Code的界面,打开命令行窗口,通过git init
命令初始化本地的git存储库,然后执行git add *
和git commit -m 'init'
这两条命令完成初始化提交到本地。最后,通过下面的命令添加远程存储库。
接下来,运行 git push azure master
这条命令,此时会弹出一个对话框,请输入上一步创建的用户名和密码,这个提交过程可能会比较长,尤其是第一次。这是因为它不仅仅会将代码上传到代码库,而且后台会启动一系列的操作,来进行编译和部署。下面是在我这边的输出结果。
PS C:\temp\dotnetcoreapisample> 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:\home\site\repository\dotnetcoreapisample.csproj...
remote: Restore completed in 755.48 ms for D:\home\site\repository\dotnetcoreapisample.csproj.
remote: .....
remote: Generating MSBuild file D:\home\site\repository\obj\dotnetcoreapisample.csproj.nuget.g.props.
remote: Generating MSBuild file D:\home\site\repository\obj\dotnetcoreapisample.csproj.nuget.g.targets.
remote: Restore completed in 10.36 sec for D:\home\site\repository\dotnetcoreapisample.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:\home\site\repository\bin\Release\netcoreapp2.0\dotnetcoreapisample.dll
remote: ...........
remote: dotnetcoreapisample -> D:\local\Temp\8d546e10a232b37\
remote: KuduSync.NET from: 'D:\local\Temp\8d546e10a232b37' to: 'D:\home\site\wwwroot'
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,可以极大地改善开发和运维流程,提高研发效率和质量。本文只是一个开始,我在后续还会介绍各种不同的场景。