持续集成和持续部署Continuous integration and deployment
- 本文内容
将应用的代码发布到 GitHubPublish the app's code to GitHub
断开本地 Git 部署连接Disconnect local Git deployment
创建一个 Azure DevOps 组织Create an Azure DevOps organization
配置 Azure Pipelines 管道Configure the Azure Pipelines pipeline
提交对 GitHub 所做的更改并将其自动部署到 AzureCommit changes to GitHub and automatically deploy to Azure
检查 Azure Pipelines 管道Examine the Azure Pipelines pipeline
- 生成定义Build definition
- 发布管道Release pipeline
其他阅读材料Additional reading

持续集成和持续部署Continuous integration and deployment

本文内容

在上一章中，你为简单源读取器应用创建了一个本地 Git 存储库。在本章中，你将把代码发布到 GitHub 存储库，并使用 Azure Pipelines 构建 Azure DevOps Services 管道。管道支持应用的持续生成和持续部署。对 GitHub 存储库的任何提交都会触发对 Azure Web 应用过渡槽的生成和部署。

在本节中，你将完成以下任务：

将应用的代码发布到 GitHub
断开本地 Git 部署连接
创建一个 Azure DevOps 组织
在 Azure DevOps Services 中创建团队项目
创建生成定义
创建发布管道
提交对 GitHub 所做的更改并将其自动部署到 Azure
检查 Azure Pipelines 管道

将应用的代码发布到 GitHubPublish the app's code to GitHub

打开浏览器窗口并导航到 https://github.com。
单击标头中的 + 下拉列表，然后选择“新建存储库” ：

在“所有者”下拉列表中选择你的帐户，然后在“存储库名称”文本框中输入“简单源读取器” 。
单击“创建存储库”按钮。
打开本地计算机的命令行界面。导航到存储简单源读取器 Git 存储库的目录。
将现有的源远程库重命名为“上游” 。请执行以下命令：

git remote rename origin upstream

添加指向一个 GitHub 上存储库的副本的新源远程库。请执行以下命令：

git remote add origin https://github.com/<GitHub_username>/simple-feed-reader/

将本地 Git 存储库发布到新创建的 GitHub 存储库。请执行以下命令：

git push -u origin master

打开浏览器窗口并导航到 https://github.com/<GitHub_username>/simple-feed-reader/。验证你的代码是否显示在 GitHub 存储库中。

断开本地 Git 部署连接Disconnect local Git deployment

通过以下步骤删除本地 Git 部署。Azure Pipelines（一种 Azure DevOps 服务）既替代又增强了该功能。

打开 Azure 门户，导航到暂存 (mywebapp/staging) Web 应用。通过在门户的搜索框中输入“暂存”，可以快速找到该 Web 应用：

单击“部署中心” 。此时将显示一个新面板。单击“断开连接”以删除上一章中添加的本地 Git 源代码管理配置。单击“是”按钮，确认删除操作。
导航到“mywebapp”应用服务。在此提醒，可使用门户的搜索框快速找到该应用服务。
单击“部署中心” 。此时将显示一个新面板。单击“断开连接”以删除上一章中添加的本地 Git 源代码管理配置。单击“是”按钮，确认删除操作。

创建一个 Azure DevOps 组织Create an Azure DevOps organization

打开浏览器，并导航到 Azure DevOps 组织创建页。
在“选取一个便于记忆的名称”文本框中键入一个唯一名称，形成用于访问 Azure DevOps 组织的 URL 。
选择“Git”单选按钮，因为代码托管在 GitHub 存储库中。
单击“继续” 按钮。片刻后，一个帐户以及一个名为 MyFirstProject 的团队项目随之创建。

打开确认电子邮件，该邮件指示 Azure DevOps 组织和项目已准备就绪，可供使用。单击“启动项目”按钮：

浏览器将打开“.visualstudio.com” 。单击“MyFirstProject”链接，开始配置项目的 DevOps 管道。

配置 Azure Pipelines 管道Configure the Azure Pipelines pipeline

