Bitnami打包的Discourse®

Discourse是一个开源讨论平台，内置审核和治理系统，即使没有***版主，讨论社区也能保护自己免受不良行为者的侵扰。

Discourse®概述

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

快速开始

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

希望在生产环境中使用Discourse®？请尝试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公告。

简介

本Chart使用Helm包管理器在Kubernetes集群上引导Discourse部署。

它还包含Bitnami Postgresql和Bitnami Redis®，这两者是Discourse应用所需的数据库。

前提条件

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

安装Chart

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

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

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

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

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

配置和安装详情

资源请求和限制

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

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

滚动标签与不可变标签

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

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

更新凭证

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

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

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

设置复制

默认情况下，本Chart仅部署一个运行Discourse的Pod。如果您想增加副本数量，可以按照以下简单步骤确保一切顺利运行：

提示：执行这些步骤可确保PostgreSQL实例正确填充数据。如果您已有初始化的数据库，可以直接创建具有所需副本数量的发布。请记住设置discourse.skipInstall为true！

1. 创建常规发布，稍后进行扩展：

   console
   helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/discourse
   ...
   

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

2. 等待发布完成且Discourse成功运行。

   console
   $ kubectl get pods
   NAME                               READY   STATUS    RESTARTS   AGE
   my-release-discourse-744c48dd97-wx5h9   2/2     Running   0          5m11s
   my-release-postgresql-0                 1/1     Running   0          5m10s
   my-release-redis-master-0               1/1     Running   0          5m11s
   

3. 执行升级，指定副本数量和使用的凭证。

   console
   helm upgrade my-release --set replicaCount=2,discourse.skipInstall=true oci://REGISTRY_NAME/REPOSITORY_NAME/discourse
   

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

   注意，要使此操作正常工作，您需要提供ReadWriteMany PVC。如果没有此类存储的供应器，建议安装NFS供应器Chart（使用正确参数，如persistence.enabled=true和persistence.size=10Gi）并将其映射到RWO卷。

   然后，您可以使用以下参数部署Discourse Chart：

   console
   persistence.storageClass=nfs
   postgresql.primary.persistence.storageClass=nfs
   

安装插件

您可以在发布安装期间通过discourse.plugins参数列出所需的插件仓库，从而安装自定义Discourse插件。例如：

yaml
discourse:
  plugins:
  - [***]

注意：默认情况下，插件在首次安装后会被持久化，因此后续升级无法更新它们。如果希望每次升级时更新插件，请将discourse.persistPlugins参数设置为false。

边车容器

如果需要在Discourse所在的同一Pod中运行额外容器（例如指标或日志导出器），可以通过sidecars配置参数实现。只需根据Kubernetes容器规范定义容器即可。

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

如果这些边车容器导出额外端口，可以使用service.extraPorts值添加额外端口定义：

yaml
service:
  ...
  extraPorts:
  - name: extraPort
    port: ***
    targetPort: ***

使用外部数据库

有时您可能希望Discourse连接到外部数据库，而不是在集群内安装数据库，例如使用托管数据库服务，或为所有应用运行单个数据库服务器。为此，Chart允许您在externalDatabase参数下指定外部数据库的凭证。您还应使用postgresql.enabled选项禁用PostgreSQL安装。例如，使用以下参数：

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

注意，如果按上述方式禁用PostgreSQL，您必须提供externalDatabase连接的值。

如果数据库已包含来自先前Discourse安装的数据，需要将discourse.skipInstall参数设置为true。否则，容器将执行安装向导，并可能修改数据库中的现有数据。此参数强制容器不执行Discourse安装向导。

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

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

Ingress

本Chart支持Ingress资源。如果集群上安装了Ingress控制器（如nginx-ingress-controller或contour），您可以利用Ingress控制器为应用提供服务。要启用Ingress集成，需将ingress.enabled设置为true。

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

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

注意：对于ingress.extraHosts参数中指定的每个主机，需要设置名称、路径以及Ingress控制器应了解的任何注解。并非所有注解都受所有Ingress控制器支持，但此注解参考文档列出了许多流行Ingress控制器支持的注解。

添加TLS参数（如可用）将使Chart生成HTTPS URL，应用将在443端口上可用。但在TLS密钥存在之前，Ingress记录无法工作。

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

使用TLS保护流量

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

• 基于Chart参数生成证书密钥。
• 启用外部生成的证书。
• 通过外部服务（如cert-manager）管理应用证书。
• 在Chart内创建自签名证书（如果支持）。

在前两种情况下，需要证书和密钥。文件应为.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参数设置的主机名）。
• 如果集群有cert-manager附加组件用于自动管理和颁发TLS证书，可将相应注解添加到*.ingress.annotations。
• 如果使用Helm创建的自签名证书，需将*.ingress.tls和*.ingress.selfSigned都设置为true。

设置Pod亲和性

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

作为替代方案，您可以使用bitnami/common Chart中提供的Pod亲和性、Pod反亲和性和节点亲和性的预设配置。为此，设置podAffinityPreset、podAntiAffinityPreset或nodeAffinityPreset参数。

备份和恢复

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

持久化

Bitnami Discourse镜像将Discourse数据和配置存储在容器的/bitnami路径下。

持久卷声明用于在部署之间保留数据。此功能在GCE、AWS和minikube上已知可正常工作。有关配置PVC或禁用持久化的信息，请参见参数部分。

参数

全局参数

通用参数