若要将应用程序开发的生成和测试阶段自动化,可以使用持续集成和部署 (CI/CD) 管道。 本教程介绍如何在 Azure VM 上创建 CI/CD 管道,包括如何:
创建 Jenkins VM
安装并配置 Jenkins
创建 GitHub 与 Jenkins 之间的 Webhook 集成
通过 GitHub 提交创建并触发 Jenkins 生成作业
创建应用的 Docker 映像
验证 GitHub 提交是否生成新的 Docker 映像并更新正在运行的应用
Note
在 Azure 中国区使用 Azure CLI 2.0 之前,请先运行az cloud set -n AzureChinaCloud来改变云环境。如果想切回国际版 Azure,请再次运行az cloud set -n AzureCloud。
创建 Jenkins 实例
在当前 shell 中,创建名为“cloud-init.txt”的文件并粘贴下面的配置。 请确保已正确复制整个 cloud-init 文件,尤其是第一行:
yaml复制
#cloud-configpackage_upgrade:truewrite_files:- path:/etc/systemd/system/docker.service.d/docker.confcontent:|
[Service]
ExecStart=
ExecStart=/usr/bin/dockerd- path:/etc/docker/daemon.jsoncontent:|
{
"hosts": ["fd://","tcp://127.0.0.1:2375"]
- apt-get update && apt-get install jenkins -y
- usermod -aG docker azureuser
- usermod -aG docker jenkins
- service jenkins restart
Note
在 Azure 中国区使用 Azure CLI 2.0 之前,请先运行az cloud set -n AzureChinaCloud来改变云环境。如果想切回国际版 Azure,请再次运行az cloud set -n AzureCloud。
Azure CLI复制
azgroupcreate--namemyResourceGroupJenkins--locationchinaeast
Azure CLI复制
azvmcreate--resource-groupmyResourceGroupJenkins \--namemyVM \--imageUbuntuLTS \--admin-usernameazureuser \--generate-ssh-keys\--custom-datacloud-init-jenkins.txt
创建并配置 VM 需要几分钟的时间。
Azure CLI复制
azvmopen-port--resource-groupmyResourceGroupJenkins--namemyVM--port8080--priority1001azvmopen-port--resource-groupmyResourceGroupJenkins--namemyVM--port1337--priority1002
配置 Jenkins
若要访问 Jenkins 实例,请获取 VM 的公共 IP 地址:
Azure CLI复制
azvmshow--resource-groupmyResourceGroupJenkins--namemyVM-d--query[publicIps]--otsv
出于安全考虑,需要输入 VM 上某个文本文件中存储的初始管理员密码来启动 Jenkins 安装。 使用上一步骤中获取的公共 IP 地址通过 SSH 连接到 VM:
bash复制
ssh azureuser@
查看并复制 Jenkins 安装程序的initialAdminPassword:
bash复制
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
如果文件尚不可用,请再等待几分钟,以便 cloud-init 完成 Jenkins 和 Docker 安装。
输入在上一步骤从 VM 获取的initialAdminPassword。
选择“选择要安装的插件”
在顶部文本框中搜索 GitHub,选择“GitHub 插件”,然后选择“安装”
若要创建 Jenkins 用户帐户,请根据需要填写表单。 从安全角度讲,应该创建这第一个 Jenkins 用户,而不要继续使用默认管理员帐户。
完成后,选择“开始使用 Jenkins”
创建 GitHub Webhook
在创建的分叉中创建 Webhook:
选择“设置”,然后在左侧选择“集成和服务”。
选择“添加服务”,并在筛选框中输入 Jenkins。
选择“Jenkins (GitHub 插件)”
选择“添加服务”
创建 Jenkins 作业
若要让 Jenkins 对 GitHub 中的事件(例如提交代码)做出响应,请创建 Jenkins 作业。
在 Jenkins 网站中的主页上,选择“创建新作业”:
输入HelloWorld作为作业名称。 选择“自由风格项目”,然后选择“确定”。
在“生成触发器”部分下面,选择“用于 GITscm 轮询的 GitHub 挂钩触发器”。
在“生成”部分下面,选择“添加生成步骤”。 选择“执行 shell”,然后在命令窗口中输入echo "Testing"。
选择作业窗口底部的“保存”。
测试 GitHub 集成
若要测试 GitHub 与 Jenkins 的集成,请提交分叉中的更改。
返回到 GitHub Web UI,选择分叉的存储库,然后选择“index.js”文件。 选择铅笔图标编辑该文件,使第 6 行的内容如下:
NodeJS复制
response.end("Hello World!");
若要提交更改,请选择底部的“提交更改”按钮。
在 Jenkins 中,作业页左下角的“生成历史记录”部分下面启动了一个新的生成。 选择生成号链接,并选择左侧的“控制台输出”。 从 GitHub 提取代码以及生成操作将消息Testing输出到控制台时,可以查看 Jenkins 执行的步骤。 每次在 GitHub 中提交内容时,Webhook 将以此方式访问 Jenkins 并触发新的生成。
定义 Docker 生成映像
为了查看基于 GitHub 提交内容运行的 Node.js 应用,让我们生成一个 Docker 映像用于运行该应用。 该映像是从定义如何配置运行应用的容器的 Dockerfile 生成的。
通过 SSH 连接到 VM 后,请切换到根据上一步骤创建的作业命名的 Jenkins 工作区目录。 在本示例中,该目录名为HelloWorld。
bash复制
cd/var/lib/jenkins/workspace/HelloWorld
使用sudo sensible-editor Dockerfile在此工作区目录中创建一个文件并粘贴以下内容。 请确保已正确复制整个 Dockerfile,尤其是第一行:
yaml复制
此 Dockerfile 使用基本 Node.js 映像(该映像使用 Alpine Linux),公开运行 Hello World 应用的端口 1337,然后复制应用文件并初始化应用。
创建 Jenkins 生成规则
在上一步骤中,已创建一个可将消息输出到控制台的基本 Jenkins 生成规则。 让我们创建生成步骤以使用 Dockerfile 并运行应用。
返回到 Jenkins 实例,选择上一步骤创建的作业。 选择左侧的“配置”,并向下滚动到“生成”部分:
删除现有的echo "Test"生成步骤。 选择现有生成步骤框右上角的红叉。
选择“添加生成步骤”,然后选择“执行 shell”
在“命令”框中输入以下 Docker 命令,然后选择“保存”:
bash复制
docker build --tag helloworld:$BUILD_NUMBER.docker stop helloworld && docker rm helloworlddocker run --name helloworld -p 1337:1337 helloworld:$BUILD_NUMBERnode &
Docker 生成步骤将创建一个映像,并使用 Jenkins 生成编号对其进行标记,以便可以维护映像的历史记录。 运行应用的任何现有容器将会停止,随后被删除。 然后,将使用该映像启动新的容器,并基于 GitHub 中的最新提交内容运行 Node.js 应用。
测试管道
若要查看整个管道的工作状况,请再次在分叉的 GitHub 存储库中编辑 index.js 文件,并选择“提交更改”。 将会基于 GitHub 的 Webhook 在 Jenkins 中启动新作业。 创建 Docker 映像并在新容器中启动应用需要几秒钟时间。
如果需要,请再次获取 VM 的公共 IP 地址:
Azure CLI复制
azvmshow--resource-groupmyResourceGroupJenkins--namemyVM-d--query[publicIps]--otsv
现在,请再次在 GitHub 中编辑index.js,然后提交更改。 等待几秒钟让作业在 Jenkins 中完成,然后刷新 Web 浏览器查看新容器中运行的应用的更新版本,如下所示:
后续步骤
在本教程中,你已将 GitHub 配置为每次提交代码后运行 Jenkins 生成作业,然后部署了一个 Docker 容器用于测试应用。 你已了解如何:
创建 Jenkins VM
安装并配置 Jenkins
创建 GitHub 与 Jenkins 之间的 Webhook 集成
通过 GitHub 提交创建并触发 Jenkins 生成作业
创建应用的 Docker 映像
验证 GitHub 提交是否生成新的 Docker 映像并更新正在运行的应用
转到下一教程,详细了解如何将 Jenkins 与 Visual Studio Team Services 集成。