需要完成三个不同的步骤。完成以下三节中的步骤将生成一个可操作的 DevOps 管道。

授予 Azure DevOps 对 GitHub 存储库的访问权限Grant Azure DevOps access to the GitHub repository

展开“或从外部存储库生成代码”可折叠项。单击“设置生成”按钮：

从“选择源”部分中选择“GitHub”选项：

Azure DevOps 需要经过授权才可访问 GitHub 存储库。在“连接名称”文本框中输入“ GitHub 连接” 。例如：

如果对 GitHub 帐户启用了双因素身份验证，则需要个人访问令牌。在这种情况下，单击“使用 GitHub 个人访问令牌授权”链接。有关帮助，请参阅官方 GitHub 个人访问令牌创建说明。只需要存储库范围内的权限。否则，单击“使用 OAuth 授权”按钮。
出现提示时，请登录到你的 GitHub 帐户。然后，选择“授权”，授予对 Azure DevOps 组织的访问权限。如果成功，新的服务终结点随之创建。
单击“存储库”按钮旁边的省略号按钮。从列表中选择“/simple-feed-reader”存储库。单击“选择”按钮。
从“用于手动生成和计划生成的默认分支”下拉列表中选择主分支。单击“继续” 按钮。此时将显示模板选择页。

创建生成定义Create the build definition

在模板选择页的“搜索”框中输入 ASP.NET Core ：

模板搜索结果随即显示。将鼠标悬停在“ASP.NET Core”模板上，然后单击“应用”按钮。
生成定义的“任务”选项卡随即出现。单击“触发器” 选项卡。
单击“启用持续集成”框。在“分支筛选器”部分下，确认“类型”下拉列表设置为“包括” 。将“分支规范”下拉列表设置为“主” 。

这些设置会在将任何更改推送到 GitHub 存储库的主分支时触发生成。持续集成在提交对 GitHub 的更改并自动部署到 Azure 一节中进行测试。

单击“保存并排队”按钮，然后选择“保存”选项：

以下模式对话框随即显示：

使用 \ 的默认文件夹，然后单击“保存”按钮。

创建发布管道Create the release pipeline

单击团队项目的“发布”选项卡。单击“新建管道”按钮。

此时将显示模板选择窗格。

在模板选择页的搜索框中输入应用服务：

模板搜索结果随即显示。将鼠标悬停在“Azure 应用服务的槽部署”模板上，然后单击“应用”按钮。发布管道的“管道”选项卡出现。

单击“项目”框中的“添加”按钮。此时将显示“添加项目”面板：

从“源类型”部分选择“生成”磁贴。此类型允许将发布管道链接到生成定义。
从“项目”下拉列表中选择“MyFirstProject” 。
从“源(生成定义)”下拉列表中选择生成定义名称“MyFirstProject-ASP.NET Core-CI” 。
从“默认版本”下拉列表中选择“最新” 。此选项生成由最新运行的生成定义生成的项目。
使用“Drop”替换“源别名”文本框中的文本。
单击“添加” 按钮。“项目”部分将更新以显示更改。
单击闪电图标以启用持续部署：

启用此选项后，每次有新生成可用时都会进行部署。

右侧随即出现“持续部署触发器”面板。单击“切换”按钮以启用该功能。无需启用“拉取请求触发器” 。
单击“生成分支筛选器”部分中的“添加”下拉列表。选择“生成定义的默认分支”选项。此筛选器使得发布仅针对来自 GitHub 存储库的主分支的生成而触发。
单击“保存” 按钮。在生成的“保存”模式对话框中，单击“确定”按钮。
单击“环境 1”框。右侧随即出现“环境”面板。将“环境名称”文本框中的“环境 1”文本更改为“生产” 。

单击“生产”框中的“1 个阶段、2 个任务”链接：

此时将显示环境的“任务”选项卡。

