bitnamicharts/superset

Bitnami Apache Superset 镜像文档

镜像概述和主要用途

Apache Superset 是一个现代数据探索和数据可视化平台。Bitnami 提供的 Apache Superset 镜像使您能够轻松在 Kubernetes 集群中部署和运行 Superset。

Apache Superset 官方网站

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

核心功能和特性

• 快速部署：通过 Helm Chart 实现一键部署到 Kubernetes 集群
• 可扩展性：支持配置多个 Web 服务器副本
• 外部集成：支持连接外部数据库和 Redis 实例
• 安全性：可配置的认证机制和安全上下文
• 灵活性：支持自定义环境变量、Sidecar 容器和初始化容器
• 网络配置：支持 Ingress 资源集成
• 资源优化：可配置 Pod 亲和性和反亲和性规则

使用场景和适用范围

• 数据分析师和数据科学家进行数据探索和可视化
• 企业内部构建数据仪表盘和报表系统
• 开发和测试环境中的数据可视化需求
• 需要快速部署和扩展的数据可视化平台

详细使用方法和配置说明

快速启动 (TL;DR)

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

如需在生产环境中使用 Superset，建议尝试 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 用户的安全态势。

前提条件

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

安装 Chart

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

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

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

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

提示：使用 helm list 命令列出所有发布版本

配置和安装详情

滚动标签与不可变标签

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

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

外部数据库支持

您可能希望让 Superset 连接到外部数据库，而不是在集群内安装一个。典型原因包括使用托管数据库服务或为所有应用程序共享一个公共数据库服务器。要实现这一点，chart 允许您使用 externalDatabase 参数 指定外部数据库的凭据。您还应使用 postgresql.enabled 选项禁用 MariaDB 安装。示例如下：

console
postgresql.enabled=false
externalDatabase.host=myexternalhost
externalDatabase.user=myuser
externalDatabase.password=mypassword
externalDatabase.database=mydatabase
externalDatabase.port=5432

类似地，您可以指定外部 Redis® 实例，而不是在集群内安装一个。首先，您可以使用 redis.enabled 选项禁用 Redis® 安装。如上所述，使用提供的参数提供您的实例数据：

console
redis.enabled=false
externalRedis.host=myexternalhost
externalRedis.password=mypassword
externalRedis.port=6379

Ingress

此 chart 提供对 Ingress 资源的支持。如果您的集群上安装了 ingress 控制器，例如 https://github.com/bitnami/charts/tree/main/bitnami/nginx-ingress-controller 或 https://github.com/bitnami/charts/tree/main/bitnami/contour%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%88%A9%E7%94%A8 ingress 控制器来提供应用程序服务。要启用 Ingress 集成，请将 ingress.enabled 设置为 true。

最常见的场景是将一个主机名映射到部署。在这种情况下，可以使用 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 列出了许多流行 Ingress 控制器支持的注解。

添加 TLS 参数（如果可用）将导致 chart 生成 HTTPS URL，应用程序将在端口 443 上可用。TLS 密钥不必由此 chart 生成。但是，如果启用了 TLS，则 Ingress 记录在 TLS 密钥存在之前将无法工作。

了解有关 Ingress 控制器的更多信息。

额外环境变量

如果您想添加额外的环境变量（对于高级操作如自定义初始化脚本很有用），可以使用 extraEnvVars 属性。

yaml
web:
  extraEnvVars:
    - name: LOG_LEVEL
      value: error

或者，您可以使用 ConfigMap 或 Secret 存储环境变量。为此，请使用 extraEnvVarsCM 或 extraEnvVarsSecret 值。

Sidecar 容器

如果在 Superset 所在的同一个 pod 中需要额外的容器（例如额外的指标或日志导出器），可以使用 *.sidecars 参数定义它们，其中 * 对应于 chart 部署的每个 pod 的部分，例如 web、worker、beat、flower、init。

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

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

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

如果需要在同一个 pod 中添加额外的初始化容器，可以使用 *.initContainers 参数定义它们。以下示例在 Superset web pod 中添加了一个额外的初始化容器：

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

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

Pod 亲和性

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

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

参数

全局参数

通用参数

Superset 参数

注意：此 chart 的完整 README 超出了 DockerHub 的长度限制，完整文档可在 https://github.com/bitnami/charts/blob/main/bitnami/superset/README.md 查看。