使用 Jenkins 部署 Marathon 应用程序
- 教程 - 使用 Jenkins for DC/OS 在 Marathon 上部署应用程序
示例项目
- 访问 Jenkins for DC/OS
- 添加 Docker Hub 凭据
作业
构建步骤
Marathon 部署
- 如何运行
保存
构建
部署
- 访问您的网站
- 添加新帖子

使用 Jenkins 部署 Marathon 应用程序

教程 - 使用 Jenkins for DC/OS 在 Marathon 上部署应用程序

IMPORTANT: Tutorials are intended to give you hands-on experience working with a limited set of DC/OS features with no implied or explicit warranty of any kind. None of the information provided—including sample scripts, commands, or applications—is officially supported by Mesosphere. You should not use this information in a production environment without independent testing and validation.

本教程介绍如何使用 Jenkins for DC/OS 在 Marathon 上部署应用程序。本教程将指导您创建新的 Jenkins 作业，在源代码更改时发布 Docker 容器，并根据项目的 marathon.json 文件中包含的应用定义将这些更改部署到 Marathon。

先决条件： 本教程假设您拥有有效的 Jenkins 安装和许可，可以在 Marathon 上启动应用程序。Jenkins for DC/OS 必须按照 Jenkins 快速入门页面上的说明进行安装。

示例项目

本教程使用的项目取自 cd-demo 存储库，并在 Docker 容器内运行 Jekyll 网站。本教程所需的文件是 Dockerfile、conf/cd-demo-appn.json 和 site 目录。将这些项目复制到新项目，然后推送到您选择的主机上的新 Git 存储库。本教程使用 Docker Hub 存储创建的镜像，并需要帐户信息来执行此任务。

访问 Jenkins for DC/OS

可通过 DC/OS GUI中的仪表盘或服务导航菜单访问 Jenkins for DC/OS。

单击“Jenkins”服务，然后单击“Open Service”访问 Jenkins GUI。

图 1. Jenkins GUI

添加 Docker Hub 凭据

Jenkins 在其凭据库内存储帐户凭据，这允许作业以安全方式使用凭据。

在 Jenkins 主页面中，从左侧菜单中单击 Credentials。
从那里选择 System（也可从左侧菜单中选择），最后选择主查看区域中显示的全局凭据（不受限制）链接。左侧菜单现在应具有 Add Credentials 选项。
单击 Add Credentials，为 Docker Hub 创建新凭据。Kind 下拉菜单中应选择“Username with password”选项。填写其余信息以匹配您的 Docker Hub 帐户。

图 2. 类型下拉菜单

作业

我们将创建一个新的 Jenkins 作业，其与 Docker Hub 一起执行多项操作，然后更新或创建 Marathon 应用程序。

创建一个新的 Freestyle 作业，其名称仅包含小写字母和连字符。此名称将稍后在 Docker 镜像名称中使用，并可能作为 Marathon 应用程序 ID 使用。

图 3. Freestyle 项目
SCM/Git 在以上示例项目部分中，使用新创建的 Git 存储库填写 Git 存储库 URL。Jenkins 必须可以访问它，且可能需要向 Jenkins 实例添加凭据。

图 4. 源代码管理凭据
构建触发器。选择 Poll SCM 构建触发器，其时间表为：*/5 * * * *。这将每五分钟检查一次 Git 存储库是否有更改。

构建步骤

Jenkins 作业执行以下操作：

建立新的 Docker 镜像。
将新镜像推至 Docker Hub。

这些步骤可以使用 Docker Build and Publish 插件通过单个构建步骤执行，这已经包含并可供使用。
在 Add build step 下拉列表中选择 Docker Build and Publish 选项。

图 5. Docker “Add build step” 选项
填写以下字段：

存储库名称，带有您的 Docker Hub 用户名和 /${JOB_NAME} 作为后缀 (“myusername/${JOB_NAME}”)
标签，具有 $GIT_COMMIT
注册表凭据，以上创建的 Docker Hub 的凭据

图 6. Docker 构建和发布屏幕

Marathon 部署

通过从 Add post-build action下拉菜单中选择 Marathon Deployment 选项，添加 Marathon 部署构建后操作。

图 7. Marathon 部署菜单
填写以下字段：

Marathon URL可使用 URL http://leader.mesos/service/marathon，在 DC/OS 内部访问
应用定义，具有与 marathon 应用程序文件 (conf/cd-demo-app.json) 相对的路径
Docker 镜像，具有以上创建的镜像 (myusername/${JOB_NAME}:${GIT_COMMIT})

图 8. 构建后操作屏幕

如何运行

Marathon 部署构建后操作读取应用定义文件，默认情况下为 marathon.json，包含在项目的 Git 存储库中。这是 JSON 文件，必须包含有效的 Marathon 应用定义。
构建后操作中的可配置字段将覆盖文件中匹配字段的内容。例如，设置“应用程序 ID”将替换文件中的 id 字段。在以上配置中，“Docker 镜像”已配置，并将覆盖包含在 docker 字段中的 image 字段。
最终的 JSON 有效负载将发送到已配置的 Marathon 实例，并更新或创建应用程序。