pmm_client

Este rol instala y configura el Cliente PMM de Percona.

Requisitos

Este rol requiere Ansible 2.5.0 o superior.

Puedes usar pip para instalar (y definir) una versión estable:

pip install ansible==2.6.4

Todos los requisitos de la plataforma están listados en el archivo de metadatos.

Instalación

ansible-galaxy install timorunge.pmm_client

Variables del Rol

Las variables que se pueden pasar a este rol y una breve descripción sobre ellas son las siguientes. (Para todas las variables, consulta defaults/main.yml)

# Define la versión
# Tipo: Int
pmm_client_version: 1.14.1
# Dirección IP y puerto del pmm-server:
# Tipo: Str
pmm_client_server_host: 172.20.0.10
# Tipo: Int
pmm_client_server_port: 443
# Desactivar autenticación básica:
# Tipo: Bool
pmm_client_server_basic_auth: False
# Habilitar SSL:
# Tipo: Bool
pmm_client_server_use_ssl: True
# Definir servicios a agregar o eliminar:
# Tipo: List
pmm_client_add_services:
  - linux:metrics
  - mysql:metrics
  - mongodb:metrics
pmm_client_remove_services:
  - mysql:queries
# Definir servicios a iniciar o detener:
# Tipo: List
pmm_client_start_services:
  - linux:metrics
  - mysql:metrics
  - mongodb:metrics
pmm_client_stop_services:
  - mysql:queries
# Definir credenciales para la conexión a la base de datos MySQL:
# Tipo: Dict
pmm_client_db:
  mysql:
    host: localhost
    port: 3306
    username: root
    password: toor

Ejemplos

1) Instalar el Cliente PMM sin autenticación básica y con SSL desactivado

- 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) Instalar el Cliente PMM con autenticación básica y SSL habilitado

- 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) Instalar el Cliente PMM desde una URL definida

- 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) Desinstalar el Cliente PMM

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

Pruebas

Las pruebas de Travis se realizan con Docker y docker_test_runner. Las pruebas en Travis realizan revisiones de sintaxis y linting.

Dependencias

Ninguna

Licencia

BSD

Información del Autor

• Basado en el rol de Ansible de Chris Sam
• Modificado en gran medida por: Timo Runge