jenkinszh/jenkins-k8s

包含Kubernetes插件的自定义Jenkins镜像

镜像概述

本镜像为自定义Jenkins发行版，预安装了Kubernetes相关插件，旨在简化Kubernetes环境中的CI/CD流程搭建。通过集成Kubernetes插件，可直接与Kubernetes集群交互，实现构建资源的动态调度和管理，适用于容器化应用的持续集成与持续部署场景。

核心功能和特性

• 预安装Kubernetes插件：包含Kubernetes、Kubernetes CLI、Credentials Binding等核心插件，无需手动安装
• 动态构建代理：支持在Kubernetes集群中动态创建和销毁Jenkins构建代理(Pod)，优化资源利用率
• Kubernetes资源集成：可直接使用Kubernetes API管理构建资源，支持ConfigMap、Secret等 Kubernetes资源挂载
• 完整Jenkins功能：保留Jenkins核心功能，包括流水线(Pipeline)、多分支项目、插件管理、用户认证等
• 容器化部署友好：适配容器化环境，支持通过环境变量和配置文件自定义Jenkins参数

使用场景和适用范围

• Kubernetes集群环境中的CI/CD流程自动化
• 容器化应用的构建、测试、打包和部署
• 需要动态扩展构建资源的DevOps工作流
• 微服务架构下的多项目并行构建
• 需与Kubernetes资源（如私有镜像仓库、配置中心）集成的场景

使用方法和配置说明

基本部署

Docker Run 命令

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins-data:/var/jenkins_home \
  --name jenkins-k8s \
  [镜像名称]

参数说明

• -p 8080:8080：映射Jenkins Web界面端口
• -p 50000:50000：映射Jenkins代理通信端口
• -v jenkins-data:/var/jenkins_home：挂载数据卷，持久化Jenkins配置、插件和构建数据

环境变量配置

可通过环境变量自定义Jenkins启动参数：

示例：

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins-data:/var/jenkins_home \
  -e JAVA_OPTS="-Xms1g -Xmx2g" \
  -e JENKINS_ADMIN_PASSWORD="your-secure-password" \
  --name jenkins-k8s \
  [镜像名称]

Kubernetes集成配置

1. 访问Jenkins Web界面（http://localhost:8080%EF%BC%89%EF%BC%8C%E4%BD%BF%E7%94%A8%E5%88%9D%E5%A7%8B%E7%AE%A1%E7%90%86%E5%91%98%E5%87%AD%E8%AF%81%E7%99%BB%E5%BD%95
2. 进入系统管理 > 系统配置，找到Cloud > Kubernetes配置项
3. 配置Kubernetes集群信息：
   • Kubernetes URL：Kubernetes API地址（如https://kubernetes.default.svc.cluster.local）
   • Kubernetes 命名空间：构建代理Pod所在命名空间（如jenkins）
   • 凭证：配置访问Kubernetes集群的凭证（如Service Account令牌）
4. 配置构建代理模板：
   • 指定代理镜像、资源限制（CPU/内存）
   • 配置工作目录和卷挂载（如共享构建缓存）
5. 保存配置后，即可在Jenkins流水线中使用agent { kubernetes { ... } }定义Kubernetes代理

数据持久化

为避免容器重启导致数据丢失，需持久化/var/jenkins_home目录：

• 使用Docker数据卷（推荐）：-v jenkins-data:/var/jenkins_home
• 使用主机目录：-v /path/on/host:/var/jenkins_home（需确保权限正确，可添加-u root临时解决权限问题）

插件管理

虽然镜像已预安装Kubernetes相关插件，仍可通过Jenkins界面管理插件：

1. 进入系统管理 > 插件管理
2. 在可用标签页搜索并安装额外插件
3. 在已安装标签页更新或卸载插件