airhelp/github-crawler

airhelp/github-crawler 镜像说明

镜像概述

本镜像提供一个轻量级微服务，专注于从GitHub API抓取指定数据，并将格式化后的结果发送至Graphite监控系统，帮助用户整合GitHub数据到现有监控分析体系中。

核心功能

1. GitHub API数据抓取：支持获取仓库信息、提交记录、星标变化等多种GitHub资源数据；
2. 数据格式化与转发：将抓取的数据转换为Graphite兼容格式，发送至指定的Graphite服务；
3. 配置化管理：通过环境变量灵活设置API访问令牌、Graphite地址、目标仓库列表等参数。

使用场景

1. 监控GitHub仓库的日常活动（如提交频率、贡献者变化）；
2. 将GitHub指标整合到企业监控平台，进行跨系统数据分析；
3. 自动化收集开源项目数据，用于报表生成或趋势分析。

配置说明

需通过环境变量配置以下参数：

• GITHUB_TOKEN：GitHub API访问令牌（可选，提升API调用限额）；
• GRAPHITE_HOST：Graphite服务的IP或域名；
• GRAPHITE_PORT：Graphite服务的端口（默认2003）；
• REPOS：需抓取的仓库列表（以逗号分隔，如"airhelp/github-crawler,user/repo"）。

部署示例

Docker Run命令

bash
docker run -d \
  --name github-crawler \
  -e GITHUB_TOKEN=your_github_token \
  -e GRAPHITE_HOST=192.168.1.100 \
  -e GRAPHITE_PORT=2003 \
  -e REPOS="airhelp/github-crawler" \
  airhelp/github-crawler

Docker Compose示例

yaml
version: "3"
services:
  github-crawler:
    image: airhelp/github-crawler
    environment:
      - GITHUB_TOKEN=your_github_token
      - GRAPHITE_HOST=graphite-service
      - GRAPHITE_PORT=2003
      - REPOS=airhelp/github-crawler
    depends_on:
      - graphite-service
  graphite-service:
    image: graphiteapp/graphite-statsd
    ports:
      - "8080:80"
      - "2003:2003"