Getting started

Default configuration

The role supports multiple flavors of Zabbix Agent included in Debian, one if which needs to be specified using zabbix_agent__flavor variable (the default is C flavor). To change the installed flavor, the current installation needs to be removed - to do that, you can execute the role with and extra variable on the command line:

debops run service/zabbix_agent -e 'zabbix_agent__deploy_state=absent'

This will tell the role to remove the current installation. After that, by changing the zabbix_agent__flavor in the Ansible inventory, you can install a different flavor of the Zabbix Agent.

Example inventory

To enable the Zabbix agent service on a host it needs to be included in the specific Ansible inventory group:

[debops_service_zabbix_agent]
hostname

Example playbook

If you are using this role without DebOps, here's an example Ansible playbook that uses the debops.zabbix_agent role:

---

- name: Install and manage Zabbix agent
  collections: [ 'debops.debops', 'debops.roles01',
                 'debops.roles02', 'debops.roles03' ]
  hosts: [ 'debops_service_zabbix_agent' ]
  become: True

  environment: '{{ inventory__environment | d({})
                   | combine(inventory__group_environment | d({}))
                   | combine(inventory__host_environment  | d({})) }}'

  roles:

    - role: ferm
      tags: [ 'role::ferm', 'skip::ferm' ]
      ferm__dependent_rules:
        - '{{ zabbix_agent__ferm__dependent_rules }}'

    - role: zabbix_agent
      tags: [ 'role::zabbix_agent', 'skip::zabbix_agent' ]