pmm_client

Diese Rolle installiert und konfiguriert den Percona PMM Client.

Anforderungen

Diese Rolle erfordert Ansible 2.5.0 oder höher.

Du kannst pip verwenden, um eine stabile Version zu installieren (und zu definieren):

pip install ansible==2.6.4

Alle Plattformanforderungen sind in der Metadaten-Datei aufgeführt.

Installation

ansible-galaxy install timorunge.pmm_client

Rollenvariablen

Die Variablen, die an diese Rolle übergeben werden können, sowie eine kurze Beschreibung davon sind wie folgt. (Für alle Variablen, sieh dir defaults/main.yml an)

# Definiere die Version
# Typ: Int
pmm_client_version: 1.14.1
# IP-Adresse und Port des pmm-Servers:
# Typ: Str
pmm_client_server_host: 172.20.0.10
# Typ: Int
pmm_client_server_port: 443
# Basis-Authentifizierung deaktivieren:
# Typ: Bool
pmm_client_server_basic_auth: False
# SSL aktivieren:
# Typ: Bool
pmm_client_server_use_ssl: True
# Dienste definieren, die hinzugefügt oder entfernt werden sollen:
# Typ: List
pmm_client_add_services:
  - linux:metrics
  - mysql:metrics
  - mongodb:metrics
pmm_client_remove_services:
  - mysql:queries
# Dienste definieren, die gestartet oder gestoppt werden sollen:
# Typ: List
pmm_client_start_services:
  - linux:metrics
  - mysql:metrics
  - mongodb:metrics
pmm_client_stop_services:
  - mysql:queries
# Zugangsdaten für die MySQL-Datenbankverbindung definieren:
# Typ: Dict
pmm_client_db:
  mysql:
    host: localhost
    port: 3306
    username: root
    password: toor

Beispiele

1) Installiere den PMM Client ohne Basis-Authentifizierung und ohne SSL

- hosts: all
  become: yes
  vars:
    pmm_client_server_host: 172.20.0.10
    pmm_client_server_port: 443
    pmm_client_server_basic_auth: False
    pmm_client_server_use_ssl: False
    pmm_client_add_services:
      - linux:metrics
    pmm_client_start_services:
      - linux:metrics
  roles:
    - timorunge.pmm_client

2) Installiere den PMM Client mit Basis-Authentifizierung und aktiviertem SSL

- hosts: all
  become: yes
  vars:
    pmm_client_server_host: 172.20.0.10
    pmm_client_server_port: 443
    pmm_client_server_basic_auth: True
    pmm_client_server_basic_auth_username: admin
    pmm_client_server_basic_auth_password: mySecurePassword
    pmm_client_server_use_ssl: True
    pmm_client_add_services:
      - linux:metrics
    pmm_client_start_services:
      - linux:metrics
  roles:
    - timorunge.pmm_client

3) Installiere den PMM Client von einer definierten URL

- hosts: all
  become: yes
  vars:
    pmm_client_version: 1.11.0
    pmm_client_version_revision: 1
    pmm_client_use_official_repo: False
    pmm_client_debian_pkg: "https://www.percona.com/downloads/pmm/{{ pmm_client_version }}/binary/debian/{{ ansible_distribution_release }}/x86_64/pmm-client_{{ pmm_client_version }}-{{ pmm_client_version_revision }}.{{ ansible_distribution_release }}_amd64.deb"
  roles:
    - timorunge.pmm_client

4) Deinstalliere den PMM Client

- hosts: all
  become: yes
  vars:
    pmm_client_enabled: False
  roles:
    - timorunge.pmm_client

Testen

Die Travis-Tests werden mit Docker und docker_test_runner durchgeführt. Tests auf Travis führen Linting und Syntaxprüfungen durch.

Abhängigkeiten

Keine

Lizenz

BSD

Autoreninformation

• Basierend auf der Ansible-Rolle von Chris Sam
• Stark modifiziert von: Timo Runge