wangsha.docker-grafana

docker-grafana

Rola Ansible do zarządzania i uruchamiania kontenera dockerowego grafana.

Wymagania

Ta rola była testowana tylko na Ubuntu 14.04. Ponieważ używa modułu dockera Ansible, upewnij się, że masz zainstalowane nowsze wersje docker-py i docker.

Przykłady

Zainstaluj ten moduł z Ansible Galaxy do katalogu './roles':

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

Użyj go w playbooku w następujący sposób, zakładając, że masz już skonfigurowany docker:

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

Zobacz defaults/main.yml w celu zobaczenia zmiennych roli, które można nadpisać. Pełna lista zmiennych środowiskowych znajduje się tutaj

Przykładowa konfiguracja pozwalająca na logowanie się przez 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: twojaorganizacjagithub

Jeśli potrzebujesz playbooka do konfiguracji samego Dockera, sprawdź rolę Galaxy angstwad.docker_ubuntu.

Domyślny obraz dockera używany to grafana/grafana. Domyślny port to 3000, konto administratora to admin/admin.

Dostosowywanie mapowania wolumenów

Docker pozwala na montowanie katalogu hosta lub pliku hosta jako wolumenu danych. Ta rola montuje katalogi hosta, aby zachować dane kontenera oraz pliki hosta do konfigurowania zachowania kontenera. docker_grafana_directory_volumes oraz docker_grafana_file_volumes to zmienne kontrolujące mapowanie wolumenów. Aby dostosować mapowanie, stosuj format <katalog hosta>:<katalog kontenera>:<tryb mapowania>, aby upewnić się, że katalogi hosta są poprawnie tworzone przed uruchomieniem kontenerów.

Aby dostosować mapowanie plików hosta, zaktualizuj docker_grafana_file_volumes. Ta rola automatycznie utworzy katalogi nadrzędne pliku i skopiuje szablon na maszynę hosta. Konwencja nazewnictwa dla szablonu to <nazwa_pliku_hosta>.<rozszerzenie_pliku_hosta>.j2. Aby skopiować szablon z własnych katalogów ansible, ustaw docker_grafana_template_path.

Przykładowa konfiguracja:

docker_grafana_file_volumes:
  - '/opt/myapp/conf/settings.conf:/etc/myapp/conf/settings.conf:ro'
docker_grafana_template_path: /path/to/ansible/project/templates/
# upewnij się, że plik /path/to/ansible/project/templates//settings.conf.j2 istnieje.