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

qingkuangs

　　持续集成 (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 中提供的此示例应用。

• 　　创建此应用的一个分支并记下位置 (URL) 以便在本教程的后续步骤中使用。
  
• 　　使此分支成为公共的以方便在后面连接到 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 插件。

• 　　打开 Jenkins 帐户并选择“管理 Jenkins”。
  
• 　　在“管理 Jenkins”页中，选择“管理插件”。
  
• 　　对列表进行筛选以找到“NodeJS”插件，安装该插件且不重启。
  
  
  
  
• 　　对列表进行筛选以找到“Team Foundation Server”插件并安装它。 （此插件同时适用于 Team Services 和 Team Foundation Server。）不需要重启 Jenkins。
  

为 Node.js 配置 Jenkins 生成
　　在 Jenkins 中，创建一个新的生成项目并如下所述对其进行配置：

• 　　在“常规”选项卡中，为生成项目输入一个名称。
  
• 　　在“源代码管理”选项卡中，选择“Git”并输入包含应用代码的存储库和分支的详细信息。
  
  
  
  　　Note
  　　如果存储库不是公共的，请选择“添加”并提供用于连接到它的凭据。
  
• 　　在“生成触发器”选项卡中，选择“轮询 SCM”并输入计划 H/03 * * * * 以便每三分钟轮询一次 Git 存储库来查询更改。
  
• 　　在“生成环境”选项卡中，选择“提供节点和 npm bin/ 文件路径”并输入 NodeJS 作为 Node JS 安装值。 将“npmrc 文件”保留设置为“使用系统默认值”。
  
• 　　在“生成”选项卡中，输入命令 npm install 以确保更新所有依赖项。
  

为 Team Services 集成配置 Jenkins

• 　　在“生成后操作”选项卡中，对于“要存档的文件”，输入 **/* 以包括所有文件。
  
• 　　对于“TFS/Team Services 中的触发器发布”，输入帐户的完整 URL（例如 https://your-account-name.visualstudio.com）、项目名称、（以后创建的）发布定义的名称，以及用于连接到帐户的凭据。 需要使用之前创建的用户名和 PAT。
  
  
  
  
• 　　保存生成项目。
  

创建 Jenkins 服务终结点
　　服务终结点允许 Team Services 连接到 Jenkins。

• 　　在 Team Services 中打开“服务”页面，打开“新建服务终结点”列表，并选择“Jenkins”。
  
  
  
  
• 　　输入用来引用此连接的名称。
  
• 　　输入 Jenkins 服务器的 URL，并选中“接受不受信任的 SSL 证书”选项。
  
• 　　输入 Jenkins 帐户的用户名和密码。
  
• 　　选择“验证连接”来检查信息是否正确。
  
• 　　选择“确定”以创建服务终结点。
  

创建部署组
　　需要一个部署组来包含虚拟机。

• 　　打开“生成和发布”中心的“发布”选项卡，打开“部署组”选项卡并选择“+ 新建”。
  
• 　　为部署组输入名称和可选说明。 选择“创建”。
  

　　Azure 资源组部署任务会在它运行时使用 Azure 资源管理器模板创建并注册 VM。 你不需要自己创建并注册虚拟机。
创建发布定义
　　发布定义指定 Team Services 在部署应用时执行的流程。 若要在 Team Services 中创建发布定义，请执行以下操作：

• 　　打开“生成和发布”中心的“生成”选项卡，打开发布定义列表中的 + 下拉列表，并选择“创建发布定义”。&
  
• 　　选择“空”模板并选择“下一步”。
  
• 　　在“项目”部分中，单击“链接一个项目”并选择“Jenkins”。 选择自己的 Jenkins 服务终结点连接。 然后，选择 Jenkins 源作业并选择“创建”。
  
• 　　在新的发布定义中，选择“+ 添加任务”并向默认环境中添加一个Azure 资源组部署任务。
  
• 　　选择“+ 添加任务”链接旁边的下拉箭头并向定义中添加一个部署组阶段。
  
  
  
  
• 　　在任务目录中，打开“实用工具”部分并添加“Shell 脚本”任务的一个实例。
  
• 　　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
  

重命名并保存发布定义

• 　　将发布定义的名称编辑为在 Jenkins 的生成的“生成后操作”选项卡中指定的名称。 Jenkins 要求此名称能够在源项目更新时触发新的发布。
  
• 　　（可选）通过单击环境名称来更改该名称。
  
• 　　选择“保存”，并选择“确定”。
  

启动手动部署

• 　　选择“+ 发布”并选择“创建发布”。
  
• 　　在突出显示的下拉列表中选择已完成的生成，并选择“创建”。
  
• 　　选择弹出消息中的发布链接。 例如：“发布 Release-1 已创建。”
  
• 　　打开“日志”选项卡以查看发布控制台输出。
  
• 　　在浏览器中，打开已添加到部署组的服务器之一的 URL。 例如，输入 http://{your-server-ip-address}
  

启动 CI/CD 部署

• 　　在发布定义中，在 Azure 资源组部署任务的设置的“控制选项”部分中取消选中“已启用”复选框。 对于到现有部署组的将来部署，不需要重新执行此任务。
  
• 　　转到源 Git 存储库并修改文件 app/views/index.jade 中 h1 标题的内容。
  
• 　　提交更改。
  
• 　　几分钟后，会在 Team Services 或 TFS 的“发布”页面中看到新创建的发布。 打开此发布可以看到部署正在进行。 祝贺你！
  

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

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

　　转到下一教程，详细了解如何部署 LAMP（Linux、Apache、MySQL 和 PHP）堆栈。
　　立即访问http://market.azure.cn