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

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はホストディレクトリやホストファイルをdata volumeとしてマウントすることを許可します。このロールは、コンテナデータを永続化するためにホストディレクトリをマウントし、コンテナの動作を設定するためにホストファイルをマウントします。 docker_grafana_directory_volumesとdocker_grafana_file_volumesの2つの変数でボリュームマッピングを制御できます。マッピングをカスタマイズする場合は、<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ファイルが存在することを確認してください。