编辑“︁Jenkins Helm 集成”︁

= Jenkins Helm 集成 =

'''Jenkins Helm 集成'''是指使用 Kubernetes 包管理工具 Helm 来部署和管理 Jenkins 实例的过程。Helm 提供了一种标准化的方式来定义、安装和升级 Kubernetes 应用程序，使得 Jenkins 的部署和管理更加高效和可重复。本章节将详细介绍如何使用 Helm 在 Kubernetes 集群中部署 Jenkins，并探讨其最佳实践。

== 介绍 ==
Helm 是 Kubernetes 的包管理工具，通过使用称为“Charts”的预定义模板，用户可以轻松地部署和管理复杂的应用程序。Jenkins 官方提供了 Helm Chart，使得用户能够快速在 Kubernetes 环境中安装和配置 Jenkins。Helm 集成的主要优势包括：
* **简化部署**：通过 Helm Chart，用户可以一键部署 Jenkins，无需手动编写复杂的 Kubernetes 清单文件。
* **可配置性**：Helm 支持通过 `values.yaml` 文件自定义 Jenkins 的配置，如插件、资源限制和环境变量。
* **版本控制**：Helm 支持版本管理，用户可以轻松回滚到之前的部署状态。

== 前提条件 ==
在开始之前，请确保满足以下条件：
1. 已安装并配置 Kubernetes 集群。
2. 已安装 Helm（版本 3.x 或更高）。
3. 具备基本的 Kubernetes 和 Jenkins 知识。

== 安装 Jenkins Helm Chart ==
以下是使用 Helm 安装 Jenkins 的步骤：

=== 1. 添加 Jenkins Helm 仓库 ===
首先，添加 Jenkins 官方 Helm 仓库：
<syntaxhighlight lang="bash">
helm repo add jenkins https://charts.jenkins.io
helm repo update
</syntaxhighlight>

=== 2. 自定义配置 ===
创建一个 `values.yaml` 文件来覆盖默认配置。以下是一个示例配置：
<syntaxhighlight lang="yaml">
controller:
  componentName: "jenkins-controller"
  image: "jenkins/jenkins:lts"
  tag: "2.414.2"
  adminUser: "admin"
  adminPassword: "admin"
  resources:
    requests:
      cpu: "500m"
      memory: "512Mi"
    limits:
      cpu: "1"
      memory: "1Gi"
  installPlugins:
    - "kubernetes:1.31.3"
    - "workflow-aggregator:2.6"
  serviceType: "LoadBalancer"
</syntaxhighlight>

=== 3. 安装 Jenkins ===
使用 Helm 安装 Jenkins：
<syntaxhighlight lang="bash">
helm install jenkins jenkins/jenkins -f values.yaml
</syntaxhighlight>

=== 4. 访问 Jenkins ===
安装完成后，获取 Jenkins 服务的外部 IP：
<syntaxhighlight lang="bash">
kubectl get svc jenkins
</syntaxhighlight>
输出示例：
<pre>
NAME      TYPE           CLUSTER-IP     EXTERNAL-IP    PORT(S)        AGE
jenkins   LoadBalancer   10.0.100.201   192.168.1.10   8080:30080/TCP 2m
</pre>
通过浏览器访问 `http://<EXTERNAL-IP>:8080` 并登录。

== 高级配置 ==
Helm 提供了丰富的配置选项，以下是几个常见的用例：

=== 持久化存储 ===
默认情况下，Jenkins 数据存储在临时卷中。为了持久化数据，可以配置持久卷声明（PVC）：
<syntaxhighlight lang="yaml">
controller:
  persistence:
    enabled: true
    size: "10Gi"
    storageClass: "standard"
</syntaxhighlight>

=== 插件管理 ===
通过 `values.yaml` 可以预安装插件：
<syntaxhighlight lang="yaml">
controller:
  installPlugins:
    - "git:4.11.4"
    - "docker-workflow:1.28"
</syntaxhighlight>

=== 自动扩缩容 ===
使用 Kubernetes Horizontal Pod Autoscaler（HPA）自动扩缩容：
<syntaxhighlight lang="yaml">
controller:
  autoscaling:
    enabled: true
    minReplicas: 1
    maxReplicas: 5
    targetCPUUtilizationPercentage: 80
</syntaxhighlight>

== 实际案例 ==
以下是一个真实场景中的 Jenkins Helm 集成案例：

=== 场景：CI/CD 流水线 ===
某公司需要在 Kubernetes 集群中部署 Jenkins 以运行 CI/CD 流水线。通过 Helm，他们实现了：
1. **快速部署**：使用 Helm Chart 在 5 分钟内完成 Jenkins 安装。
2. **插件预配置**：通过 `values.yaml` 预安装了 Git 和 Docker 插件。
3. **高可用性**：配置了 HPA 以确保在高负载时自动扩展实例。

== 故障排除 ==
以下是一些常见问题及其解决方法：

=== Jenkins 无法访问 ===
* 检查服务类型是否为 `LoadBalancer` 或 `NodePort`。
* 使用 `kubectl logs <pod-name>` 查看日志。

=== 插件安装失败 ===
* 确保网络连通性，并检查插件名称和版本是否正确。

== 总结 ==
Jenkins Helm 集成提供了一种高效、可配置的方式来在 Kubernetes 中部署和管理 Jenkins。通过 Helm Chart，用户可以轻松实现持久化存储、插件管理和自动扩缩容等功能。对于初学者和高级用户来说，Helm 都是一个强大的工具，能够显著简化 Jenkins 的运维工作。

== 参见 ==
* [[Kubernetes]]
* [[Helm (软件)]]
* [[Jenkins]]

== 延伸阅读 ==
* [https://helm.sh/docs/ Helm 官方文档]
* [https://www.jenkins.io/doc/book/ Jenkins 官方文档]

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