ansible-role-pmm-server

This role installs PMM server using the official Docker image.

It is part of a family of Ansible roles allowing to setup and configure PMM:

• ansible-role-pmm-server
• ansible-role-pmm-client

Requirements

Ansible 2.10 or newer.

Supported Platforms

• Debian - 11 (Bullseye)
• Debian - 12 (Bookworm)
• Ubuntu - 22.04 (Jammy Jellyfish)
• Ubuntu - 24.04 (Noble Numbat)

Role Variables

Variable	Required	Default	Choices	Comments
pmm_server_docker_image_name	true	percona/pmm-server	string
pmm_server_docker_image_version	true	2	string
pmm_server_docker_pull	true	false	boolean	Set true to force pulling a newer Docker image.
pmm_server_docker_env	true	{}	dict
pmm_server_network_mode	true	bridge	string	bridge, host, none or `container:<name
pmm_server_ports	true		list	See defaults/main.yml.
pmm_server_container_state	true	started	string	absent, present, stopped or started.
pmm_server_restart_policy	true	unless-stopped	string
pmm_server_anonymous_access	true	false	bool	Enable or disable anonymous dashboard access.

Dependencies

Docker

Example Playbook

- hosts: all
  roles:
    - role: ansible-role-pmm-server

Testing

Debian

molecule --base-config molecule/shared/base.yml test --scenario-name debian-11
molecule --base-config molecule/shared/base.yml test --scenario-name debian-12

Ubuntu

molecule --base-config molecule/shared/base.yml test --scenario-name ubuntu-2204
molecule --base-config molecule/shared/base.yml test --scenario-name ubuntu-2404

License

MIT

Author Information

@boutetnico