bitnamicharts/moodle

Bitnami LMS（基于Moodle™ LMS）

Moodle™ LMS是一款开源在线学习管理系统，广泛应用于大学、学校和企业。它采用模块化设计，能高度适应各类在线学习场景。

http://moodle.org/

免责声明：所提及的商标归各自公司所有。我们不提供任何这些产品的商业许可。本列表使用开源许可。Moodle™ LMS由Moodle HQ运营和维护，是与Bitnami完全独立的项目。

TL;DR

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

如需在生产环境中使用Bitnami LMS（基于Moodle™ LMS），请尝试https://bitnami.com/enterprise%EF%BC%8C%E5%8D%B3Bitnami%E7%9B%AE%E5%BD%95%E7%9A%84%E5%95%86%E4%B8%9A%E7%89%88%E6%9C%AC%E3%80%82

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

自2025年8月28日起，Bitnami将升级其公共目录，通过新的https://news.broadcom.com/app-dev/broadcom-introduces-bitnami-secure-images-for-production-ready-containerized-applications%E6%8F%90%E4%BE%9B%E7%B2%BE%E9%80%89%E7%9A%84%E5%BC%BA%E5%8C%96%E3%80%81%E5%AE%89%E5%85%A8%E8%81%9A%E7%84%A6%E9%95%9C%E5%83%8F%E3%80%82%E6%AD%A4%E8%BF%87%E6%B8%A1%E5%8C%85%E6%8B%AC%EF%BC%9A

• 首次向社区用户开放热门容器镜像的安全优化版本。
• 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

简介

此图表使用[***]

它还包含https://github.com/bitnami/charts/tree/main/bitnami/mariadb%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%BC%95%E5%AF%BCMariaDB%E9%83%A8%E7%BD%B2%E4%BB%A5%E6%BB%A1%E8%B6%B3Moodle%E2%84%A2%E5%BA%94%E7%94%A8%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E9%9C%80%E6%B1%82%E3%80%82

前提条件

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

安装图表

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

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

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

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

提示：使用helm list查看所有发布

配置与安装详情

资源请求与限制

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

为简化配置，图表包含resourcesPreset值，可根据不同预设自动设置resources部分。详情参见https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%E3%80%82%E4%BD%86%E5%9C%A8%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E4%B8%AD%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%60resourcesPreset%60%EF%BC%8C%E5%9B%A0%E5%85%B6%E5%8F%AF%E8%83%BD%E6%97%A0%E6%B3%95%E5%AE%8C%E5%85%A8%E9%80%82%E9%85%8D%E5%85%B7%E4%BD%93%E9%9C%80%E6%B1%82%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90%E7%AE%A1%E7%90%86%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/%E3%80%82

更新凭据

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

• 按照[***]
• 使用新值更新密码密钥（替换SECRET_NAME、PASSWORD和SMTP_PASSWORD占位符）

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

Prometheus指标

通过将metrics.enabled设置为true，可将此图表与Prometheus集成。这将在所有Pod中部署带有https://github.com/Lusitaniae/apache_exporter%E7%9A%84%E8%BE%B9%E8%BD%A6%E5%AE%B9%E5%99%A8%EF%BC%8C%E4%BB%A5%E5%8F%8A%E5%8F%AF%E5%9C%A8%60metrics.service%60%E9%83%A8%E5%88%86%E9%85%8D%E7%BD%AE%E7%9A%84%60metrics%60%E6%9C%8D%E5%8A%A1%E3%80%82%E8%AF%A5%60metrics%60%E6%9C%8D%E5%8A%A1%E5%8C%85%E5%90%AB%E5%BF%85%E8%A6%81%E7%9A%84%E6%B3%A8%E8%A7%A3%EF%BC%8C%E5%8F%AF%E8%A2%ABPrometheus%E8%87%AA%E5%8A%A8%E6%8A%93%E5%8F%96%E3%80%82

Prometheus要求

集成需确保Prometheus或Prometheus Operator已正确安装。可安装https://github.com/bitnami/charts/tree/main/bitnami/prometheus%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%E4%BB%A5%E5%BF%AB%E9%80%9F%E6%90%AD%E5%BB%BAPrometheus%E7%8E%AF%E5%A2%83%E3%80%82

与Prometheus Operator集成

通过设置metrics.serviceMonitor.enabled=true，图表可部署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%E5%8F%AF%E8%8E%B7%E5%8F%96%E5%BF%85%E8%A6%81%E7%9A%84CRD%E5%92%8CPrometheus Operator。

