bitnamicharts/jenkins

Bitnami Jenkins 包

Jenkins是一款开源持续集成和持续交付（CI/CD）服务器，旨在自动化任何软件项目的构建、测试和部署流程。

Jenkins概述

商标声明：本软件列表由Bitnami打包。所提及的相关商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

快速入门

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/jenkins

如需在生产环境中使用Jenkins？请尝试VMware Tanzu Application Catalog，即Bitnami目录的商业版本。

⚠️ 重要通知：Bitnami目录即将变更

自2025年8月28日起，Bitnami将升级其公共目录，通过新的Bitnami Secure Images计划提供精选的强化、安全聚焦镜像。作为此过渡的一部分：

• 首次向社区用户开放热门容器镜像的安全优化版本访问权限。
• Bitnami将开始在免费层级中弃用对非强化、基于Debian的软件镜像的支持，并逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像，这些镜像仅以“latest”标签发布，仅供开发用途。
• 从8月28日开始，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，包括强化容器、更小的***面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提升所有Bitnami用户的安全态势。更多详情，请访问https://github.com/bitnami/containers/issues/83267%E3%80%82

介绍

本图表使用Helm包管理器在Kubernetes集群上引导https://github.com/bitnami/containers/tree/main/bitnami/jenkins%E9%83%A8%E7%BD%B2%E3%80%82

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持PV供应器
• 支持ReadWriteMany卷以实现部署扩展

安装图表

要使用发布名称my-release安装图表：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/jenkins

注意：您需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm图表仓库和存储库的引用。例如，对于Bitnami，需使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

这些命令使用默认配置在Kubernetes集群上部署Jenkins。参数部分列出了可在安装过程中配置的参数。

提示：使用helm list列出所有发布。

配置和安装详情

资源请求和限制

Bitnami图表允许为图表部署内的所有容器设置资源请求和限制。这些配置位于resources值中（参见参数表）。设置请求对于生产工作负载至关重要，应根据具体用例进行调整。

为简化此过程，图表包含resourcesPreset值，可根据不同预设自动设置resources部分。请在https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%E4%B8%AD%E6%9F%A5%E7%9C%8B%E8%BF%99%E4%BA%9B%E9%A2%84%E8%AE%BE%E3%80%82%E4%BD%86%E5%9C%A8%E7%94%9F%E4%BA%A7%E5%B7%A5%E4%BD%9C%E8%B4%9F%E8%BD%BD%E4%B8%AD%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%60resourcesPreset%60%EF%BC%8C%E5%9B%A0%E4%B8%BA%E5%AE%83%E5%8F%AF%E8%83%BD%E6%97%A0%E6%B3%95%E5%AE%8C%E5%85%A8%E9%80%82%E5%BA%94%E6%82%A8%E7%9A%84%E7%89%B9%E5%AE%9A%E9%9C%80%E6%B1%82%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90%E7%AE%A1%E7%90%86%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85%E5%AE%98%E6%96%B9Kubernetes%E6%96%87%E6%A1%A3%E3%80%82

滚动标签与不可变标签

强烈建议在生产环境中使用不可变标签。这可确保如果同一标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大变更或存在严重漏洞，Bitnami将发布新图表更新其容器。

更新凭证

Bitnami图表在首次启动时配置凭证。任何后续对密钥或凭证的更改都需要手动干预。请按照以下说明操作：

• 按照上游文档更新用户密码
• 使用新值更新密码密钥（替换SECRET_NAME和PASSWORD占位符）

shell
kubectl create secret generic SECRET_NAME --from-literal=jenkins-password=PASSWORD --dry-run -o yaml | kubectl apply -f -

配置Ingress

