Bitnami Stack for InfluxDB™ Core

InfluxDB™ Core是一款开源时序数据库，是FDAP（Apache Flight、DataFusion、Arrow和Parquet）技术栈的核心组件。

InfluxDB™ InfluxDB™ Core概述

InfluxDB™是InfluxData拥有的商标，InfluxData与此网站无关联，也不对此网站进行背书。

快速开始

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

希望在生产环境中使用InfluxDB™ Core？试试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用户的安全态势。更多详情，请访问Bitnami Secure Images公告。

介绍

此图表使用Helm包管理器在Kubernetes集群上引导influxdb部署。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持PV供应器

安装图表

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

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/influxdb

注意：您需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm图表仓库和存储库的引用。例如，对于Bitnami，需使用`REGISTRY_NAME=registry--等（省略后续重复部分（为节省篇幅，此处省略）

配置和存储系统，此处省略部分重复内容，原文后续部分省略）

配置和安装说明

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

配置和安装详情

配置InfluxDB™ Core的暴露方式

此图表安装的部署包含以下配置：

                ------------------
               |     Ingress      |
               |    Controller    |
                ------------------
                        |
                        | /query
                        | /write
                        \/
                 ----------------
                |  InfluxDB(TM)  |
                |      svc       |
                 ----------------
                        |
                        \/
                  --------------
                 | InfluxDB(TM) |
                 |    Server    |
                 |     Pod      |
                  --------------

• Ingress：Kubernetes集群中必须安装Ingress控制器。设置ingress.enabled=true可通过Ingress暴露InfluxDB™ Core。
• ClusterIP：在集群内部IP上暴露服务，仅集群内可访问。设置service.type=ClusterIP选择此服务类型。
• NodePort：在每个节点的静态端口上暴露服务，可通过NodeIP:NodePort从集群外部访问。设置service.type=NodePort选择此类型。
• Load***：使用云提供商的负载均衡器暴露服务。设置service.type=Load***选择此类型。

配置对象存储

InfluxDB™ Core支持多种存储系统存储Parquet文件（有关支持的对象存储，请参考上游文档），可分为三类：

• 内存：默认对象存储，所有数据存储在内存中，非持久化，适用于测试和开发。
• 文件：在本地文件系统中存储数据。
• 云：存储在云提供商的对象存储服务中（如AWS S3、Google Cloud Storage、Azure Blob Storage）。

此图表允许通过objectStore参数配置对象存储。若使用云存储，需额外配置云特定凭证、桶名称等参数。

资源请求和限制

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

为简化配置，图表包含resourcesPreset值，可自动根据不同预设设置resources部分（详情见bitnami/common图表）。但生产环境不建议使用resourcesPreset，因其可能无法完全适应特定需求。更多容器资源管理信息，参见Kubernetes官方文档。

更新凭证

通过将auth.enabled和createAdminTokenJob.enabled参数设为true，图表支持首次启动时创建随机管理员令牌（使用内存对象存储时不支持）。

作为替代，可通过设置auth.existingSecret和auth.existingSecretAdminTokenKey参数，从现有密钥消费凭证。但需注意，仅当对象存储中已预填充带管理员令牌的数据时支持此方式。

凭证的进一步变更需手动操作：

• 若无管理员令牌，按上游文档创建。
• 按上游文档重新生成令牌。

注意：重新生成令牌后，需更新图表使用的密钥中的令牌。

Prometheus指标

设置metrics.enabled=true可集成Prometheus，图表会为InfluxDB™ Core服务添加自动被Prometheus抓取的注解。

Prometheus要求

需安装Prometheus或Prometheus Operator。可安装Bitnami Prometheus helm图表或Bitnami Kube Prometheus helm图表快速部署。

与Prometheus Operator集成

设置metrics.serviceMonitor.enabled=true可部署ServiceMonitor对象以集成Prometheus Operator。确保集群中已安装Prometheus Operator的CustomResourceDefinitions，否则会报错：

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

安装Bitnami Kube Prometheus helm图表可获取所需CRD和Prometheus Operator。

滚动标签与不可变标签

生产环境强烈建议使用不可变标签，确保部署不会因标签更新而自动变更。Bitnami会在主容器有新版本、重大变更或严重漏洞时，发布新图表更新容器。

添加额外环境变量

可通过influxdb.extraEnvVars属性添加额外环境变量：

extraEnvVars:
  - name: INFLUXDB_DATA_QUERY_LOG_ENABLED
    value: "true"

初始化新实例

Bitnami InfluxDB™ Core镜像允许使用自定义脚本初始化新实例（仅支持.sh扩展名）。通过initdbScripts参数指定脚本，或设置initdbScriptsCM参数使用外部ConfigMap（会覆盖前两种方式）。

设置Pod亲和性

可通过affinity参数设置自定义亲和性（详见Kubernetes文档）。

也可使用bitnami/common图表的预设配置，通过podAffinityPreset、podAntiAffinityPreset或nodeAffinityPreset参数设置Pod亲和性、反亲和性或节点亲和性。

备份和恢复

要在Kubernetes上备份和恢复Helm图表部署，需使用Velero备份源部署的持久卷并附加到新部署。操作指南见此文档。

持久化

使用file对象存储时，默认通过PVC持久化数据。设置persistence.enabled=false可禁用持久化。

Kubernetes集群需默认StorageClass以动态供应卷。可在persistence.storageClass中指定其他StorageClass，或设置persistence.existingClaim使用现有持久卷。

调整持久卷挂载点权限

由于镜像默认以非root用户运行，需调整持久卷所有权使容器可写入。

默认图表使用Kubernetes安全上下文自动更改卷所有权，但并非所有Kubernetes发行版支持。作为替代，设置defaultInitContainers.volumePermissions.enabled=true可启用initContainer调整卷所有权。

部分K8s发行版（如OpenShift）支持动态定义运行initContainer的UID，设置defaultInitContainers.volumePermissions.securityContext.runAsUser=auto即可。

参数

全局参数

通用参数

InfluxDB(TM) Core参数