mesosphere/jenkins

Jenkins on Mesos

jenkins-mesos插件使Jenkins能够根据工作负载在Mesos集群上动态启动Jenkins代理。当Jenkins构建队列增长时，插件自动在Mesos上启动额外代理以立即调度作业；当代理长时间空闲时，则自动关闭，实现资源高效利用。

目录

• 前提条件
• 安装插件
  • 配置插件
  • 添加代理规格
  • DC/OS认证
  • 配置Jenkins作业
  • Docker容器
  • Docker配置
  • 过度配置标志
• 单用途代理
  • 自由风格作业
  • Pipeline作业
• 插件开发
  • 构建插件
  • 在DC/OS企业版上测试
• 发布

前提条件

需访问运行中的Mesos集群。有关搭建Mesos集群的说明，请参考Mesos官方网站。

安装插件

• 进入Jenkins Web UI的“管理插件”页面，在“可选插件”选项卡中找到名为“mesos”的插件并安装。 *（可选）安装metrics插件，作为本插件的可选依赖，用于提供额外非必要功能。

配置插件

进入Jenkins的“配置”页面。若插件安装成功，页面底部会显示“添加新云”选项：

1. 添加“Mesos Cloud”。
2. 输入Mesos主节点地址http://HOST:PORT（DC/OS环境可简化为https://leader.mesos:5050）。
3. 设置代理启动用户名，确保Mesos代理节点存在该用户。
4. 配置Jenkins URL。
5. 点击“保存”。

可通过“测试连接”按钮验证插件能否连接Mesos主节点。若Mesos主节点使用自定义SSL证书，可在“使用自定义SSL证书”处提供证书。

添加代理规格

“代理规格”定义Mesos上的Jenkins节点属性，可通过“高级”选项管理（添加/编辑/删除）。包含执行器CPU、内存等资源信息，用于匹配Mesos资源提供。标签名是作业与代理类型的关联键，例如：

• 重型作业可分配标签powerful_agent（20 CPU、***M内存）
• 轻量作业可分配标签light_weight_agent（1 CPU、128M内存）

Jenkins配置即代码示例：在dcos/conf/jenkins/configuration.yaml中配置基于amazoncorretto:8的Linux代理和mesosphere/jenkins-windows-node:latest的Windows代理。构建示例见https://github.com/jeschkies/hello-world-fsharp/blob/master/Jenkinsfile%E3%80%82

DC/OS认证

插件支持DC/OS企业版集群认证，需设置环境变量：

• DCOS_SERVICE_ACCOUNT：服务账户名
• DCOS_SERVICE_ACCOUNT_PRIVATE_KEY：服务账户私钥

配置Jenkins作业

在作业配置中勾选“限制项目运行节点”，输入Mesos云配置中定义的标签名（默认mesos），使作业在指定类型的Mesos代理上运行。

Docker容器

默认使用Mesos原生容器，如需在Docker容器中运行代理，有两种选项：

1. 使用原生Docker容器化工具：适用于Mesos代理配置--containerizers=docker（推荐）。
2. 使用外部容器化工具：适用于Mesos代理配置--containerizers=external。

Docker配置

卷

需至少指定容器路径以挂载卷，可选指定主机路径实现数据持久化。支持读写/只读模式。

参数

可添加docker run命令的额外参数，需使用完整参数名（不含前置--），确保与Mesos代理的Docker版本兼容。例如：输入volumes-from和my_container_name以挂载my_container_name的卷。

过度配置标志

默认Jenkins保守分配代理（队列中2个构建时不会立即启动2个执行器）。如需为每个排队构建立即启动执行器，启动Jenkins时添加：

bash
-Dhudson.slaves.NodeProvisioner.MARGIN=50 -Dhudson.slaves.NodeProvisioner.MARGIN0=0.85

单用途代理

自由风格作业

在“构建环境”中勾选“Mesos单用途代理”，构建完成后自动销毁代理。

Pipeline作业

通过以下代码在Pipeline中配置代理自动销毁：

groovy
node('mylabel') {
    wrap([$class: 'MesosSingleUseSlave']) {
        // 构建操作
    }
}

插件开发

构建插件

bash
# 构建插件（生成target/mesos.hpi）
./gradlew check

# 启动测试Jenkins服务器
./gradlew server

# 运行单元测试
./gradlew test

# 运行集成测试（需安装Mesos和Docker）
./gradlew integrationTest

代码格式遵循https://github.com/google/styleguide%E3%80%82

在DC/OS企业版上测试

详见dcos-testing/README.md。

发布

需拥有发布权限，并按Jenkins插件发布指南在~/.m2/settings.xml和~/.jenkins-ci.org中配置凭据。发布步骤：

1. 在build.gradle中设置版本。
2. 执行./gradlew publish发布插件。