Bitnami Matomo 软件包

Matomo（前身为Piwik）是一款实时网络分析程序，提供网站访客的详细报告。

Matomo 概述

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

快速入门

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

希望在生产环境中使用Matomo？请尝试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集群上引导Matomo部署。

它还打包了Bitnami MariaDB Chart，这是引导MariaDB部署作为Matomo应用数据库所必需的。

前提条件

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

安装Chart

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

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

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

该命令使用默认配置在Kubernetes集群上部署Matomo。参数部分列出了可在安装期间配置的参数。

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

配置和安装详情

资源请求和限制

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

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

更新凭证

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

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

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

Prometheus指标

通过将metrics.enabled设置为true，此Chart可与Prometheus集成。这将在所有Pod中部署带有apache-exporter的边车容器，以及可在metrics.service部分配置的metrics服务。该metrics服务将具有必要的注解，可被Prometheus自动抓取。

Prometheus要求

集成工作需要Prometheus或Prometheus Operator的正常安装。安装Bitnami Prometheus helm chart或Bitnami Kube Prometheus helm chart，可在集群中轻松获得正常工作的Prometheus。

与Prometheus Operator集成

该Chart可部署ServiceMonitor对象，以与Prometheus Operator安装集成。为此，需将值metrics.serviceMonitor.enabled设置为true。确保集群中已安装Prometheus Operator CustomResourceDefinitions，否则将失败并显示以下错误：

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

安装Bitnami Kube Prometheus helm chart以获取必要的CRD和Prometheus Operator。

滚动标签与不可变标签

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

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

镜像

image参数允许指定Chart将拉取的镜像。

私有仓库

如果将image值配置为私有仓库中的镜像，则需要指定镜像拉取密钥。

1. 在命名空间中手动创建镜像拉取密钥。参见this YAML example reference。有关获取适当密钥的信息，请咨询您的镜像仓库文档。

2. 注意，当前无法使用--set参数将imagePullSecrets配置值传递给helm，因此必须使用values.yaml文件提供这些值，例如：

   yaml
   imagePullSecrets:
     - name: SECRET_NAME
   

3. 安装Chart

设置Pod亲和性

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

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

备份和恢复

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

持久性

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

持久卷声明（Persistent Volume Claims）用于跨部署保留数据，已知在GCE、AWS和minikube中可用。 有关配置PVC或禁用持久性的信息，请参见参数部分。

现有PersistentVolumeClaim

1. 创建PersistentVolume
2. 创建PersistentVolumeClaim
3. 安装Chart

console
helm install my-release --set persistence.existingClaim=PVC_NAME oci://REGISTRY_NAME/REPOSITORY_NAME/matomo

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

主机路径

系统兼容性

• 使用hostPath的Pod中容器对本地文件系统的可访问性已在OSX/MacOS（使用xhyve）和Linux（使用VirtualBox）上测试通过。
• Windows尚未使用支持的VM驱动程序进行测试。不过，Minikube***支持Mounting Host Folders（每个Pod）。或者，您可以使用docker-sync或docker-bg-sync等工具，在主机文件更改时手动同步容器。

挂载步骤

1. 指定的hostPath目录必须已存在（如不存在，请创建）。

2. 安装Chart

   console
   helm install my-release --set persistence.hostPath=/PATH/TO/HOST/MOUNT oci://REGISTRY_NAME/REPOSITORY_NAME/matomo
   

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

   这会将matomo-data卷挂载到hostPath目录中。如果挂载路径包含有效数据，站点数据将被持久化；否则，将在首次启动时初始化站点数据。

3. 由于容器无法控制主机目录权限，您必须自行设置Matomo文件目录权限。

参数

全局参数

通用参数

Matomo参数

注意：此Chart的README超出DockerHub 25000字符限制，已被截断。完整README可在[***]