商机网网站源码,长沙有什么好玩的,迷你世界怎么做网站期,广告宣传册制作公司作者#xff1a;陆冬澄、周静
在现代软件研发体系中#xff0c;.NET 平台由于其强大的功能、灵活性和丰富的开发工具#xff0c;成为了构建 Windows 应用程序的热门选择。无论是桌面应用、Web 应用还是服务应用#xff0c;.NET 提供了一系列强大的框架和工具#xff0c;帮…作者陆冬澄、周静
在现代软件研发体系中.NET 平台由于其强大的功能、灵活性和丰富的开发工具成为了构建 Windows 应用程序的热门选择。无论是桌面应用、Web 应用还是服务应用.NET 提供了一系列强大的框架和工具帮助开发者高效的创建高性能、可靠的应用程序。
本文将基于云效 Flow 流水线 Windows 构建环境和云效 Packages Nuget 制品仓库手把手教你如何开发并部署一个 .NET 应用从环境搭建到实战应用发布的详细教程帮助你掌握 .NET 开发的核心技能。
方案架构
本次实战教程中准备了两台机器一台是用于构建的 Windows 构建机需要我们添加到 Flow 流水线中另一台是 Windows Server作为 msdeploy 的对象用于部署 .NET 应用服务。整体架构如下 本方案中用到的示例代码工程如下
https://atomgit.com/oauth2_o72n54/FlowDemoWinhttps://atomgit.com/oauth2_o72n54/PackagesDemo 添加了 using Newtonsoft.Json 依赖。
环境准备
2.1 在 Windows Server 上安装和配置 Web deploy
2.1.1 开启 IIS 服务
IISInternet Information Server服务类似于 Java 的 Tomcat类似于一种容器我们能将我们开发好的 Web 应用部署到 IIS 中。
按照以下流程开启 IIS 打开 Server Manager。 在 Manage 菜单下选择 Add Roles and Features。 选择 Role-based or Feature-based Installation。 在 Server Selection 中选择合适的机器此处可以选择默认的本地机器。 在 Server Roles 中选择 Webserver(IIS)并请务必同时勾选 IIS Management Scripts and Tools、Management Service 和 IIS Management Console 三个选项否则安装 web deploy 时无法看到全部选项。 Features 可以不用选择因为 IIS 不需要额外的 Features。 在 IIS Role Service 中选择想要的设定也可以保留默认设定。 点击 installation 进行安装安装完成后点击 Close 关闭。 2.1.2 安装 Web Deploy 下载 Web deploy 4.0 [ 1] 运行下载的安装程序请注意请务必选择全部安装而非典型安装。如果我们选择自定义安装可以看到以下页面我们需要安装其中的所有组件。如果安装选项比起下图有缺少说明之前安装 IIS 中少安装了 Management 相关组件需要重新 Add Roles and Features。 3.可选通过打开“控制面板”“系统和安全”“管理工具”“服务”来验证 Web 部署是否正确运行然后确保
“Web 部署代理服务”正在运行旧版本中的服务名称不同。“Web 管理服务”正在运行。
如果某个代理服务未运行请重新启动“Web 部署代理服务”。
如果 Web 部署代理服务根本不存在请转到“控制面板”“程序”“卸载程序”查找“Microsoft Web 部署 版本。选择“更改”安装并确保对 Web 部署组件选择“将安装到本地硬盘”。完成更改安装步骤。
2.1.3 安装 ASP.NET Core windows-hosting-bundle
我们需要安装 AspNetCoreModuleV2 来确保服务的顺利启动。如果不安装该组件那么服务启动的时候就会报 500.19 错误。下载 windows-hosting-bundle [ 2] 并运行安装程序。
2.1.4 添加 Web 网站并开启 Web Deploy 发布功能**
打开 IIS 管理器在左侧选择 Add Website。 在打开的 Website 窗口中填写 Site name 和 Physical path然后点击 ok。此处 Site name 填写为 DemoWin。 右键点击刚刚创建的 Web 网站选择 Deploy Config Web Deploy Publishing。 如果没有 Deploy 这一个选项说明之前的 Web Deploy 没有正确安装和运行。
检查弹出页面中的各项参数默认 URL for publishing seriver connection 端口为 8172我们可以保留这个端口也可以修改为其他端口。URL 中的 host name8172 之前的部分可以不用修改在构建机中 deploy 时我们将用 IP 地址代替 host name。 5.可选如果 Windows Server 位于阿里云 ECS我们需要打开防火墙允许外部对于 Server 的 8172、80端口的访问。操作路径到 ECS 控制台 选择实例 Windows Server 对应的实例 安全组 入方向手动添加端口选择 80 和 8172 授权对象选【0.0.0.0/0】。
2.2 配置 Windows 构建机
2.2.1 安装构建工具和发布工具
安装 Visual Studio、Web Deploy 和 Dotnet6.0。注意本处安装 web deploy 时不需要打开 IIS所以安装界面中会比 1.2 中少一些安装选项但这不会影响我们配置构建机。
安装完成后将以下路径添加到 Path 中
C:\Windows\Microsoft.NET\Framework64\v4.0.30319C:\Program Files\IIS\Microsoft Web Deploy V3
dotnet 对应的 path 在安装时已经添加如果没有找到 dotnet可以手动添加
C:\Program Files\dotnet
安装结束以后我们可以到 cmd 中尝试一下 msbuild、msdeploy、dotnet 命令是否成功安装和添加到 Path。
2.2.2 在本地构建 Demo 工程并发布
在配置流水线之前我们可以先在本地尝试是否能成功构建并发布工程。1. 首先我们 Clone Demo 工程代码
git clone https://atomgit.com/oauth2_o72n54/FlowDemoWin构建工程
# mubuild 构建
dotnet msbuild /p:ConfigurationDebug /t:Publish
# /p:ConfigurationDebug 是构建出Debug版本使用 msdeploy将构建出来的内容发布到 Windows Server。
msdeploy -verb:sync -source:contentPathC:\Users\Administrator\source\repos\FlowDemoWin\bin\Debug\net6.0\publish -dest:contentPathDemoWin,computerNamehttps://Windows Server IP:8172/MsDeploy.axd?siteDemoWin,userNameYOURUSERNAME,passwordYOURPASSWORD,authtypeBasic,includeAclsFalse -allowUntrusted -disableLink:AppPoolExtension -disableLink:ContentExtension -disableLink:CertificateExtension -verbose# 上述 Windows Server IP 请替换为 Windows Server 的 IP# -source:contentPath 用于指定需要发布的路径这里的路径是上文中dotnet msbuild以后的output路径
#-dest:contentPath 用于指定目标机器和站点这里我们的站点为DemoWin在浏览器输入 Windows Server 的公网 IP我们可以看到 这说明我们在本地成功构建并发布 Demo 工程。
基于云效 Windows 构建环境和 Nuget 制品仓库实现 .NET 应用持续交付
3.1 在 Flow 中添加 Windows 私有构建机
进入流水线管理页面后点击最左下角的设置然后点击构建集群管理 新建构建集群输入构建集群基本信息后点击确定创建私有构建集群后自动进入构建机的配置页面。 点击接入新节点 选择类型 Windows 复制红框中 Runner 安装命令粘贴到准备好的 Windows 构建机的 powershell 进行执行。 Runner 安装命令执行成功后刷新私有构建集群页面即可看到刚才接入的构建机器。 3.2 配置 Flow 流水线
进入 Flow 首页新建流水线按如下配置编辑流水线配置。
添加流水线源我们可以选择企业公钥连接然后将企业公钥粘贴至代码仓库的 SSH Key 处。
gitatomgit.com:oauth2_o72n54/FlowDemoWin.git添加步骤构建。选择刚才添加的 Windows 构建机选择 Windows 节点然后我们添加一个任务步骤-执行命令然后写入
dotnet msbuild /p:ConfigurationDebug /t:Publish添加步骤部署。创建一个新的任务选择类型为“执行命令”。然后依旧选择上一步中的 Windows 构建机在执行命令中可以填入
# input your command here$PUBLISH_BASE (Get-Item .).FullName | Out-String
$PUBLISH_PATH Join-Path -Path $PUBLISH_BASE.Trim() -ChildPath bin\Debug\net6.0\publish C:\Program Files\IIS\Microsoft Web Deploy V3\msdeploy -verb:sync -source:contentPath${PUBLISH_PATH} -dest:contentPathDemoWin,computerNamehttps://Windows Server IP:8172/MsDeploy.axd?siteDemoWin,userNameYOURUSERNAME,passwordYOUPASSWORD,authtypeBasic,includeAclsFalse -allowUntrusted -disableLink:AppPoolExtension -disableLink:ContentExtension -disableLink:CertificateExtension -verbose# 上述 Windows Server IP 请替换为 Windows Server 的 IP请注意由于 runner 的 Path 可能和 Administrator 用户的 Path 有所不同所以我们可以在这里详细写出 msdeploy 的路径 ‘C:\Program Files\IIS\Microsoft Web Deploy V3\msdeploy’。 保存并执行流水线查看流水线运行进度。 流水线运行成功后打开 Windows Server 中站点我们可以看到应用部署成功。 3.3 使用 Packages Nuget 制品仓库进行依赖管理
将原来的代码源换为 https://atomgit.com/oauth2_o72n54/PackagesDemo 相较于原来的代码该仓库添加了 using Newtonsoft.Json;此时再运行流水线构建任务 msbuild 会失败因为缺少依赖包。
我们可以用云效 packages创建一个 NuGet 制品库来管理二方制品和三方制品。进入云效 Packages 首页新建一个 NuGet 制品仓库。 访问官网 [ 3] 下载依赖的 nuget 包到本地。 按照仓库指南在本地进行配置首先在本地设置仓库凭证然后将刚才从官网下载的 nuget 包 push 到仓库中。此处 SOURCE_NAME 即为仓库地址的后缀名 repo-xxxxx。 推送成功后可以在仓库-包列表中查看包 修改流水线代码源为该仓库添加了 using Newtonsoft.Json
gitatomgit.com:oauth2_o72n54/PackagesDemo.git修改流水线构建任务命令为
# 配置 nuget 仓库凭证
dotnet nuget add source http://yunxiao-poc.devops.aliyuncs.com:80/packages/02e873bb-f911-48ac-ad73-ec2298c5385d/nuget/repo-hzaul/index.json -n repo-hzaul -u xxxxxxxxxxx -p xxxxxxxxx# 拉取 nuget 依赖包
dotnet add package Newtonsoft.Json --source http://yunxiao-poc.devops.aliyuncs.com:80/packages/02e873bb-f911-48ac-ad73-ec2298c5385d/nuget/repo-hzaul/index.json# mubuild 构建
dotnet msbuild /p:ConfigurationDebug /t:Publish保存后运行流水线流水线构建任务即会从 Packages NuGet 制品仓库拉取 Newtonsoft.Json 包完成应用构建。
至此本文即完成了一个 .NET 应用开发环境的搭建、CI/CD 流水线的配置、NuGet 依赖仓库管理等完整流程实践。
相关链接
[1] Web deploy 4.0
https://download.visualstudio.microsoft.com/download/pr/e1828da1-907a-46fe-a3cf-f3b9ea1c485c/035860f3c0d2bab0458e634685648385/webdeploy_amd64_en-us.msi
[2] windows-hosting-bundle
https://dotnet.microsoft.com/zh-cn/download/dotnet/thank-you/runtime-aspnetcore-6.0.20-windows-hosting-bundle-installer
[3] 官网
https://www.nuget.org/packages/Newtonsoft.Json
相关阅读
云效 Flow 私有构建集群
https://help.aliyun.com/zh/yunxiao/user-guide/build-a-cluster
云效 Packages NuGet 制品仓库
https://help.aliyun.com/zh/yunxiao/user-guide/product-management-3