单击“将 Azure 应用服务部署到槽”任务。其设置显示在右侧的面板中。
从“Azure 订阅”下拉列表中选择与应用服务关联的 Azure 订阅。选择后，单击“授权”按钮。
从“应用类型”下拉菜单中选择“Web 应用” 。
从“应用服务名称”下拉列表中选择“mywebapp/” 。
从“资源组”下拉列表中选择“AzureTutorial” 。
从“槽”下拉列表中选择“暂存” 。
单击“保存” 按钮。
将鼠标悬停在默认的发布管道名称上。单击铅笔图标进行编辑。使用“MyFirstProject-ASP.NET Core-CD”作为名称。

单击“保存” 按钮。

提交对 GitHub 所做的更改并将其自动部署到 AzureCommit changes to GitHub and automatically deploy to Azure

在 Visual Studio 中打开“SimpleFeedReader.sln” 。
在解决方案资源管理器中，打开“Pages\Index.cshtml” 。将 <h2>Simple Feed Reader - V3</h2> 更改为 <h2>Simple Feed Reader - V4</h2>。
按 Ctrl+Shift+B 生成应用。
将该文件提交到 GitHub 存储库。使用 Visual Studio“团队资源管理器”选项卡中的“更改”页，或者使用本地计算机的命令行界面执行以下操作：

git commit -a -m "upgraded to V4"

将主分支中的更改推送到 GitHub 存储库的源远程库：

git push origin master

提交出现在 GitHub 存储库的主分支中：

生成被触发，因为在生成定义的“触发器”选项卡中启用了持续集成：

导航到 Azure DevOps Services 中“Azure Pipelines” > “生成”页面的“已排队”选项卡。队列生成显示触发生成的分支和提交：

生成成功后便会部署到 Azure。在浏览器中导航到应用。请注意，“V4”文本显示在标题中：

检查 Azure Pipelines 管道Examine the Azure Pipelines pipeline

生成定义Build definition

已创建名为“MyFirstProject-ASP.NET Core-CI”的生成定义。完成后，该生成会产生一个包含要发布的资产的 .zip文件。发布管道将这些资产部署到 Azure。

生成定义的“任务”选项卡列出了所使用的各个步骤。有五个生成任务。

还原 — 执行 dotnet restore 命令，还原应用的 NuGet 包。使用的默认包源为 nuget.org。
生成 — 执行 dotnet build —configuration release 命令，编译应用的代码。此 —configuration 选项用于生成代码的优化版本，该版本适合部署到生产环境。例如，如果需要调试配置，请修改生成定义的“变量”选项卡上的“BuildConfiguration”变量。
测试 — 执行 dotnet test —configuration release —logger trx —results-directory <local_path_on_build_agent> 命令，运行应用的单元测试。单元测试在与 */Tests/*.csproj glob 模式匹配的任何 C# 项目中执行。测试结果保存在位于 —results-directory 选项指定的位置的 .trx 文件中。如果任何测试失败，则生成将失败且不会部署。

备注

若要验证单元测试是否运作正常，请修改 SimpleFeedReader.Tests\Services\NewsServiceTests.cs，有意地中断其中一个测试。例如，在 Returns_News_Stories_Given_Valid_Uri 方法中，将 Assert.True(result.Count > 0); 更改为 Assert.False(result.Count > 0);。提交更改并将其推送到 GitHub。生成已触发并失败。生成管道状态更改为“失败” 。还原更改、提交并再次推送。生成成功。

发布— 执行 dotnet publish —configuration release —output <local_path_on_build_agent> 命令，生成包含要部署的项目的 .zip 文件。—output 选项指定 .zip 文件的发布位置。通过传递名为 $(build.artifactstagingdirectory) 的预定义变量来指定该位置。该变量扩展到生成代理上的本地路径，如“c:\agent_work\1\a” 。
发布项目 — 发布由“发布”任务生成的 .zip 文件。任务接受 .zip 文件位置作为参数，这是预定义的变量 $(build.artifactstagingdirectory) 。.zip 文件作为名为“drop”的文件夹发布。

单击生成定义的“摘要”链接，查看具有以下定义的生成的历史记录：