![Docker Pulls]([] ![Quay.io Enabled]([] ![build]([***]

docker-alloy - Grafana Alloy Docker镜像

1. 镜像概述和主要用途

本镜像为Grafana Alloy的容器化部署包，基于最新稳定版Fedora操作系统构建，专为Fedora CoreOS环境设计。Grafana Alloy是轻量级可观测性数据收集器，支持metrics、logs、traces等多类型数据的采集、转换与导出。本镜像旨在简化Grafana Alloy的部署流程，提供标准化、隔离化的运行环境，适用于容器化架构下的监控数据处理场景。

2. 核心功能和特性

• 稳定基础环境：基于最新稳定版Fedora构建，确保与Fedora CoreOS的兼容性及系统安全性。
• 完整功能支持：集成Grafana Alloy全部核心功能，覆盖数据采集、处理、聚合与导出全流程。
• 容器化优势：简化安装配置，隔离运行环境，便于版本控制和快速升级。
• 轻量级设计：优化镜像体积，减少资源占用，适配边缘环境及资源受限场景。
• 灵活配置：支持通过配置文件或环境变量自定义运行参数，满足多样化需求。

3. 使用场景和适用范围

• Fedora CoreOS环境：专为Fedora CoreOS设计，充分适配该操作系统的容器化部署模型。
• 可观测性架构：作为监控数据采集层核心组件，配合Grafana等平台构建完整监控体系。
• 容器化监控：适用于Kubernetes或Docker Swarm等容器集群中的数据收集场景。
• 快速部署需求：满足开发、测试及生产环境中快速搭建Grafana Alloy实例的需求。

4. 使用方法和配置说明

4.1 基础部署（docker run）

通过以下命令启动基础版容器：

docker run -d --name alloy noenv/alloy

参数说明：

• -d：后台运行容器
• --name alloy：指定容器名称为"alloy"
• noenv/alloy：默认拉取latest标签镜像

4.2 高级部署（挂载配置与数据卷）

Grafana Alloy通过配置文件（通常为alloy.yml）定义采集规则。需挂载本地配置文件及数据卷以实现持久化：

docker run -d \
  --name alloy \
  -v /path/to/local/alloy.yml:/etc/alloy/alloy.yml \  # 挂载自定义配置文件
  -v alloy-data:/var/lib/alloy \                     # 持久化存储数据卷
  -p 12345:12345 \                                   # 映射HTTP API端口（默认12345）
  noenv/alloy

关键挂载项：

• 配置文件：默认路径/etc/alloy/alloy.yml，需替换为本地自定义配置
• 数据卷：/var/lib/alloy存储运行时数据，建议通过命名卷持久化

4.3 Docker Compose部署

创建docker-compose.yml配置文件：

version: '3.8'
services:
  alloy:
    image: noenv/alloy
    container_name: alloy
    restart: unless-stopped  # 异常退出自动重启
    volumes:
      - ./alloy.yml:/etc/alloy/alloy.yml  # 本地配置文件映射
      - alloy-data:/var/lib/alloy         # 数据持久化卷
    ports:
      - "12345:12345"  # HTTP API端口
      - "9090:9090"    # Prometheus指标暴露端口（需在配置文件中启用）
    environment:
      - LOG_LEVEL=info  # 日志级别（可选：debug/info/warn/error）

volumes:
  alloy-data:  # 定义命名数据卷

启动服务：

docker-compose up -d

4.4 配置参数与环境变量

4.4.1 配置文件路径

默认配置文件路径：/etc/alloy/alloy.yml
自定义路径可通过启动参数指定：

docker run -d --name alloy noenv/alloy --config.file=/path/to/custom.yml

4.4.2 环境变量

4.5 部署验证

1. 查看容器运行状态：

   docker ps --filter "name=alloy"
   

2. 检查日志输出：

   docker logs -f alloy
   

3. 验证HTTP API可用性（需映射12345端口）：

   curl http://localhost:12345/ready  # 返回"ready"表示服务正常