wangsha.docker-grafana

docker-grafana

一个用于管理和运行Grafana Docker容器的Ansible角色。

要求

该角色只在Ubuntu 14.04上进行过测试。由于它使用了Ansible的docker模块，您需要确保安装了较新版本的docker-py和docker。

示例

从Ansible Galaxy安装此模块到'./roles'目录：

ansible-galaxy install wangsha.docker-grafana -p ./roles

在playbook中使用，如下所示，假设您已经设置好docker：

- hosts: 'servers'
  roles:
    - role: 'wangsha.docker-grafana'
      become: true

查看defaults/main.yml以了解可以重写的角色变量。环境变量的完整列表可以在这里找到。

允许GitHub注册的示例配置：

- role: docker-grafana
      docker_grafana_ports:
        - 8080:3000
      docker_grafana_env:
        GF_SECURITY_ADMIN_USER: myadmin
        GF_SECURITY_ADMIN_PASSWORD: myadmin
        GF_USERS_ALLOW_SIGN_UP: true
        GF_SERVER_ROOT_URL: http://localhost:8080/
        GF_AUTH_GITHUB_ALLOW_SIGN_UP: true
        GF_AUTH_GITHUB_ENABLED: true
        GF_AUTH_GITHUB_SCOPES: user:email,read:org
        GF_AUTH_GITHUB_CLIENT_ID: XXXX
        GF_AUTH_GITHUB_CLIENT_SECRET: XXXX
        GF_AUTH_GITHUB_ALLOWED_ORGANIZATIONS: yourgithuborganization

如果您需要设置Docker的playbook，可以查看angstwad.docker_ubuntu Galaxy角色。

使用的默认Docker镜像是grafana/grafana。默认端口为3000，管理员账户为admin/admin。

自定义卷映射

Docker允许将主机目录或主机文件挂载为数据卷。该角色挂载主机目录以持久化容器数据，并挂载主机文件以配置容器行为。docker_grafana_directory_volumes和docker_grafana_file_volumes是控制卷映射的两个变量。如果您希望自定义映射，请遵循<host directory>:<container directory>:<mapping mode>格式，以确保在启动容器之前正确创建主机目录。

要自定义主机文件映射，请更新docker_grafana_file_volumes。该角色将自动创建文件的父目录并将模板复制到主机上。模板的命名约定为<host_file_name>.<host_file_extension>.j2。要从您自己的Ansible目录复制模板，请设置docker_grafana_template_path。

示例配置：

docker_grafana_file_volumes:
  - '/opt/myapp/conf/settings.conf:/etc/myapp/conf/settings.conf:ro'
docker_grafana_template_path: /path/to/ansible/project/templates/
# 确保文件/path/to/ansible/project/templates/settings.conf.j2存在。