nightah/jenkins

Jenkins (含Docker与Notary) 镜像

概述

本镜像基于官方Jenkins构建，预先集成了Docker引擎和Notary工具。旨在提供一站式CI/CD解决方案，用户无需额外配置即可在Jenkins中直接执行Docker镜像构建、推送操作，并通过Notary实现镜像的签名与验证，增强容器镜像的安全性。

核心功能与特性

• 基础Jenkins功能：完整支持Jenkins的自动化构建、测试、部署等CI/CD核心能力，包含Web界面、插件管理、任务配置等。
• 预安装Docker：集成Docker引擎，可直接在Jenkins任务中执行docker build、docker push等命令，无需额外安装Docker环境。
• 内置Notary：包含Notary客户端工具，支持Docker镜像的签名（notary sign）与验证（notary verify），满足供应链安全需求。
• 开箱即用：减少环境配置步骤，快速部署具备容器化与安全验证能力的CI/CD平台。

使用场景与适用范围

• 容器化应用CI/CD：适用于需要在自动化流程中构建、推送Docker镜像的开发团队。
• 镜像安全管控：需对Docker镜像进行签名和验证，确保镜像来源可信的场景（如生产环境部署前的安全检查）。
• 简化环境配置：希望避免在Jenkins服务器手动安装Docker和Notary的用户，降低运维复杂度。

使用方法与配置说明

快速启动

通过以下命令启动容器，映射Jenkins默认端口（8080）和agent端口（50000），并挂载Docker socket以使用宿主机Docker引擎：

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v jenkins_data:/var/jenkins_home \
  --name jenkins-docker-notary \
  [镜像名称]

说明：/var/run/docker.sock挂载使容器内Docker命令可直接调用宿主机Docker引擎；jenkins_data卷用于持久化Jenkins数据（配置、任务、插件等）。

环境变量配置

可通过环境变量自定义Jenkins初始化配置，常用变量包括：

• JENKINS_OPTS：Jenkins启动参数（如--httpPort=8080）
• JAVA_OPTS：JVM参数（如-Xmx2g调整内存）

示例：

bash
docker run -d \
  -e JENKINS_OPTS="--httpPort=8081" \
  -e JAVA_OPTS="-Xmx2g -Xms1g" \
  -p 8081:8081 \
  -v jenkins_data:/var/jenkins_home \
  --name jenkins-docker-notary \
  [镜像名称]

Notary使用示例

在Jenkins任务中，可直接调用Notary命令对镜像进行签名：

bash
# 登录Notary服务器（需提前配置Notary服务器地址）
notary login -u [用户名] -p [密码] [notary服务器地址]

# 对镜像进行签名
notary sign [镜像仓库地址]/[镜像名称]:[标签]

验证镜像：

bash
notary verify [镜像仓库地址]/[镜像名称]:[标签]

持久化与数据管理

建议通过卷（Volume）挂载/var/jenkins_home目录，确保Jenkins配置、插件和任务数据在容器重启后不丢失。如上方示例中的-v jenkins_data:/var/jenkins_home。

注意事项

• 确保宿主机Docker版本与镜像内Docker版本兼容，避免命令执行异常。
• Notary使用需提前配置Notary服务器（如Docker Content Trust或自建Notary服务），并在Jenkins任务中正确设置Notary环境变量（如NOTARY_SERVER）。
• 生产环境中建议通过HTTPS访问Jenkins，可配置反向代理或添加SSL证书。