Monasca Persister Docker镜像文档

镜像概述

本镜像包含Monasca Persister的容器化版本。Monasca Persister是Monasca监控系统的核心组件，负责将监控指标持久化存储到数据库中。

该工具提供两种实现方式：

• Python实现（标签为-python或默认无标签）- Dockerfile
• Java实现（标签为-java）- Dockerfile

当前推荐使用Python版本的镜像。有关Monasca项目的更多信息，请参见项目wiki。

源代码仓库：monasca-persister · monasca-docker

标签约定

本仓库中的镜像遵循以下标签约定：

• latest：指向最新稳定Python版本，例如1.3.0-python
• latest-python、latest-java：分别指向Python或Java实现的最新稳定版本，例如1.3.0
• 语义化版本标签：如1.3.0、1.3、1，基于***仓库的git标签
• 1.3.0-python、1.3-python、1-python：同上，但明确指向Python实现的版本
• OpenStack版本名标签：如mitaka、newton等，基于仓库中stable/版本名分支的最新代码构建
• mitaka-python、newton-python：同上，但明确指向Python实现的版本
• master、master-DATESTAMP：从master分支构建的不稳定版本，不建议用于生产环境

除非另有说明，所有镜像均为Python实现。Java实现的镜像会明确标记-java后缀。

使用方法

运行Monasca Persister需要连接到正常运行的Zookeeper、Kafka以及数据库（如InfluxDB）。为实现完整功能，还需一个或多个monasca-api实例向Kafka主题输出指标数据。

在类似***Kubernetes环境的部署场景中，无需额外配置参数，可直接运行：

bash
docker run -it monasca/persister:latest

配置说明

环境变量

自定义配置文件

如需覆盖更多配置值，可通过挂载文件替换/etc/monasca-persister/persister.conf.j2（Jinja2模板）。若不需要Jinja2格式化，可设置环境变量CONFIG_TEMPLATE=false。注意：即使禁用Jinja2，仍需覆盖.j2后缀的模板文件，因为容器会在运行时将模板复制为最终配置文件。

配置文件模板源码可在仓库中查看。运行时可通过以下命令查看生成的最终配置文件：

bash
docker exec -it <容器ID> cat /etc/monasca-persister/persister.conf