C# on DevCloud

1 概述

1.1 文章目的

本文通过一个实例介绍如何使用软件开发服务（DevCloud）完成一个C#Web项目的开发。

1.2 项目详情

1. 项目名称：超级冷笑话网站

2. 项目简介：一个Web网站，包含用户登录注册以及浏览笑话等功能的网站。

3. 开发程序语言:ASP.NET MVC5(C#)

4. 项目类型：基于ASP.NET的B/S架构的Web项目

5. 部署环境：Windows + IIS + MySql

6. 部署方式：Ansible部署 + playbook脚本

 

典型的B/S架构系统，用户通过互联网访问系统，客户端处理用户操作及向数据库读取或写入数据。

1.3 主干流程

本文的主干流程为：代码托管、编译构建、发布（软件发布库）、部署。

开发者在本地开发后通过代码托管服务进行版本管理。项目开发到一定程度后可以进行编译构建操作，构建出软件包，通过发布服务进行归档管理。再将软件包部署到服务器上，即可通过外部进行访问。

1.4 前提条件

 1.注册华为云账号：华为云官网注册华为云账号，此账号适用于所有华为云产品。

 2.弹性云服务器：部署将使用带有公网IP的ECS(Windows Sever 2012)。

2 项目管理

2.1 创建项目

新建项目的开发流程包含两种类型：scrum流程、看板流程。Scrum流程是标准的敏捷开发流程，工作项层级为传统的scrum划分方法Epic->Feature->Story->Task&Bug，本项目为把工作划分的层级更清晰，选择了scrum流程。

2.2 创建迭代

本项目研发周期短，只有一次release，划分成三个迭代，迭代周期为一周。

 

2.3 梳理产品需求清单

项目规划是以思维导图的形式将工作项的层级结构展示出来，更直观的看到父子关系，在项目规划中新建工作项后，会自动生成到后面的Epic，Feature，Backlog和迭代页面，在迭代开始前，项目经理将从客户获取的所有需求信息，逐一落实到项目规划中，分解成story，并为工作项设置优先级。

 

3 代码托管

3.1 创建仓库

Ø 新建代码仓库时，选择“模板新建”，在搜索框中输入已经被公开为示例模板的仓库名称，选择该模板。（此处搜索“superjokes”，编程语言选择ASP.NET）

Ø 输入新的仓库名称（可以和模板仓库同名），即可创建代码仓

数据库密码修改：（必做，否则将不会部署成功）

修改在superjokes/src/Joke.Web/App_Data目录下的appsettings.config。将数据库配置处的密码（第33行Password=）改为将要部署的主机上的数据库密码。

4 编译构建

4.1 创建构建任务

Ø 新建任务，在“选择构建模板”界面勾选msbuild，点击确定完成任务模板的创建。跳转至“编译构建任务”界面。

 

Ø 输入构建详细信息

任务描述、源码仓库分支等自行选择。

Ø Msbuild构建

Msbuild构建流程，使用镜像msbuild15-all

输入命令：

命令注解：

由于本代码工程的sln文件路径位于/src目录下，故在命令行中先执行cd src命令。

5 发布

本项目中发布服务可以将构建生成的可执行文件上传到发布仓库，便于软件包管理。

Ø 版本归档

Msbuild构建过程中已经写了对应的压缩指令。

在“上传软件包到发布库（Windows环境）”步骤写明构建包路径、发布版本号及包名后，可以将构建生成的软件包上传到发布仓库，自动进行软件版本管理。

6 部署

部署任务的目的是将构建完成的软件包部署到一个可供我们访问的服务器上，部署成功之后即可通过浏览器访问该地址。

部署任务一共分为四部分，分别是主机授信，编写部署脚本，任务配置，和执行部署。

此时需要一台可供访问的服务器，由于此次部署的Web工程是C#语言编写的，所以服务器需要是一台具有弹性ip地址的Windows服务器。

在主机授信前，需要先对主机环境进行相应配置。

6.1 主机环境配置

1. 安装MySQL。

2. 通过数据库配置脚本在服务器上生成MySQL数据库，数据库配置脚本为位于代码仓库根目录的superjokes.sql。

 

6.2 主机授信

将服务器主机授信到DevCloud里，用于部署网站。

6.3 部署脚本

通过playbook脚本执行powershell命令将项目部署到服务器的IIS服务上。

Ø 获取部署脚本

从代码仓库根目录获取playbook脚本IIS-windows-1.0.zip后上传至DevCloud的playbook管理中。

6.4 任务配置

Ø 新建非模板部署任务。

Ø 填写部署任务名称，“部署设置”选择“Ansible部署”，模板选择“自定义playbook”并选择自己上传的playbook脚本。

 

然后选择部署的服务器，设置端口，选择要部署的软件包及设置网站的默认页面。

 

playbook参数详解：

webapps_path: 软件包部署路径，在目标主机上的路径

app_filename:部署采用的软件包名称

sitePort: 网站端口（提供一个目标主机上可访问的端口号）

SiteName: 网站名称，启动IIS服务时为该网站命名

SiteAppPoolsModel: Integrated 不必修改

managedRuntimeVersion: v4.0 不必修改

WebSitePath:  IIS服务中网站源文件路径

IISLogFile:  IIS服务中的日志存储路径

win_curl_path: 不必修改

6.5 查看部署效果

部署任务执行完成后就可以用http://ip:端口/默认页 访问网站了

 

到此，我们完成了C# web项目在DevCloud上的搭建。