Este artículo trata sobre cómo escribir libros de jugadas ansible simples para instalar automáticamente agentes en hosts Linux / Windows y registrar hosts a través de la API de Zabbix, incluidos los hosts SNMP. Se utilizarán roles y módulos listos para usar de Ansible Galaxy Zabbix.
Zabbix ha preparado sus propios roles y módulos para configurar muchos componentes de Zabbix a través de Ansible; puede encontrar una lista completa aquí .
En este artículo, solo hablaremos de zabbix_agent y zabbix_host .
* Este artículo no cubre ni muestra la instalación y configuración de Ansible, hay mucho de esto en Internet.
zabbix_agent
Este es un rol que admite la instalación del agente en los siguientes sistemas operativos:
sombrero rojo
Fedora
Debian
Ubuntu
opensuse
Windows (mejor esfuerzo)
Mac OS
Una lista actualizada en el github oficial del proyecto .
zabbix_host
Este es un módulo para agregar / eliminar / cambiar hosts en el servidor zabbix. Aquí encontrará una descripción completa del módulo .
Así que pasemos a configurar
El primer paso es instalar la colección ansible (solo funciona en ansible versión 2.9+):
ansible-galaxy collection install community.zabbix
Después de instalar la colección, cree un archivo con un libro de jugadas. Este manual hace dos cosas: establece el rol community.zabbix.zabbix_agent en los hosts especificados y, en el segundo paso, registra el host en zabbix a través del módulo community.zabbix.zabbix_host.
zabbix-agent-all.yaml :
- hosts: all
tasks:
- name: Install agent
include_role:
name: community.zabbix.zabbix_agent #
tags:
- install #
- name: Create a new host or update an existing host's info # zabbix
local_action:
module: community.zabbix.zabbix_host # zabbix_host
server_url: "{{ zabbix_url }}" # - url API
login_user: "{{ zabbix_api_user }}" # - Admin
login_password: "{{ zabbix_api_pass }}" # -
host_name: "{{ item }}" - #
visible_name: "{{ hostvars[item].zabbix_visible_name | default(item) }}" #
description: "{{ hostvars[item].zabbix_host_description | default('') }} OS: {{ hostvars[item].ansible_distribution | default('') }} {{ hostvars[item].ansible_distribution_version | default('') }}" # ansible
host_groups: "{{ hostvars[item].zabbix_host_groups }}" #
link_templates: "{{ hostvars[item].zabbix_link_templates }}" # template
status: "{{ hostvars[item].zabbix_host_status }}" # - Enabled Disabled
state: present # ansible , absent
inventory_mode: disabled # inventory mode
interfaces: #
- type: "{{ hostvars[item].zabbix_interface_type }}" # - SNMP, Agent, JMX, IPMI
main: 1
useip: "{{ hostvars[item].zabbix_interface_use_ip }}" # ip dns
ip: "{{ hostvars[item].zabbix_interface_ip }}" # ip - ip
dns: "{{ item }}" # useip: 0 FQDN
port: "{{ hostvars[item].zabbix_interface_port }}" #
loop: "{{ groups['all'] }}" #
run_once: true # ,
tags:
- add-host #
linux-inventory, windows-inventory snmp-inventory, , .
Linux
linux-inventory:
[all]
host1.local # FQDN IP-
host2.local zabbix_host_description=”The host2 description”
host3.local zabbix_host_status=disabled #
host4.local zabbix_host_groups=’["Custom group"]’ #
[all:vars]
zabbix_agent_server=my.zabbix.server #
zabbix_url=https://my.zabbix.server # URL
zabbix_api_use=true # API
zabbix_api_user=Admin
zabbix_api_pass=StrongPa$$w0rd
zabbix_interface_port="10050" #
zabbix_host_groups=["Linux servers"] #
zabbix_link_templates=["Linux by Zabbix agent"] # template
zabbix_interface_type=agent # -
zabbix_interface_use_ip="0" # dns fqdn
zabbix_interface_ip=""
zabbix_host_description="My linux server" #
zabbix_host_status=enabled #
Windows
Windows ansible - , ansible.
windows-inventory:
[all]
winhost01.local
winhost02.local zabbix_host_groups=’["Custom group"]’ #
winhost03.local zabbix_host_status=disabled #
[all:vars]
ansible_user=user@DOMAIN.LOCAL # , kerberos linux
ansible_password=StrongPa$$w0rd
ansible_connection=winrm # windows WinRM
ansible_winrm_server_cert_validation=ignore # , ignore
zabbix_agent_server=my.zabbix.server #
zabbix_url=https://my.zabbix.server # URL
zabbix_api_use=true # API
zabbix_api_user=Admin
zabbix_api_pass=StrongPa$$w0rd
zabbix_interface_port="10050" #
zabbix_host_groups=["Windows servers"] #
zabbix_link_templates=["Windows by Zabbix agent"] # template
zabbix_interface_type=agent # -
zabbix_interface_use_ip="0" # dns fqdn
zabbix_interface_ip=""
zabbix_host_description="My windows server" #
zabbix_host_status=enabled #
SNMP
SNMP snmp-inventory:
[all]
snmphost1.local zabbix_link_templates='["Cisco IOS SNMP","Network Generic Device SNMP"]' zabbix_host_groups='["Network devices"]'
snmp2.local zabbix_link_templates='["Template SNMP OS ESXi"]' zabbix_host_groups='["Hypervisors"]' zabbix_snmp_community=”Community”
[all:vars]
zabbix_url=https://my.zabbix.server # URL
zabbix_api_use=true # API
zabbix_api_user=Admin
zabbix_api_pass=StrongPa$$w0rd
zabbix_interface_port="161" # , 161
zabbix_interface_type=snmp # snmp
zabbix_interface_use_ip="0" # dns
zabbix_interface_ip="" # ip
zabbix_host_description="My SNMP host" #
zabbix_host_status=enabled #
zabbix_snmp_community="MyCommunity" # SNMP community
Como resultado, los archivos deben tener la siguiente estructura de archivos:
.
├── linux-inventory
├── snmp-inventory
├── windows-inventory
└── zabbix-agent-all.yaml
Lanzar un libro de jugadas
Para ejecutar libros de jugadas, debe ejecutar los siguientes comandos:
Para instalar en hosts Linux:
ansible-playbook -i linux-inventory zabbix-agent-all.yaml
Ventanas:
ansible-playbook -i windows-inventory zabbix-agent-all.yaml
SNMP:
ansible-playbook -i snmp-inventory zabbix-agent-all.yaml
Si solo se necesita la instalación, puede ejecutar los comandos anteriores con la etiqueta de instalación:
ansible-playbook -i linux-inventory zabbix-agent-all.yaml -t install
Si tiene una configuración especial de zabbix o desea personalizarla, puede encontrar una lista completa de variables de función y módulo en la página del proyecto: zabbix_agent y zabbix_host
Todas las fuentes de este artículo están en github .