bitnamicharts/flux

Bitnami Flux 软件包

Source Controller 是 Flux 的组件。Flux 是一个用于保持 Kubernetes 集群与配置源同步的工具。

https://github.com/fluxcd/source-controller

商标说明：本软件列表由 Bitnami 打包。产品中提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

TL;DR

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

希望在生产环境中使用 Flux？试试 VMware Tanzu Application Catalog，这是 Bitnami 目录的商业版。

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

自 2025 年 8 月 28 日起，Bitnami 将改进其公共目录，在新的 Bitnami 安全镜像计划 下提供精选的强化、安全聚焦镜像集。作为此次过渡的一部分：

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

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

介绍

此 Chart 使用 Helm 包管理器在 Kubernetes 集群上引导 https://github.com/bitnami/containers/tree/main/bitnami/fluxcd-kustomize-controller 部署。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+

安装 Chart

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

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

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

该命令以默认配置在 Kubernetes 集群上部署 Flux。参数 部分列出了可在安装过程中配置的参数。

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

配置和安装详情

资源请求和限制

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

为简化此过程，Chart 包含 resourcesPreset 值，可根据不同的预设自动设置 resources 部分。在 https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15 中查看这些预设。但是，在生产工作负载中不建议使用 resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参阅 Kubernetes 官方文档。

滚动标签与不可变标签

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

如果主容器有新版本、重大更改或严重漏洞，Bitnami 将发布新的 Chart 来更新其容器。

备份和恢复

要在 Kubernetes 上备份和恢复 Helm Chart 部署，您需要备份源部署的持久卷，并使用 Velero（Kubernetes 备份/恢复工具）将它们附加到新部署。在 本指南 中查找使用 Velero 的说明。

Prometheus 指标

通过将 *.metrics.enabled（在 helmController、imageAutomationController、imageReflectorController、kustomizeController、notificationController 和 sourceController 部分下）设置为 true，此 Chart 可以与 Prometheus 集成。这将在容器中公开 Flux 原生 Prometheus 端口。此外，它将部署多个 metrics 服务，可在 *.metrics.service 部分（在 helmController、imageAutomationController、imageReflectorController、kustomizeController、notificationController 和 sourceController 部分下）进行配置。这些 metrics 服务将具有必要的注解，以便被 Prometheus 自动抓取。

Prometheus 要求

要使集成工作，需要安装 Prometheus 或 Prometheus Operator。安装 https://github.com/bitnami/charts/tree/main/bitnami/prometheus 或 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E4%BB%A5%E4%BE%BF%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E8%BD%BB%E6%9D%BE%E6%8B%A5%E6%9C%89%E5%8F%AF%E7%94%A8%E7%9A%84 Prometheus。

与 Prometheus Operator 集成

该 Chart 可以部署 ServiceMonitor 对象，以与 Prometheus Operator 安装集成。为此，将值 *.metrics.serviceMonitor.enabled=true（在 helmController、imageAutomationController、imageReflectorController、kustomizeController、notificationController 和 sourceController 部分下）设置为 true。确保集群中安装了 Prometheus Operator CustomResourceDefinitions，否则将失败并显示以下错误：

text
no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装 https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus 以获取必要的 CRD 和 Prometheus Operator。

参数

全局参数

通用参数

Kustomize Controller 参数

注意：本 README 因长度限制已被截断。完整 README 可在 https://github.com/bitnami/charts/blob/main/bitnami/flux/README.md 上查看。