zoukankan      html  css  js  c++  java
  • 使用 dotnet core 和 Azure PaaS服务进行devOps开发(Web API 实例)

    作者:陈希章 发表于 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。

    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<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来模拟用户请求,下面展示了四个不同的脚本。

    创建订单

    我们使用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:	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,可以极大地改善开发和运维流程,提高研发效率和质量。本文只是一个开始,我在后续还会介绍各种不同的场景。

  • 相关阅读:
    php配置修改后,平滑启动php-fpm
    php-fpm参数调优
    php-fpm 高并发 参数调整 转
    redis分布式锁
    MySQL中group_concat函数 --- 很有用的一个用来查询出所有group by 分组后所有 同组内的 内容
    MySQL中information_schema 数据库 是干什么的
    Mysqldump参数大全 这 些参数 不同于 mysql 的那些参数(下边文章开头有链接) :2 种类型的参数含义是不一样的
    mysql命令行参数 --- 这些参数不同于 mysqldump 后的 那些参数(下边文章开头有链接) :2种类型的参数 含义是不一样的
    not found 什么时候触发
    intellJ svn控制错误
  • 原文地址:https://www.cnblogs.com/chenxizhang/p/8067824.html
Copyright © 2011-2022 走看看