colovu/grafana repository overview

⁠Grafana

针对 Grafana⁠ 应用的 Docker 镜像，用于提供 Grafana 服务。

使用说明可参照：官方说明⁠

版本信息：

• 7.1、latest

镜像信息：

• 镜像地址：
  • 阿里云: registry.cn-shenzhen.aliyuncs.com/colovu/grafana:latest
  • DockerHub：colovu/grafana:latest
  • 依赖镜像：debian:buster

⁠TL;DR

Docker 快速启动命令：

# 从 Docker Hub 服务器下载镜像并启动
$ docker run -d --name grafana colovu/grafana:latest

# 从 Aliyun 服务器下载镜像并启动
$ docker run -d --name grafana registry.cn-shenzhen.aliyuncs.com/colovu/grafana:latest

• colovu/imgname:<TAG>：镜像名称及版本标签；标签不指定时默认使用latest

Docker-Compose 快速启动命令：

# 从 Gitee 下载 Compose 文件
$ curl -sSL -o https://gitee.com/colovu/docker-grafana/raw/master/docker-compose.yml

# 从 Github 下载 Compose 文件
$ curl -sSL -o https://raw.githubusercontent.com/colovu/docker-grafana/master/docker-compose.yml

# 创建并启动容器
$ docker-compose up -d

⁠默认对外声明

⁠端口

• 3000：Web访问端口

⁠数据卷

镜像默认提供以下数据卷定义，默认数据分别存储在自动生成的应用名对应AppName子目录中：

/var/log			# 日志输出
/srv/conf			# 配置文件
/srv/data			# 数据存储

如果需要持久化存储相应数据，需要在宿主机建立本地目录，并在使用镜像初始化容器时进行映射。宿主机相关的目录中如果不存在对应应用AppName的子目录或相应数据文件，则容器会在初始化时创建相应目录及文件。

⁠容器配置

⁠常规配置参数

自 Grafana 7.1 版本起，软件支持通过环境变量的方式配置所有配置参数⁠，使用如下的格式：

GF_<SectionName>_<KeyName>

• SectionName：配置文件中包含在括号（ "[" / "]"）中的部分
• KeyName：配置项名称

同时：

• 环境变量全部使用大写字母
• 小节名称及关键字名称中的所有"."和"-"，都以"_"代替。

例如配置文件中如下的配置项：

# default section
instance_name = my-instance

[security]
admin_user = admin

[auth.google]
client_secret = 0ldS3cretKey

[plugin.grafana-image-renderer]
rendering_ignore_https_errors = true

对应的环境变量为：

export GF_DEFAULT_INSTANCE_NAME=my-instance
export GF_SECURITY_ADMIN_USER=admin
export GF_AUTH_GOOGLE_CLIENT_SECRET=0ldS3cretKey
export GF_PLUGIN_GRAFANA_IMAGE_RENDERER_RENDERING_IGNORE_HTTPS_ERRORS=true

⁠容器配置参数

⁠集群配置参数

集群配置参数主要为容器在集群状态时需要使用的参数，主要包括：

⁠可选配置参数

如果没有必要，可选配置参数可以不用定义，直接使用对应的默认值，主要包括：

⁠ENV_DEBUG

默认值：false。设置是否输出容器调试信息。

⁠容器安全

本容器默认使用non-root运行应用，以加强容器的安全性。在使用non-root用户运行容器时，相关的资源访问会受限；应用仅能操作镜像创建时指定的路径及数据。使用non-root方式的容器，更适合在生产环境中使用。

如果需要切换为root方式运行应用，可以在启动命令中增加-u root以指定运行的用户。

⁠注意事项

• 容器中应用的启动参数不能配置为后台运行，如果应用使用后台方式运行，则容器的启动命令会在运行后自动退出，从而导致容器退出

⁠更新记录

2021/7/22:

• 更新软件版本为 8.0.6

历史:

• 7、7.1、latest

本文原始来源 Endial Fang⁠ @ Github.com⁠