本图表支持Ingress资源。如果您的集群上安装了Ingress控制器（如https://github.com/bitnami/charts/tree/main/bitnami/nginx-ingress-controller%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/contour%EF%BC%89%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%88%A9%E7%94%A8Ingress%E6%8E%A7%E5%88%B6%E5%99%A8%E6%9D%A5%E6%8F%90%E4%BE%9B%E5%BA%94%E7%94%A8%E6%9C%8D%E5%8A%A1%E3%80%82%E8%A6%81%E5%90%AF%E7%94%A8Ingress%E9%9B%86%E6%88%90%EF%BC%8C%E8%AF%B7%E5%B0%86%60ingress.enabled%60%E8%AE%BE%E7%BD%AE%E4%B8%BA%60true%60%E3%80%82

最常见的场景是将一个主机名映射到部署。在这种情况下，ingress.hostname属性可用于设置主机名。ingress.tls参数可用于为此主机添加TLS配置。

不过，也可以有多个主机。为此，可设置ingress.extraHosts参数（如果可用），将主机名指定为数组。ingress.extraTLS参数（如果可用）也可用于为额外主机添加TLS配置。

注意：对于ingress.extraHosts参数中指定的每个主机，需要设置名称、路径以及Ingress控制器应了解的任何注解。并非所有注解都受所有Ingress控制器支持，但https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/annotations.md%E5%88%97%E5%87%BA%E4%BA%86%E8%AE%B8%E5%A4%9A%E6%B5%81%E8%A1%8CIngress%E6%8E%A7%E5%88%B6%E5%99%A8%E6%94%AF%E6%8C%81%E7%9A%84%E6%B3%A8%E8%A7%A3%E3%80%82

添加TLS参数（如可用）将使图表生成HTTPS URL，应用将在443端口上可用。TLS密钥不必由本图表生成。但是，如果启用了TLS，Ingress记录在TLS密钥存在之前将无法工作。

了解更多关于Ingress控制器。

配置用于Ingress的TLS密钥

本图表便于创建用于Ingress控制器的TLS密钥（尽管这不是必需的）。有几种常见用例：

• 基于图表参数生成证书密钥。
• 启用外部生成的证书。
• 通过外部服务（如https://github.com/jetstack/cert-manager/%EF%BC%89%E7%AE%A1%E7%90%86%E5%BA%94%E7%94%A8%E8%AF%81%E4%B9%A6%E3%80%82
• 在图表内创建自签名证书（如支持）。

在前两种情况下，需要证书和密钥。文件应为.pem格式。

证书文件示例：

注意：如果存在证书链，可能会有多个证书。

text
-----BEGIN CERTIFICATE-----
MIID6TCCAtGgAwIBAgIJAIaCwivkeB5EMA0GCSqGSIb3DQEBCwUAMFYxCzAJBgNV
...
jScrvkiBO65F46KioCL9h5tDvomdU1aqpI/CBzhvZn1c0ZTf87tGQR8NK7v7
-----END CERTIFICATE-----

证书密钥示例：

text
-----BEGIN RSA PRIVATE KEY-----
MIIEogIBAAKCAQEAvLYcyu8f3skuRyUgeeNpeDvYBCDcgq+LsWap6zbX5f8oLqp4
...
wrj2wDbCDCFmfqnSJ+dKI3vFLlEz44sAV8jX/kd4Y6ZTQhlLbYc=
-----END RSA PRIVATE KEY-----

• 如果使用Helm基于参数管理证书，请将这些值复制到给定*.ingress.secrets条目的certificate和key值中。
• 如果单独管理TLS密钥，需要创建名称为INGRESS_HOSTNAME-tls的TLS密钥（其中INGRESS_HOSTNAME是需要替换为使用*.ingress.hostname参数设置的主机名的占位符）。
• 如果您的集群有https://github.com/jetstack/cert-manager%E6%8F%92%E4%BB%B6%E6%9D%A5%E8%87%AA%E5%8A%A8%E7%AE%A1%E7%90%86%E5%92%8C%E9%A2%81%E5%8F%91TLS%E8%AF%81%E4%B9%A6%EF%BC%8C%E8%AF%B7%E5%B0%86%E7%9B%B8%E5%BA%94%E6%B3%A8%E8%A7%A3%E6%B7%BB%E5%8A%A0%E5%88%B0%60*.ingress.annotations%60%E3%80%82
• 如果使用Helm创建自签名证书，请将*.ingress.tls和*.ingress.selfSigned都设置为true。

