NET5实践:项目创建-结构概述-程序运行-发布部署 ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

 

1.项目创建

ASP.NET5项目模板有三种:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

新建项目:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

选择模板:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

2.结构概述

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

References对应配置是project.json中:  

  "frameworks": {
    "dnx451": { },
    "dnxcore50": { }
  },

ASP.NET5开发时支持多版本的clr共存,但运行时是使用其中一种。

dnxcore50是跨平台、模块化的coreclr。它有多种,如:dnx-coreclr-win-*,dnx-coreclr-linux-*等。

其它是完整版的,只支持windows的clr。

当然还有一种借助mono的clr。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

wwwroot是web应用程序中的静态文件存储目录,也是web发布后部署时的根目录。

其中web.config是IIS部署时需要的配置文件。

由于ASP.NET5 Web程序是应用MVC6框架,管道是:Area/Controller/Action,不是实际文件路径。

所以要使用静态文件,需要引用依赖:"Microsoft.AspNet.StaticFiles": "1.0.0-rc1-final"

并在Startup.cs中Configure()中开启:app.UseStaticFiles();

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

Dependencies中的Bower和npm是前端开发工具插件。

Bower的使用配置文件是:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

npm插件安装配置文件是:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

当然npm插件使用需要:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

在gulpfile.js上右键,可以调出任务:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署  

关于前端开发工具介绍,在以后的专题中再详细点介绍。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

Controllers是控制器。

Migrations是EntityFramework手动添加迁移生成的。

Models是实体模型类。

Services是功能/业务实现类。

ViewModels是视图模型类。

Views是视图文件。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

appsettings.json是配置文件。比如配置数据库连接字符串。

说一下Startup.cs文件,参见代码注释:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署
namespace MyWeb
{
    public class Startup
    {
        /// <summary>
        /// 构造函数
        /// </summary>
        /// <param name="env">web宿主环境中运行应用程序的信息</param>
        public Startup(IHostingEnvironment env)
        {
        //用于生成应用程序中使用的基于的键/值配置设置 对象创建
            var builder = new ConfigurationBuilder()
                //将 JSON 配置提供程序的路径添加到 configurationBuilder
                .AddJsonFile("appsettings.json")
                //获取或设置的环境的名称,自动设置此属性
                //如果optional为fales时,就不用此设置。
                .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);

            //如果是开发环境
            if (env.IsDevelopment())
            {
                 //http://go.microsoft.com/fwlink/?LinkID=532709
                 builder.AddUserSecrets();
            }

            //添加读取IConfigurationProvider环境变量的配置值
            builder.AddEnvironmentVariables();
            //生成IConfiguration 键和值
            //从提供程序集在IConfigurationBuilder.Providers 注册
            Configuration = builder.Build();
        }

        /// <summary>
        /// 键/值应用程序配置根属性,继承IConfiguration
        /// </summary>
        public IConfigurationRoot Configuration { get; set; }

