csanchez/jenkins-kubernetes

csanchez/jenkins-kubernetes镜像说明

镜像概述

本镜像基于官方Jenkins镜像构建，集成了Jenkins Kubernetes插件，核心功能是在Kubernetes集群中动态生成Jenkins代理Pod，实现构建任务的弹性扩展。代理Pod使用JNLP协议连接Jenkins主节点，任务完成后自动销毁，有效优化资源利用率。

核心功能

1. 动态代理Pod：为每个构建任务创建独立Pod，任务结束后自动停止，避免资源浪费。
2. 多容器支持：单个代理Pod可包含多个容器（如Maven、Golang），共享资源与挂载卷，满足多环境构建需求。
3. Pipeline集成：支持声明式与脚本式Pipeline，通过podTemplate定义Pod配置，灵活控制容器执行环境。
4. 资源配置：可设置容器CPU/内存限制、环境变量、卷挂载等，适配不同任务的资源需求。
5. 模板继承：Pod模板支持多继承，简化重复配置，提升模板复用性。
6. 日志访问：通过containerLog步骤获取容器日志，便于调试构建问题。

使用场景

• CI/CD流水线：为Java、Go等多语言项目提供隔离的构建环境。
• 资源敏感任务：对CPU/内存有特殊要求的构建或测试任务，通过资源限制保障稳定性。
• 多环境测试：在同一Pod中运行应用容器与数据库容器，快速完成集成测试。
• 弹性扩展：根据构建队列自动增减代理Pod，适应业务高峰需求。

配置说明

Kubernetes云配置

1. 进入Jenkins设置，添加云服务，选择Kubernetes。
2. 填写集群信息（如Kubernetes URL、证书密钥），若未设置URL，将自动从ServiceAccount或kubeconfig文件获取。

Pod模板配置

通过podTemplate定义代理Pod，支持YAML格式直接配置Pod参数：

groovy
def label = "mypod-${UUID.randomUUID().toString()}"
podTemplate(label: label, yaml: """
apiVersion: v1
kind: Pod
metadata:
  labels:
    some-label: some-label-value
spec:
  containers:
  - name: busybox
    image: busybox
    command: ["cat"]
    tty: true
""") {
    node(label) {
        container('busybox') {
            sh "hostname"
        }
    }
}

声明式Pipeline配置

Jenkins 2.66+支持声明式Pipeline：

groovy
pipeline {
  agent {
    kubernetes {
      label 'mypod'
      defaultContainer 'jnlp'
      yaml """
apiVersion: v1
kind: Pod
spec:
  containers:
  - name: maven
    image: maven:alpine
    command: ["cat"]
    tty: true
"""
    }
  }
  stages {
    stage('Maven Build') {
      steps {
        container('maven') {
          sh 'mvn -version'
        }
      }
    }
  }
}

部署示例

Docker本地运行

bash
docker run --rm --name jenkins -p 8080:8080 -p 50000:50000 -v /var/jenkins_home csanchez/jenkins-kubernetes

访问http://localhost:8080完成Jenkins初始化配置。

Kubernetes集群部署（Minikube）

1. 创建命名空间与ServiceAccount：

bash
kubectl create namespace kubernetes-plugin
kubectl apply -n kubernetes-plugin -f src/main/kubernetes/service-account.yml

2. 部署Jenkins：

bash
kubectl apply -n kubernetes-plugin -f src/main/kubernetes/jenkins.yml

3. 获取访问地址：

bash
minikube service jenkins --namespace kubernetes-plugin --url

通过输出的URL访问Jenkins控制台。