使用 Jenkins 和 Team Services 将应用部署到 Linux VM

持续集成 (CI) 和持续部署 (CD) 是一个管道，能够经过它生成、发布和部署代码。 Team Services 针对到 Azure 的部署提供了一组完整的功能完备的 CI/CD 自动化工具。 Jenkins 是一个流行的基于 CI/CD 服务器的第三方工具，也提供 CI/CD 自动化功能。 能够组合使用以上二者来自定义如何提供云应用或服务。

本教程使用 Jenkins 生成一个 Node.js web 应用，并使用 Visual Studio Team Services 将其部署到包含 Linux 虚拟机的部署组。

你将执行如下任务：

• 采用 Jenkins 生成应用
• 为 Team Services 集成配置 Jenkins
• 为 Azure 虚拟机建立部署组
• 建立对 VM 进行配置并部署应用的发布定义

开始以前

• 须要具备对 Jenkins 账户的访问权限。 若是还没有建立 Jenkins 服务器，请参阅 Jenkins 文档。

• 登陆到 Team Services 账户 (https://{youraccount}.visualstudio.com)。 能够获取免费 Team Services 账户。

  Note

  有关详细信息，请参阅链接到 Team Services。

• 在 Team Services 账户中建立我的访问令牌 (PAT)（若是尚没有该令牌）。 Jenkins 须要使用此信息来访问 Team Services 账户。 请参阅如何建立用于 Team Services 和 TFS 的我的访问令牌来了解如何生成该令牌。

获取示例应用

须要部署 Git 存储库中存储的一个应用。 对于本教程，建议使用 GitHub 中提供的此示例应用。

1. 建立此应用的一个分支并记下位置 (URL) 以便在本教程的后续步骤中使用。

2. 使此分支成为公共的以方便在后面链接到 GitHub。

Note

有关详细信息，请参阅建立存储库分支和使专用存储库成为公共的。

Note

此应用是使用 Yeoman 构建的；它使用了 Express、bower 和 grunt；它以某些 npm 程序包做为依赖项。 示例应用包含一组 Azure 资源管理器模板，它们用来为 Azure 上的部署动态建立虚拟机。 Team Services 发布定义中的任务会使用这些模板。 主模板建立一个网络安全组、一台虚拟机和一个虚拟网络。 它分配一个公共 IP 地址并打开入站端口 80。 它还会添加一个标记，部署组会使用该标记来选择要接收部署的计算机。

示例还包含一个用来设置 Nginx 并部署应用的脚本。 它在每台虚拟机上执行。 具体而言，该脚本会安装 Node、Nginx 和 PM2，配置 Nginx 和 PM2，并启动 Node 应用。

配置 Jenkins 插件

首先，必须为 NodeJS 和与 Team Services 的集成配置两个 Jenkins 插件。

1. 打开 Jenkins 账户并选择“管理 Jenkins”。

2. 在“管理 Jenkins”页中，选择“管理插件”。

3. 对列表进行筛选以找到“NodeJS”插件，安装该插件且不重启。

4. 对列表进行筛选以找到“Team Foundation Server”插件并安装它。 （此插件同时适用于 Team Services 和 Team Foundation Server。）不须要重启 Jenkins。

为 Node.js 配置 Jenkins 生成

在 Jenkins 中，建立一个新的生成项目并以下所述对其进行配置：

1. 在“常规”选项卡中，为生成项目输入一个名称。

2. 在“源代码管理”选项卡中，选择“Git”并输入包含应用代码的存储库和分支的详细信息。

   Note

   若是存储库不是公共的，请选择“添加”并提供用于链接到它的凭据。

3. 在“生成触发器”选项卡中，选择“轮询 SCM”并输入计划 H/03 * * * * 以便每三分钟轮询一次 Git 存储库来查询更改。

4. 在“生成环境”选项卡中，选择“提供节点和 npm bin/ 文件路径”并输入 NodeJS 做为 Node JS 安装值。 将“npmrc 文件”保留设置为“使用系统默认值”。

5. 在“生成”选项卡中，输入命令 npm install 以确保更新全部依赖项。

为 Team Services 集成配置 Jenkins

1. 在“生成后操做”选项卡中，对于“要存档的文件”，输入 **/* 以包括全部文件。

2. 对于“TFS/Team Services 中的触发器发布”，输入账户的完整 URL（例如 https://your-account-name.visualstudio.com）、项目名称、（之后建立的）发布定义的名称，以及用于链接到账户的凭据。 须要使用以前建立的用户名和 PAT。

3. 保存生成项目。

建立 Jenkins 服务终结点

服务终结点容许 Team Services 链接到 Jenkins。

1. 在 Team Services 中打开“服务”页面，打开“新建服务终结点”列表，并选择“Jenkins”。

2. 输入用来引用此链接的名称。

3. 输入 Jenkins 服务器的 URL，并选中“接受不受信任的 SSL 证书”选项。

4. 输入 Jenkins 账户的用户名和密码。

5. 选择“验证链接”来检查信息是否正确。

6. 选择“肯定”以建立服务终结点。

建立部署组

须要一个部署组来包含虚拟机。

1. 打开“生成和发布”中心的“发布”选项卡，打开“部署组”选项卡并选择“+ 新建”。

2. 为部署组输入名称和可选说明。 选择“建立”。

Azure 资源组部署任务会在它运行时使用 Azure 资源管理器模板建立并注册 VM。 你不须要本身建立并注册虚拟机。

建立发布定义

发布定义指定 Team Services 在部署应用时执行的流程。 若要在 Team Services 中建立发布定义，请执行如下操做：

1. 打开“生成和发布”中心的“生成”选项卡，打开发布定义列表中的 + 下拉列表，并选择“建立发布定义”。&

2. 选择“空”模板并选择“下一步”。

3. 在“项目”部分中，单击“连接一个项目”并选择“Jenkins”。 选择本身的 Jenkins 服务终结点链接。 而后，选择 Jenkins 源做业并选择“建立”。

4. 在新的发布定义中，选择“+ 添加任务”并向默认环境中添加一个Azure 资源组部署任务。

5. 选择“+ 添加任务”连接旁边的下拉箭头并向定义中添加一个部署组阶段。

6. 在任务目录中，打开“实用工具”部分并添加“Shell 脚本”任务的一个实例。

7. Azure 资源组部署任务中使用的参数模板设置用来链接到 VM 的管理员密码。 经过变量 $(adminpassword) 提供此密码：

   • 打开“变量”选项卡，在“变量”部分中，输入名称 adminpassword。

   • 输入管理员密码。

   • 选择值文本框旁边的“挂锁”图标来保护密码。

配置 Azure 资源组部署任务

Azure 资源组部署任务用来建立部署组。 请以下所述对其进行配置：

• Azure 订阅：从“可用 Azure 服务链接”下的列表中选择一个链接。 若是没有显示任何链接，则依次选择“管理”、“新建服务终结点”和“Azure 资源管理器”，并根据提示进行操做。 返回到发布定义，刷新“AzureRM 订阅”列表并选择已建立的链接。

• 资源组：输入以前建立的资源组的名称。

• 位置：为部署选择区域。

• 模板位置：URL of the file

• 模板连接：{your-git-repo}/ARM-Templates/UbuntuWeb1.json

• 模板参数连接：{your-git-repo}/ARM-Templates/UbuntuWeb1.parameters.json

• 替代模板参数：替代值的列表，例如：-location {location} -virtualMachineName {machine] -virtualMachineSize Standard_DS1_v2 -adminUsername {username} -virtualNetworkName fabrikam-node-rg-vnet -networkInterfaceName fabrikam-node-websvr1 -networkSecurityGroupName fabrikam-node-websvr1-nsg -adminPassword $(adminpassword) -diagnosticsStorageAccountName fabrikamnodewebsvr1 -diagnosticsStorageAccountId Microsoft.Storage/storageAccounts/fabrikamnodewebsvr1 -diagnosticsStorageAccountType Standard_LRS -addressPrefix 172.16.8.0/24 -subnetName default -subnetPrefix 172.16.8.0/24 -publicIpAddressName fabrikam-node-websvr1-ip -publicIpAddressType Dynamic。
  对于 {占位符}，请插入本身的具体值。

• 启用先决条件：Configure with Deployment Group agent

• TFS/VSTS 终结点：选择“添加”，并在“添加新的 Team Foundation Server/Team Services 链接”对话框中，选择“基于令牌的身份验证”。 输入链接名称和团队项目的 URL。 而后，生成并输入我的访问令牌 (PAT) 来对项目团队的链接进行身份验证。

• 团队项目：选择当前的项目。

• 部署组：输入用于资源组参数的同一部署组名称。

Azure 资源组部署任务的默认设置是用于建立或更新资源，而且以增量方式执行该操做。 该任务在它首次运行时建立 VM，以后只是对它们进行更新。

配置 Shell 脚本任务

Shell 脚本任务用来为在每台服务器上安装 Node.js 并启动该应用的脚本提供配置。 请以下所述对其进行配置：

• 脚本路径：$(System.DefaultWorkingDirectory)/Fabrikam-Node/deployscript.sh

• 指定工做目录：Checked

• 工做目录：$(System.DefaultWorkingDirectory)/Fabrikam-Node

重命名并保存发布定义

1. 将发布定义的名称编辑为在 Jenkins 的生成的“生成后操做”选项卡中指定的名称。 Jenkins 要求此名称可以在源项目更新时触发新的发布。

2. （可选）经过单击环境名称来更改该名称。

3. 选择“保存”，并选择“肯定”。

启动手动部署

1. 选择“+ 发布”并选择“建立发布”。

2. 在突出显示的下拉列表中选择已完成的生成，并选择“建立”。

3. 选择弹出消息中的发布连接。 例如：“发布 Release-1 已建立。”

4. 打开“日志”选项卡以查看发布控制台输出。

5. 在浏览器中，打开已添加到部署组的服务器之一的 URL。 例如，输入 http://{your-server-ip-address}

启动 CI/CD 部署

1. 在发布定义中，在 Azure 资源组部署任务的设置的“控制选项”部分中取消选中“已启用”复选框。 对于到现有部署组的未来部署，不须要从新执行此任务。

2. 转到源 Git 存储库并修改文件 app/views/index.jade 中 h1 标题的内容。

3. 提交更改。

4. 几分钟后，会在 Team Services 或 TFS 的“发布”页面中看到新建立的发布。 打开此发布能够看到部署正在进行。 祝贺你！

后续步骤

在本教程中，你已使用 Jenkins 生成和用于发布的 Team Services 实现了到 Azure 的应用部署自动化。 你已了解如何：

• 采用 Jenkins 生成应用
• 为 Team Services 集成配置 Jenkins
• 为 Azure 虚拟机建立部署组
• 建立对 VM 进行配置并部署应用的发布定义

转到下一教程，详细了解如何部署 LAMP（Linux、Apache、MySQL 和 PHP）堆栈。

当即访问http://market.azure.cn