viadee/docker-hub-rate-limit-exporter

Docker Hub速率限制导出器Helm Chart

镜像概述和主要用途

本仓库提供现成的Docker镜像和Helm Chart，使Prometheus能够抓取Docker Hub的速率限制指标。更多背景信息可参考https://blog.viadee.de/en/monitoring-the-docker-hub-rate-limit-with-prometheus%E3%80%82

注：本仓库内容基于GitLab的工作（详见其https://about.gitlab.com/blog/2020/11/18/docker-hub-rate-limit-monitoring/%EF%BC%89%EF%BC%8CPython%E8%84%9A%E6%9C%AC%E7%9A%84%E5%8E%9F%E5%A7%8B%E6%9D%A5%E6%BA%90%E5%8F%AF%E5%9C%A8https://gitlab.com/gitlab-com/marketing/corporate_marketing/developer-evangelism/code/docker-hub-limit-exporter%E6%89%BE%E5%88%B0%E3%80%82

核心功能和特性

• 支持Prometheus抓取Docker Hub速率限制指标
• 提供Helm Chart便于在Kubernetes集群中部署
• 可配置Docker Hub凭证（用户名和访问令牌）
• 支持与Prometheus Operator集成（通过ServiceMonitor资源）

使用场景和适用范围

适用于需要监控Docker Hub速率限制的Kubernetes集群环境，特别是使用Prometheus进行监控的场景，帮助用户及时了解Docker Hub的拉取限制情况，避免因超出限制导致镜像拉取失败。

详细使用方法和配置说明

安装Helm Chart

Helm Chart可通过本仓库托管在GitHub Pages上的Helm仓库安装，步骤如下：

1. 添加Helm仓库：

   bash
   helm repo add viadee https://viadee.github.io/docker-hub-rate-limit-exporter
   

2. 安装Chart：

   bash
   helm install <release-name> viadee/docker-hub-rate-limit-exporter
   

配置Docker凭证

若Kubernetes集群未使用Docker Hub认证，无需额外配置。若已认证，需通过Helm values配置凭证（导出器不使用集群Docker上下文关联的Docker Hub账户）：

1. 参考仓库示例创建Helm values文件（见：chart/values.yaml）

2. 填写dockerhubUsername和dockerhubPassword变量（推荐使用Docker Hub访问令牌作为密码）

3. 升级Helm发布：

   bash
   helm upgrade <release-name> viadee/docker-hub-rate-limit-exporter --install --namespace=<目标命名空间> -f <values文件名>
   

配置Prometheus抓取指标

推荐使用Prometheus Kubernetes Operator（详见https://github.com/prometheus-operator/prometheus-operator%EF%BC%89%EF%BC%8C%E9%80%9A%E8%BF%87%E5%88%9B%E5%BB%BA%60ServiceMonitor%60%E8%B5%84%E6%BA%90%E9%85%8D%E7%BD%AEPrometheus%E6%8A%93%E5%8F%96%E6%8C%87%E6%A0%87%EF%BC%9A

1. 使用上述values文件或参考仓库示例（chart/values.yaml）

2. 将serviceMonitor.enabled设置为true

3. 根据Prometheus Operator配置，可能需要设置serviceMonitor.additionalLabels以指定Prometheus抓取规则

4. 若Prometheus Operator配置为监控特定命名空间的ServiceMonitor，可通过serviceMonitor.namespace指定部署ServiceMonitor的命名空间

5. 升级Helm发布：

   bash
   helm upgrade <release-name> viadee/docker-hub-rate-limit-exporter --install --namespace=<目标命名空间> -f <values文件名>
   

若未使用Prometheus Operator，需手动配置Prometheus以抓取指标。

协作信息

本Helm Chart由viadee Unternehmensberatung AG开发。如需了解更多我们的工作，可访问https://www.viadee.de/en/solutions/cloud%E3%80%82

如有反馈、想法或扩展需求，欢迎创建GitHub Issue。