bitnamicharts/fluent-bit

Bitnami Fluent Bit 软件包

Fluent Bit 是一个快速轻量级的日志处理器和转发器。它以性能为核心设计，允许从不同来源收集事件而无需复杂配置。

Fluent Bit 概述

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

TL;DR

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

希望在生产环境中使用 Fluent Bit？请尝试 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

介绍

本 chart 使用 Helm 包管理器在 Kubernetes 集群上引导部署 https://github.com/bitnami/containers/tree/main/bitnami/fluent-bit%E3%80%82

前提条件

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

安装 Chart

要安装发布名称为 my-release 的 chart：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/fluent-bit

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

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

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

配置和安装详情

资源请求和限制

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

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

Prometheus 指标

通过将 metrics.enabled 设置为 true，本 chart 可与 Prometheus 集成。这将在服务中公开 Fluent Bit 原生 Prometheus 端点，并包含必要的注解以被 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%E5%8F%AF%E8%BD%BB%E6%9D%BE%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E9%83%A8%E7%BD%B2 Prometheus。

与 Prometheus Operator 集成

通过设置 metrics.serviceMonitor.enabled=true，chart 可部署 ServiceMonitor 对象以与 Prometheus Operator 集成。确保集群中已安装 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。

滚动标签与不可变标签

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

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

配置 extraPorts

• 根据您的 fluent-bit 配置，编辑 extraContainerPorts 和 service.extraPorts 参数。在 extraContainerPorts 参数中，设置 fluent-bit 配置使用的额外端口；在 service.extraPorts 参数中，设置要对外暴露的额外端口。

  示例：

  yaml
  service:
    extraPorts:
      - name: forward
        port: 24224 # 使用端口 24224 通过 TCP 接收日志
        protocol: TCP
        targetPort: forward
  
  extraContainerPorts:
    - name: forward
      containerPort: 24224
  

备份和恢复

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

额外环境变量

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

边车容器

如果在 fluent-bit 所在的同一 pod 中需要额外容器（如额外指标或日志导出器），可在主部分中使用 sidecars 参数定义。

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

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

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

注意：此 Helm chart 已包含 Prometheus 导出器的边车容器（如适用）。可在部署时添加 --enable-metrics=true 参数激活这些容器。因此，sidecars 参数应仅用于额外的边车容器。

如果同一 pod 中需要额外的初始化容器，可使用 initContainers 参数定义。示例如下：

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

了解更多关于 边车容器 和 初始化容器 的信息。

Pod 亲和性

本 chart 允许使用 affinity 参数设置自定义亲和性。在 Kubernetes 文档 中查找有关 Pod 亲和性的更多信息。

作为替代方案，可使用 https://github.com/bitnami/charts/tree/main/bitnami/common#affinities chart 中提供的 pod 亲和性、pod 反亲和性和节点亲和性预设配置。为此，在主部分中设置 podAffinityPreset、podAntiAffinityPreset 或 nodeAffinityPreset 参数。

持久化

https://github.com/bitnami/containers/tree/main/bitnami/fluent-bit 默认不实现存储持久化，但如果配置为内存外（见 缓冲与存储），可挂载带有持久卷声明的 extraVolume 以保留缓冲区和/或输出。

参数

全局参数

通用参数

Fluent Bit 参数

Fluent Bit DaemonSet 配置