编辑“︁Jenkins Kubernetes集成”︁

= Jenkins Kubernetes集成 =  
''Jenkins Kubernetes集成''是指将[[Jenkins]]持续集成/持续交付（CI/CD）系统与[[Kubernetes]]容器编排平台相结合，实现动态、可扩展的构建代理管理。通过这种集成，Jenkins可以按需在Kubernetes集群中创建和销毁Pod作为构建代理，从而优化资源利用率并提升CI/CD管道的弹性。

== 概述 ==  
Jenkins传统上依赖静态代理（静态节点）或云提供商插件（如AWS、Azure）来扩展构建资源。与Kubernetes集成后，Jenkins能够动态调度构建任务到Kubernetes Pod中，实现以下优势：  
* '''资源弹性'''：按需创建/销毁Pod，避免长期占用资源。  
* '''环境一致性'''：每个构建在干净的容器环境中运行。  
* '''多云支持'''：通过Kubernetes的跨云能力，无缝部署到不同云平台。  

== 核心组件 ==  
集成涉及以下关键组件：  
# '''Jenkins Kubernetes插件'''：官方插件，负责与Kubernetes API交互。  
# '''Pod模板'''：定义构建代理的容器镜像、资源限制、环境变量等。  
# '''ServiceAccount'''：Kubernetes中的权限配置，允许Jenkins管理Pod。  

== 配置步骤 ==  
=== 1. 安装Kubernetes插件 ===  
在Jenkins管理界面中安装插件：  
<code>Manage Jenkins > Manage Plugins > 搜索"Kubernetes"</code>  

=== 2. 配置Kubernetes云 ===  
在Jenkins系统配置中添加Kubernetes集群信息：  
<syntaxhighlight lang="groovy">  
// Jenkinsfile 示例片段  
pipeline {  
    agent {  
        kubernetes {  
            label 'my-k8s-agent'  
            yaml """  
apiVersion: v1  
kind: Pod  
metadata:  
  labels:  
    app: jenkins-agent  
spec:  
  containers:  
  - name: jnlp  
    image: jenkins/inbound-agent:latest  
    resources:  
      limits:  
        cpu: "1"  
        memory: "1Gi"  
"""  
        }  
    }  
    stages {  
        stage('Build') {  
            steps {  
                sh 'echo "Hello from Kubernetes!"'  
            }  
        }  
    }  
}  
</syntaxhighlight>  

=== 3. 权限配置 ===  
创建Kubernetes ServiceAccount并绑定角色：  
<syntaxhighlight lang="yaml">  
# k8s-service-account.yaml  
apiVersion: v1  
kind: ServiceAccount  
metadata:  
  name: jenkins  

apiVersion: rbac.authorization.k8s.io/v1  
kind: ClusterRoleBinding  
metadata:  
  name: jenkins-role-binding  
subjects:  
- kind: ServiceAccount  
  name: jenkins  
  namespace: default  
roleRef:  
  kind: ClusterRole  
  name: edit  
  apiGroup: rbac.authorization.k8s.io  
</syntaxhighlight>  

== 实际案例 ==  
=== 场景：动态构建Java应用 ===  
1. **需求**：为Maven项目动态分配构建资源。  
2. **解决方案**：使用自定义Pod模板包含Maven和JDK容器。  
<mermaid>  
graph LR  
    A[Jenkins Master] --> B[触发构建]  
    B --> C{Kubernetes集群}  
    C --> D[创建Pod: maven+jdk]  
    D --> E[执行构建]  
    E --> F[销毁Pod]  
</mermaid>  

=== 代码示例 ===  
<syntaxhighlight lang="yaml">  
# 自定义Pod模板  
spec:  
  containers:  
  - name: maven  
    image: maven:3.8.5-openjdk-11  
    command: ['cat']  
    tty: true  
    volumeMounts:  
    - mountPath: /root/.m2  
      name: maven-cache  
  volumes:  
  - name: maven-cache  
    emptyDir: {}  
</syntaxhighlight>  

== 高级主题 ==  
=== 资源优化 ===  
通过Kubernetes的`ResourceQuota`限制命名空间资源：  
<math>  
\text{总CPU} = \sum_{i=1}^{n} (\text{Pod}_i \text{的CPU请求})  
</math>  

=== 故障排查 ===  
常见问题：  
* **Pod启动失败**：检查ServiceAccount权限和镜像拉取策略。  
* **网络问题**：确保Jenkins Master可访问Kubernetes API。  

== 总结 ==  
Jenkins与Kubernetes集成将CI/CD流水线提升至云原生级别，适合需要高弹性、多云支持的团队。初学者可通过基础配置快速入门，而高级用户能利用Pod模板和资源控制实现复杂场景。  

== 参见 ==  
* [[Jenkins Pipeline语法]]  
* [[Kubernetes基础知识]]  

<!-- 注：所有链接需根据实际网站结构调整 -->

[[Category:集成部署]]
[[Category:Jenkins]]
[[Category:Jenkins容器化与云原生]]