pmm_client

Ce rôle installe et configure le client PMM de Percona.

Exigences

Ce rôle nécessite Ansible 2.5.0 ou une version ultérieure.

Vous pouvez simplement utiliser pip pour installer (et définir) une version stable :

pip install ansible==2.6.4

Tous les besoins de la plateforme sont listés dans le fichier de métadonnées.

Installation

ansible-galaxy install timorunge.pmm_client

Variables du rôle

Les variables qui peuvent être passées à ce rôle et une brève description d'elles sont les suivantes. (Pour toutes les variables, jetez un œil à defaults/main.yml)

# Définir la version
# Type : Int
pmm_client_version: 1.14.1
# Adresse IP et port du pmm-server :
# Type : Str
pmm_client_server_host: 172.20.0.10
# Type : Int
pmm_client_server_port: 443
# Désactiver l'authentification de base :
# Type : Bool
pmm_client_server_basic_auth: False
# Activer SSL :
# Type : Bool
pmm_client_server_use_ssl: True
# Définir les services à ajouter ou à supprimer :
# Type : Liste
pmm_client_add_services:
  - linux:metrics
  - mysql:metrics
  - mongodb:metrics
pmm_client_remove_services:
  - mysql:queries
# Définir les services à démarrer ou à arrêter :
# Type : Liste
pmm_client_start_services:
  - linux:metrics
  - mysql:metrics
  - mongodb:metrics
pmm_client_stop_services:
  - mysql:queries
# Définir les identifiants pour la connexion à la base de données MySQL :
# Type : Dict
pmm_client_db:
  mysql:
    host: localhost
    port: 3306
    username: root
    password: toor

Exemples

1) Installer le client PMM sans authentification de base et SSL désactivé

- 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) Installer le client PMM avec authentification de base et SSL activé

- 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) Installer le client PMM à partir d'une URL définie

- 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) Désinstaller le client PMM

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

Tests

Les tests Travis sont réalisés avec Docker et docker_test_runner. Les tests sur Travis effectuent des vérifications de syntaxe et de linting.

Dépendances

Aucune

Licence

BSD

Informations sur l'auteur

• Basé sur le rôle Ansible de Chris Sam
• Largement modifié par : Timo Runge