配置额外环境变量

要添加额外环境变量（用于高级操作，如自定义初始化脚本），请使用extraEnvVars属性。

yaml
extraEnvVars:
  - name: LOG_LEVEL
    value: DEBUG

或者，使用包含环境变量的ConfigMap或Secret。为此，使用extraEnvVarsCM或extraEnvVarsSecret值。

配置Sidecar和Init容器

如果Jenkins所在的Pod中需要额外容器（如额外的指标或日志导出器），可使用sidecars参数定义。

yaml
sidecars:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

如果这些sidecar导出额外端口，可使用service.extraPorts参数（如可用）添加额外端口定义，如下例所示：

yaml
service:
  extraPorts:
  - name: extraPort
    port: 11311
    targetPort: 11311

注意：此Helm图表已包含Prometheus导出器的sidecar容器（如适用）。可通过在部署时添加--enable-metrics=true参数来激活它们。因此，sidecars参数应仅用于任何额外的sidecar容器。

如果Pod中需要额外的Init容器，可使用initContainers参数定义。示例如下：

yaml
initContainers:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于sidecar容器和Init容器。

部署额外资源

在某些情况下，您可能需要部署额外对象，如包含应用配置的ConfigMap或应用使用的微服务的额外部署。为此，图表允许使用extraDeploy参数添加其他对象的完整规范。

设置Pod亲和性

本图表允许使用XXX.affinity参数设置自定义Pod亲和性。有关Pod亲和性的更多信息，请参阅Kubernetes文档。

作为替代方案，您可以使用https://github.com/bitnami/charts/tree/main/bitnami/common#affinities%E5%9B%BE%E8%A1%A8%E4%B8%AD%E6%8F%90%E4%BE%9B%E7%9A%84Pod%E4%BA%B2%E5%92%8C%E6%80%A7%E3%80%81Pod%E5%8F%8D%E4%BA%B2%E5%92%8C%E6%80%A7%E5%92%8C%E8%8A%82%E7%82%B9%E4%BA%B2%E5%92%8C%E6%80%A7%E9%A2%84%E8%AE%BE%E9%85%8D%E7%BD%AE%E3%80%82%E4%B8%BA%E6%AD%A4%EF%BC%8C%E8%AE%BE%E7%BD%AE%60XXX.podAffinityPreset%60%E3%80%81%60XXX.podAntiAffinityPreset%60%E6%88%96%60XXX.nodeAffinityPreset%60%E5%8F%82%E6%95%B0%E3%80%82

备份和恢复

要在Kubernetes上备份和恢复Helm图表部署，需要从源部署备份持久卷，并使用Velero（Kubernetes备份/恢复工具）将其附加到新部署。有关使用Velero的说明，请参阅本指南。

持久化

https://github.com/bitnami/containers/tree/main/bitnami/jenkins%E9%95%9C%E5%83%8F%E5%B0%86Jenkins%E6%95%B0%E6%8D%AE%E5%92%8C%E9%85%8D%E7%BD%AE%E5%AD%98%E5%82%A8%E5%9C%A8%E5%AE%B9%E5%99%A8%E7%9A%84%60/bitnami/jenkins%60%E8%B7%AF%E5%BE%84%E4%B8%8B%E3%80%82%E6%8C%81%E4%B9%85%E5%8D%B7%E5%A3%B0%E6%98%8E%EF%BC%88PVC%EF%BC%89%E7%94%A8%E4%BA%8E%E8%B7%A8%E9%83%A8%E7%BD%B2%E4%BF%9D%E7%95%99%E6%95%B0%E6%8D%AE%E3%80%82

如果在使用持久卷时遇到错误，请参阅我们的持久卷故障排除指南。

参数

全局参数

通用参数

Jenkins镜像参数

Jenkins配置参数