cleanstart/prometheus-mysqld-exporter

CleanStart Prometheus-Mysqld-Exporter 容器文档

CleanStart Prometheus-Mysqld-Exporter镜像提供生产就绪、安全加固的数据库监控工具，基于最小化的CleanStart OS构建，适用于企业环境，具备高级安全特性和可靠的指标收集能力。

📌 基础框架：来自CleanStart的生产级容器。

镜像路径：cleanstart/prometheus-mysqld-exporter
镜像仓库：CleanStart Registry

拉取最新镜像

从仓库下载容器镜像：

bash
docker pull cleanstart/prometheus-mysqld-exporter:latest

bash
docker pull cleanstart/prometheus-mysqld-exporter:latest-dev

注意：cleanstart/prometheus-mysqld-exporter:latest版本不支持上游mysqld_exporter使用的标准DATA_SOURCE_NAME环境变量，而是需要将.my.cnf配置文件挂载到容器中，并通过--config.my-cnf=<路径>参数传递。解决方法：创建包含[client]部分（用户、密码、主机、端口）的Kubernetes ConfigMap，将其作为卷挂载，并在容器参数中添加--config.my-cnf=/etc/mysql/.my.cnf。

在主机创建.my.cnf文件

bash
cat > /tmp/.my.cnf << 'EOF'
[client]
user=exporter
password=exporterpassword
host=mysql-host
port=3306
EOF

基础运行

使用基础配置运行容器：

bash
docker run -it --name prometheus-mysqld-exporter \
  -v /tmp/.my.cnf:/etc/mysql/.my.cnf:ro \
  cleanstart/prometheus-mysqld-exporter:latest \
  --config.my-cnf=/etc/mysql/.my.cnf

生产部署

使用生产级安全设置部署：

bash
docker run -d --name prometheus-mysqld-exporter-prod \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  --restart unless-stopped \
  -p 9104:9104 \
  -v /tmp/.my.cnf:/etc/mysql/.my.cnf:ro \
  cleanstart/prometheus-mysqld-exporter:latest \
  --config.my-cnf=/etc/mysql/.my.cnf

卷挂载

挂载本地目录以持久化数据：

bash
docker run -v /app:/app \
  -v /tmp/.my.cnf:/etc/mysql/.my.cnf:ro \
  cleanstart/prometheus-mysqld-exporter:latest \
  --config.my-cnf=/etc/mysql/.my.cnf

端口转发

使用自定义端口映射运行：

bash
docker run -p 9104:9104 \
  -v /tmp/.my.cnf:/etc/mysql/.my.cnf:ro \
  cleanstart/prometheus-mysqld-exporter:latest \
  --config.my-cnf=/etc/mysql/.my.cnf

启用额外收集器

启用特定的MySQL指标收集器：

bash
docker run -d --name prometheus-mysqld-exporter-full \
  -p 9104:9104 \
  -v /tmp/.my.cnf:/etc/mysql/.my.cnf:ro \
  cleanstart/prometheus-mysqld-exporter:latest \
  --config.my-cnf=/etc/mysql/.my.cnf \
  --collect.global_status \
  --collect.global_variables \
  --collect.info_schema.innodb_metrics \
  --collect.info_schema.tables \
  --collect.perf_schema.eventsstatements

Kubernetes安全上下文

Kubernetes部署推荐的安全上下文：

yaml
securityContext:
  allowPrivilegeEscalation: false
  capabilities:
    drop:
    - ALL
  readOnlyRootFilesystem: true
  runAsUser: 1000
  runAsGroup: 1000

文档资源

重要链接和参考资源：

• 容器仓库：[***]
• MySQL文档：[***]
• CleanStart社区镜像：https://hub.docker.com/u/cleanstart
• CleanStart镜像运行指南及示例项目：https://github.com/cleanstart-containers
  • 如何使用Dockerfile运行示例项目
  • 如何通过Kubernetes YAML部署
  • 如何从公共镜像迁移到CleanStart镜像

漏洞免责声明

CleanStart提供的Docker镜像包含由独立贡献者维护的第三方开源库和包。尽管CleanStart维护这些镜像并应用行业标准的安全实践，但无法保证其控制范围之外的上游组件的安全性或完整性。

用户确认并同意，开源软件可能包含未被发现的漏洞，或通过更新引入新风险。CleanStart不对源自第三方库的安全问题负责，包括但不限于零日漏洞、供应链***或贡献者引入的风险。

安全是共同责任：CleanStart会在可能的情况下提供更新的镜像和指导，而用户负责评估部署并实施适当的控制措施。