https://techdocs.broadcom.com/us/en/vmware-tanzu/application-catalog/tanzu-application-catalog/services/tac-doc/apps-tutorials-understand-rolling-tags-containers-index.html

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

当主容器有新版本、重大变更或严重漏洞时，Bitnami会发布新图表以更新其容器。

无TLS的Ingress

使用Ingress（无TLS示例）：

console
ingress.enabled=True
ingress.hosts[0]=moodle.domain.com
serviceType=ClusterIP
moodleUsername=admin
moodlePassword=password
mariadb.mariadbRootPassword=secretpassword

使用Ingress时的3个必填参数：ingress.enabled=True、ingress.hosts[0]=moodle.domain.com和serviceType=ClusterIP

Ingress TLS

如果集群支持自动创建/获取TLS证书，请参考相应机制的文档。

要手动配置TLS，首先为目标地址创建/获取密钥和证书对，然后在命名空间中创建TLS密钥（本例中命名为moodle-server-tls）。在自定义values.yaml文件的Ingress TLS部分中包含密钥名称和目标主机名：

yaml
ingress:
  ## 如果为true，将创建Moodle(TM)服务器Ingress
  ##
  enabled: true

  ## Moodle(TM)服务器Ingress注解
  ##
  annotations: {}
  #   kubernetes.io/ingress.class: nginx
  #   kubernetes.io/tls-acme: 'true'

  ## Moodle(TM)服务器Ingress主机名
  ## 启用Ingress时必须提供
  ##
  hosts:
    - moodle.domain.com

  ## Moodle(TM)服务器Ingress TLS配置
  ## 密钥必须在命名空间中手动创建
  ##
  tls:
    - secretName: moodle-server-tls
      hosts:
        - moodle.domain.com

备份与恢复

要在Kubernetes上备份和恢复Helm图表部署，需使用Kubernetes备份/恢复工具https://velero.io/%E5%A4%87%E4%BB%BD%E6%BA%90%E9%83%A8%E7%BD%B2%E7%9A%84%E6%8C%81%E4%B9%85%E5%8D%B7%EF%BC%8C%E5%B9%B6%E5%B0%86%E5%85%B6%E9%99%84%E5%8A%A0%E5%88%B0%E6%96%B0%E9%83%A8%E7%BD%B2%E3%80%82%E4%BD%BF%E7%94%A8Velero%E7%9A%84%E8%AF%A6%E7%BB%86%E8%AF%B4%E6%98%8E%E5%8F%82%E8%A7%81https://techdocs.broadcom.com/us/en/vmware-tanzu/application-catalog/tanzu-application-catalog/services/tac-doc/apps-tutorials-backup-restore-deployments-velero-index.html%E3%80%82

持久化

https://github.com/bitnami/containers/tree/main/bitnami/moodle%E5%B0%86Moodle%E2%84%A2%E6%95%B0%E6%8D%AE%E5%92%8C%E9%85%8D%E7%BD%AE%E5%AD%98%E5%82%A8%E5%9C%A8%E5%AE%B9%E5%99%A8%E7%9A%84%60/bitnami/moodle%60%E5%92%8C%60/bitnami/apache%60%E8%B7%AF%E5%BE%84%E4%B8%8B%E3%80%82

持久卷声明（PVC）用于在部署间保留数据，已知在GCE、AWS、vSphere和minikube中可用。 参见参数部分配置PVC或禁用持久化。 建议查看https://kubernetes.io/docs/tasks/administer-cluster/change-pv-reclaim-policy/%E5%B9%B6%E6%A0%B9%E6%8D%AE%E9%9C%80%E8%A6%81%E6%9B%B4%E6%96%B0%E3%80%82%E9%BB%98%E8%AE%A4%E7%AD%96%E7%95%A5%E4%B8%BA%E5%88%A0%E9%99%A4%EF%BC%8C%E5%8D%B8%E8%BD%BDMoodle%E2%84%A2%E6%97%B6%E6%95%B0%E6%8D%AE%E4%B9%9F%E4%BC%9A%E8%A2%AB%E7%A7%BB%E9%99%A4%E3%80%82

参数

全局参数

通用参数

Moodle™参数

注意：此图表的README超出了DockerHub的25000字符限制，已被截断。完整README可参见https://github.com/bitnami/charts/blob/main/bitnami/moodle/README.md