wangsha.docker-grafana

docker-grafana

Роль Ansible для управления и запуска контейнера grafana на Docker.

Требования

Эта роль тестировалась только на Ubuntu 14.04. Поскольку используется модуль docker от Ansible, убедитесь, что у вас установлены подходящие версии docker-py и docker.

Примеры

Установите этот модуль из Ansible Galaxy в директорию './roles':

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

Используйте его в плейбуке следующим образом, предполагая, что 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, посмотрите на angstwad.docker_ubuntu в Galaxy.

Используемый по умолчанию образ Docker - grafana/grafana. Порт по умолчанию - 3000, учетная запись администратора admin/admin.

Пользовательские соединения томов

Docker позволяет монтировать директорию хоста или файл хоста как том данных. Эта роль монтирует директории хоста для сохранения данных контейнера и файлы хоста для настройки поведения контейнера. docker_grafana_directory_volumes и docker_grafana_file_volumes - две переменные для управления соединениями томов. Если вы хотите настроить маппинг, используйте формат <директория_хоста>:<директория_контейнера>:<режим_маппинга>, чтобы гарантировать, что директории хоста будут корректно созданы перед запуском контейнеров.

Для настройки соединений файлов хоста обновите docker_grafana_file_volumes. Эта роль автоматически создаст родительские директории для файлов и скопирует шаблон на машину хоста. Принятый формат имен для шаблона - <имя_файла_хоста>.<расширение_файла_хоста>.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 существует.