        /// <summary>
        /// 程序运行时调用此方法来添加一些服务到容器中
        /// </summary>
        /// <param name="services">服务集合</param>
        public void ConfigureServices(IServiceCollection services)
        {
            // Add framework services.
            services.AddEntityFramework()
                .AddSqlServer()
                .AddDbContext<ApplicationDbContext>(options =>
                    options.UseSqlServer(
Configuration["Data:DefaultConnection:ConnectionString"])); services.AddIdentity<ApplicationUser, IdentityRole>() .AddEntityFrameworkStores<ApplicationDbContext>() .AddDefaultTokenProviders(); services.AddMvc(); // Add application services.
// 使用依赖注入 services.AddTransient<IEmailSender, AuthMessageSender>(); services.AddTransient<ISmsSender, AuthMessageSender>(); } /// <summary> /// 配置,通常有些中间件调用需要配置等 /// </summary> /// <param name="app">配置应用程序的请求管道</param> /// <param name="env"></param> /// <param name="loggerFactory">日志中间件</param> public void Configure(IApplicationBuilder app, IHostingEnvironment env,
ILoggerFactory loggerFactory) { loggerFactory.AddConsole(Configuration.GetSection("Logging")); loggerFactory.AddDebug(); if (env.IsDevelopment()) { app.UseBrowserLink(); app.UseDeveloperExceptionPage(); app.UseDatabaseErrorPage(); } else { app.UseExceptionHandler("/Home/Error"); try { using (var serviceScope = app.ApplicationServices
.GetRequiredService<IServiceScopeFactory>().CreateScope()) { serviceScope.ServiceProvider.GetService<ApplicationDbContext>() .Database.Migrate(); } } catch { } } //IIS HttpPlatformHandler 反向代理服务器进行交互的中间件模块 app.UseIISPlatformHandler(options => options.AuthenticationDescriptions.Clear()); app.UseStaticFiles(); app.UseIdentity(); //配置路由 app.UseMvc(routes => { routes.MapRoute( name: "areaRoute", template: "{area:exists}/{controller}/{action}", defaults: new { action = "Index" }); routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); routes.MapRoute( name: "api", template: "{controller}/{id?}"); }); } // Entry point for the application. public static void Main(string[] args) => WebApplication.Run<Startup>(args); } }
NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

3.程序运行

在vs2015开发中,可以用IIS Express直接运行,也可以选择web自宿主托管运行,如图:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

当然,如果不用VS2015来运行,可以使用dnvm中dnx.exe(执行文件在clr里)工具来执行。

dnx.exe执行命令是对应project.json中commands配置:   

  "commands": {
    "web": "Microsoft.AspNet.Server.Kestrel",
    "ef": "EntityFramework.Commands"
  },

进入DOS下,看dnvm能用不?

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署   

VS2015中创建ASP.NET5程序后,就自动安装好dnvm了。

再试一下dnu和dnx工具:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

嘎嘎!不能用。那就执行一下:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

进入项目中project.json文件所在目录,执行dnx web:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

OK!在不shut down情况下,就可以通过http://localhost:5000访问啦。

当然假如发布后,也可以直接执行web.cmd运行的方式。

注:如果运行不成功的话。

一般是依赖包没有下载完整,可以使用dnu restore来安装。

二是使用的clr和project.json配置的框架不一致。

4.发布部署

可以在dos下使用dnu publish命令来发布。这种方式演示就略了。

在VS解决方案中的项目上,右键“Publish Web”:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

选择File System……

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

发布出来的目录(三个文件夹):

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

进入approot目录下,可以执行web.cmd命令脚本运行啦!

通常实际生产时,如何在IIS部署呢? 这里使用windows 10企业版iis测试部署。

先安装iis:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

只需要勾选一下Internet Information Services一项即可!

打开IIS管理器中的“获取新的Web平台组件”:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

如果没有安装,先安装它。这里我在更新vs2015时,已经安装过。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

添加-安装HttpPlatformHandler。

再配置编辑器,修改节:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

并解除锁定节:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

准备工作基本完成啦!添加网站:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

注意:连接权限设置,应用程序池需要改为无托管代码的!

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

测试:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署   

5.小结

本章内容非常简单,我尽可能地截图说明!希望初学者能够学会!

项目创建,傻瓜也会的;

结构概述,这里我也不能说得很清楚,很详细。

程序运行,不管是没发布时如何运行,连发布部署后,也说过啦。

发布部署,这里介绍vs2015上如何发布,也说过常用的IIS部署。

其它方式部署,最好linux或os系统演示啦!以后再补!

读者也可以参见https://get.asp.net/ 。微软做事一向是贴心小棉袄,资料文档整理很不错。

1.项目创建

ASP.NET5项目模板有三种:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

新建项目:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

选择模板:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

2.结构概述

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

References对应配置是project.json中:  

  "frameworks": {
    "dnx451": { },
    "dnxcore50": { }
  },

ASP.NET5开发时支持多版本的clr共存,但运行时是使用其中一种。

dnxcore50是跨平台、模块化的coreclr。它有多种,如:dnx-coreclr-win-*,dnx-coreclr-linux-*等。

其它是完整版的,只支持windows的clr。

当然还有一种借助mono的clr。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

wwwroot是web应用程序中的静态文件存储目录,也是web发布后部署时的根目录。

其中web.config是IIS部署时需要的配置文件。

由于ASP.NET5 Web程序是应用MVC6框架,管道是:Area/Controller/Action,不是实际文件路径。

所以要使用静态文件,需要引用依赖:"Microsoft.AspNet.StaticFiles": "1.0.0-rc1-final"

并在Startup.cs中Configure()中开启:app.UseStaticFiles();

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

Dependencies中的Bower和npm是前端开发工具插件。

Bower的使用配置文件是:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

npm插件安装配置文件是:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

当然npm插件使用需要:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

在gulpfile.js上右键,可以调出任务:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署  

关于前端开发工具介绍,在以后的专题中再详细点介绍。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

Controllers是控制器。

Migrations是EntityFramework手动添加迁移生成的。

Models是实体模型类。

Services是功能/业务实现类。

ViewModels是视图模型类。

Views是视图文件。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

appsettings.json是配置文件。比如配置数据库连接字符串。

说一下Startup.cs文件,参见代码注释:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署
namespace MyWeb
{
    public class Startup
    {
        /// <summary>
        /// 构造函数
        /// </summary>
        /// <param name="env">web宿主环境中运行应用程序的信息</param>
        public Startup(IHostingEnvironment env)
        {
        //用于生成应用程序中使用的基于的键/值配置设置 对象创建
            var builder = new ConfigurationBuilder()
                //将 JSON 配置提供程序的路径添加到 configurationBuilder
                .AddJsonFile("appsettings.json")
                //获取或设置的环境的名称,自动设置此属性
                //如果optional为fales时,就不用此设置。
                .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);

            //如果是开发环境
            if (env.IsDevelopment())
            {
                 //http://go.microsoft.com/fwlink/?LinkID=532709
                 builder.AddUserSecrets();
            }

            //添加读取IConfigurationProvider环境变量的配置值
            builder.AddEnvironmentVariables();
            //生成IConfiguration 键和值
            //从提供程序集在IConfigurationBuilder.Providers 注册
            Configuration = builder.Build();
        }

        /// <summary>
        /// 键/值应用程序配置根属性,继承IConfiguration
        /// </summary>
        public IConfigurationRoot Configuration { get; set; }

        /// <summary>
        /// 程序运行时调用此方法来添加一些服务到容器中
        /// </summary>
        /// <param name="services">服务集合</param>
        public void ConfigureServices(IServiceCollection services)
        {
            // Add framework services.
            services.AddEntityFramework()
                .AddSqlServer()
                .AddDbContext<ApplicationDbContext>(options =>
                    options.UseSqlServer(
Configuration["Data:DefaultConnection:ConnectionString"])); services.AddIdentity<ApplicationUser, IdentityRole>() .AddEntityFrameworkStores<ApplicationDbContext>() .AddDefaultTokenProviders(); services.AddMvc(); // Add application services.
// 使用依赖注入 services.AddTransient<IEmailSender, AuthMessageSender>(); services.AddTransient<ISmsSender, AuthMessageSender>(); } /// <summary> /// 配置,通常有些中间件调用需要配置等 /// </summary> /// <param name="app">配置应用程序的请求管道</param> /// <param name="env"></param> /// <param name="loggerFactory">日志中间件</param> public void Configure(IApplicationBuilder app, IHostingEnvironment env,
ILoggerFactory loggerFactory) { loggerFactory.AddConsole(Configuration.GetSection("Logging")); loggerFactory.AddDebug(); if (env.IsDevelopment()) { app.UseBrowserLink(); app.UseDeveloperExceptionPage(); app.UseDatabaseErrorPage(); } else { app.UseExceptionHandler("/Home/Error"); try { using (var serviceScope = app.ApplicationServices
.GetRequiredService<IServiceScopeFactory>().CreateScope()) { serviceScope.ServiceProvider.GetService<ApplicationDbContext>() .Database.Migrate(); } } catch { } } //IIS HttpPlatformHandler 反向代理服务器进行交互的中间件模块 app.UseIISPlatformHandler(options => options.AuthenticationDescriptions.Clear()); app.UseStaticFiles(); app.UseIdentity(); //配置路由 app.UseMvc(routes => { routes.MapRoute( name: "areaRoute", template: "{area:exists}/{controller}/{action}", defaults: new { action = "Index" }); routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); routes.MapRoute( name: "api", template: "{controller}/{id?}"); }); } // Entry point for the application. public static void Main(string[] args) => WebApplication.Run<Startup>(args); } }
NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

3.程序运行

在vs2015开发中,可以用IIS Express直接运行,也可以选择web自宿主托管运行,如图:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

当然,如果不用VS2015来运行,可以使用dnvm中dnx.exe(执行文件在clr里)工具来执行。

dnx.exe执行命令是对应project.json中commands配置:   

  "commands": {
    "web": "Microsoft.AspNet.Server.Kestrel",
    "ef": "EntityFramework.Commands"
  },

进入DOS下,看dnvm能用不?

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署   

VS2015中创建ASP.NET5程序后,就自动安装好dnvm了。

再试一下dnu和dnx工具:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

嘎嘎!不能用。那就执行一下:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

进入项目中project.json文件所在目录,执行dnx web:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

OK!在不shut down情况下,就可以通过http://localhost:5000访问啦。

当然假如发布后,也可以直接执行web.cmd运行的方式。

注:如果运行不成功的话。

一般是依赖包没有下载完整,可以使用dnu restore来安装。

二是使用的clr和project.json配置的框架不一致。

4.发布部署

可以在dos下使用dnu publish命令来发布。这种方式演示就略了。

在VS解决方案中的项目上,右键“Publish Web”:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

选择File System……

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

发布出来的目录(三个文件夹):

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

进入approot目录下,可以执行web.cmd命令脚本运行啦!

通常实际生产时,如何在IIS部署呢? 这里使用windows 10企业版iis测试部署。

先安装iis:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

只需要勾选一下Internet Information Services一项即可!

打开IIS管理器中的“获取新的Web平台组件”:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

如果没有安装,先安装它。这里我在更新vs2015时,已经安装过。

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

添加-安装HttpPlatformHandler。

再配置编辑器,修改节:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

并解除锁定节:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

准备工作基本完成啦!添加网站:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

注意:连接权限设置,应用程序池需要改为无托管代码的!

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署

测试:

NET5实践:项目创建-结构概述-程序运行-发布部署
ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署   

5.小结

本章内容非常简单,我尽可能地截图说明!希望初学者能够学会!

项目创建,傻瓜也会的;

结构概述,这里我也不能说得很清楚,很详细。

程序运行,不管是没发布时如何运行,连发布部署后,也说过啦。

发布部署,这里介绍vs2015上如何发布,也说过常用的IIS部署。

其它方式部署,最好linux或os系统演示啦!以后再补!

读者也可以参见https://get.asp.net/ 。微软做事一向是贴心小棉袄,资料文档整理很不错。