promhippie/prometheus-scw-sd

Prometheus Scaleway SD

镜像概述和主要用途

Prometheus Scaleway SD 是一个服务发现工具，提供服务器以自动发现 Scaleway 账户中的节点，并以 Prometheus 服务发现(SD)兼容格式输出。该工具专为在 Prometheus 监控环境中集成 Scaleway 云资源而设计，实现对 Scaleway 节点的自动化监控配置。

核心功能和特性

• 自动发现 Scaleway 账户中的节点资源
• 输出 Prometheus 服务发现兼容格式
• 多平台部署支持（二进制、包管理、容器化）
• 支持热重载，代码变更时自动重启/重新加载服务
• 提供多种部署渠道（GHCR、Docker Hub、Quay）

使用场景和适用范围

• 在 Scaleway 云平台环境中部署 Prometheus 监控系统
• 需要动态发现和监控 Scaleway 上的节点和服务
• 适用于需要自动化监控配置的环境
• 适合多云或混合云架构中的监控统一管理
• 适用于需要动态扩展的云原生环境

详细的使用方法和配置说明

安装方式

二进制安装

可从 https://github.com/promhippie/prometheus-scw-sd/releases 下载预构建二进制文件。

包管理器安装

项目提供 DEB 和 RPM 包仓库，可在 Cloudsmith 获取。

容器化部署

可使用发布在以下平台的容器镜像：

• https://github.com/promhippie/prometheus-scw-sd/pkgs/container/prometheus-scw-sd
• https://hub.docker.com/r/promhippie/prometheus-scw-sd/tags/
• Quay

Docker 部署方案

使用 docker run 命令部署

bash
docker run -d \
  --name prometheus-scw-sd \
  -p 9000:9000 \
  -e SCW_ACCESS_KEY=your-scaleway-access-key \
  -e SCW_SECRET_KEY=your-scaleway-secret-key \
  -e SCW_REGION=fr-par \
  promhippie/prometheus-scw-sd:latest

docker-compose 配置示例

yaml
version: '3.8'

services:
  prometheus-scw-sd:
    image: promhippie/prometheus-scw-sd:latest
    container_name: prometheus-scw-sd
    restart: always
    ports:
      - "9000:9000"
    environment:
      - SCW_ACCESS_KEY=your-scaleway-access-key
      - SCW_SECRET_KEY=your-scaleway-secret-key
      - SCW_REGION=fr-par
      - LOG_LEVEL=info
      - SERVER_PORT=9000
      - SCRAPE_INTERVAL=60s
    volumes:
      - ./config:/etc/prometheus-scw-sd

配置参数和环境变量

使用方法

1. 启动服务后，访问 http://localhost:9000 查看服务状态
2. Prometheus 配置示例：

yaml
scrape_configs:
  - job_name: 'scaleway-nodes'
    file_sd_configs:
      - files: ['http://localhost:9000/scrape?job=node']

开发指南

环境要求

• Go (>= 1.24.0)
• Nix (可选)
• go-task (构建工具)

构建步骤

console
git clone https://github.com/promhippie/prometheus-scw-sd.git
cd prometheus-scw-sd

task generate build
./bin/prometheus-scw-sd -h

使用 Nix 开发环境

console
cat << EOF > .envrc
use flake . --impure --extra-experimental-features nix-command
EOF

direnv allow

启动开发服务器：

console
task watch

开发服务器将运行在 http://localhost:9000，支持热重载。

或者使用 devenv：

console
devenv up

安全与贡献

安全问题

如发现安全问题，请首先联系 ***。

贡献指南

贡献流程：Fork -> Patch -> Push -> Pull Request

许可证

Apache-2.0

版权信息

Copyright (c) 2018 Thomas Boerger <***>