ephillipe/grafana

Grafana Docker镜像

镜像概述和主要用途

该Docker镜像包含Grafana的最新主版本构建，用于快速部署开源数据可视化和监控平台。通过容器化方式，可便捷地搭建仪表盘系统，支持多种数据源整合与数据展示。

核心功能和特性

• 支持通过环境变量覆盖conf/grafana.ini中的所有配置选项
• 提供持久化存储方案，确保 Grafana 数据不丢失
• 支持安装 Grafana 插件，扩展平台功能
• 可指定特定版本的 Grafana 运行
• 支持配置 AWS 凭证，集成 CloudWatch 监控

使用场景和适用范围

适用于需要快速搭建数据可视化仪表盘、监控系统的场景，如 DevOps 监控、服务器性能监控、业务数据展示等，适合开发、测试和生产环境使用。

使用方法和配置说明

运行Grafana容器

启动容器并绑定外部端口3000：

bash
docker run -d --name=grafana -p 3000:3000 grafana/grafana

默认管理员用户为admin/admin，可通过http://localhost:3000访问。

配置Grafana容器

所有在conf/grafana.ini中定义的选项都可以通过环境变量覆盖，例如：

bash
docker run \
  -d \
  -p 3000:3000 \
  --name=grafana \
  -e "GF_SERVER_ROOT_URL=http://grafana.server.name" \
  -e "GF_SECURITY_ADMIN_PASSWORD=secret" \
  grafana/grafana

使用持久化存储的Grafana容器（推荐）

bash
# 创建/var/lib/grafana作为持久卷存储
docker run -d -v /var/lib/grafana --name grafana-storage busybox:latest

# 启动Grafana
docker run \
  -d \
  -p 3000:3000 \
  --name=grafana \
  --volumes-from grafana-storage \
  grafana/grafana

为Grafana 3安装插件

通过GF_INSTALL_PLUGINS环境变量传递要安装的插件（逗号分隔列表），这将为每个插件执行grafana-cli plugins install ${plugin}：

bash
docker run \
  -d \
  -p 3000:3000 \
  --name=grafana \
  -e "GF_INSTALL_PLUGINS=grafana-clock-panel,grafana-simple-json-datasource" \
  grafana/grafana

运行特定版本的Grafana

bash
# 指定正确的标签，例如2.6.0 - 查看Docker Hub获取可用标签
docker run \
  -d \
  -p 3000:3000 \
  --name grafana \
  grafana/grafana:2.6.0

配置AWS凭证以支持CloudWatch

bash
docker run \
  -d \
  -p 3000:3000 \
  --name=grafana \
  -e "GF_AWS_PROFILES=default" \
  -e "GF_AWS_default_ACCESS_KEY_ID=YOUR_ACCESS_KEY" \
  -e "GF_AWS_default_SECRET_ACCESS_KEY=YOUR_SECRET_KEY" \
  -e "GF_AWS_default_REGION=us-east-1" \
  grafana/grafana

您也可以在GF_AWS_PROFILES中指定多个配置文件（例如GF_AWS_PROFILES=default another）。

支持的变量：

• GF_AWS_${profile}_ACCESS_KEY_ID：AWS访问密钥ID（必填）。
• GF_AWS_${profile}_SECRET_ACCESS_KEY：AWS密钥（必填）。
• GF_AWS_${profile}_REGION：AWS区域（可选）。