zguydev/mimir-healthcheck

mimir-healthcheck

带有健康检查的Grafana Mimir镜像

源代码：https://github.com/zguydev/mimir-healthcheck

概述

本仓库提供了一个基于grafana/mimir的轻量级Docker镜像，添加了Docker健康检查功能。由于Grafana Mimir团队决定仅针对Kubernetes部署（参见https://github.com/grafana/mimir/issues/9034#issuecomment-2304042358%EF%BC%89%EF%BC%8C%E5%9B%A0%E6%AD%A4%E6%9C%AC%E9%95%9C%E5%83%8F%E4%B8%93%E4%B8%BADocker/Podman%E7%94%A8%E6%88%B7%E8%AE%BE%E8%AE%A1%E3%80%82

核心功能与特性

默认健康检查配置

• 端口：9009
• 检查间隔：3s
• 超时时间：2s
• 重试次数：10

容器内Mimir默认监听9009端口。如果修改了内部端口，必须覆盖健康检查命令：使用Docker CLI时通过--health-cmd标志，使用Docker Compose时通过healthcheck指令。

使用场景

适用于在Docker或Podman环境中部署Grafana Mimir，需要健康检查功能以确保服务可用性的场景，尤其适合非Kubernetes环境的用户。

使用方法

快速开始

拉取镜像：

bash
docker pull zguydev/mimir-healthcheck:latest

运行容器：

bash
docker run --rm \
  -p 9009:9009 \
  -v ./config.yaml:/etc/mimir/config.yaml:ro \
  zguydev/mimir-healthcheck:latest \
  -config.file=/etc/mimir/config.yaml

Docker Compose示例

yaml
services:
  mimir:
    image: zguydev/mimir-healthcheck:latest
    command: ["-config.file=/etc/mimir/config.yaml"]
    volumes:
      - ./config.yaml:/etc/mimir/config.yaml
    ports:
      - "9009:9009"
    healthcheck:
      test: ["CMD", "/healthcheck", "--port", "9009"] # 如果在Mimir配置中修改了端口，请覆盖此处的端口参数
    restart: unless-stopped

构建特定基础镜像版本

如果需要使用zguydev/mimir-healthcheck标签未提供的基础镜像版本（2.15.0之前的版本需手动构建），可按以下方法操作：

bash
git clone https://github.com/zguydev/mimir-healthcheck
cd mimir-healthcheck
TAG='2.17.0' # 要使用的标签
docker build \
  --build-arg MIMIR_IMAGE_TAG=$TAG \
  -t mimir-healthcheck:$TAG .

版本标签

zguydev/mimir-healthcheck镜像标签与上游Mimir的语义化版本同步，包括稳定版（如2.17.0）和预发布版（如2.17.0-rc.0）。仅最新稳定版会获得latest标签。

镜像发布于GitHub Container Registry，并同步至https://hub.docker.com/r/zguydev/mimir-healthcheck%E3%80%82

注意事项

本镜像仅在容器内构建并添加自定义健康检查二进制文件，不会改变Mimir的配置或运行方式。

许可证

MIT - 详见https://github.com/zguydev/mimir-healthcheck/blob/main/LICENSE