prometheus_node_exporter
Ansible роль ableton.prometheus_node_exporter
Эта роль устанавливает Prometheus node_exporter
как сервис на заданном
хосте. Если целевая система имеет менеджер пакетов с пакетом node_exporter
, то
эта роль устанавливает программное обеспечение таким образом. В противном случае
программное обеспечение будет собрано из исходников.
На Windows эта роль устанавливает windows_exporter
.
Требования
Необходим Ansible версии >= 2.10. Эта роль поддерживает установку на основе пакетов для следующих типов ОС:
- Debian Linux (через модуль
apt
) - macOS (через модуль
homebrew
) - Windows (через модуль
win_chocolatey
)
Для всех остальных платформ будет выполнена установка на основе исходного кода. На таких системах, где установка на основе пакетов не доступна, требуется следующее программное обеспечение:
- Go (golang)
- GNU Make
Эта роль не устанавливает ни одно из вышеперечисленных программ на хост; вы должны позаботиться об этом до применения этой роли.
Переменные роли
Следующие переменные роли используются для конфигурации сервиса node_exporter
:
node_exporter_args
: Список аргументов для передачи сервисуnode_exporter
, один аргумент на элемент списка.node_exporter_create_user
: Когдаtrue
, создается пользовательnode_exporter_user
и соответствующая группаnode_exporter_group
(используется только на платформах Unix, по умолчаниюtrue
).node_exporter_group
: Группа для пользователяnode_exporter_user
(используется только на Unix платформах).node_exporter_port
: Порт для отображения метрик.node_exporter_user
: Пользователь, от имени которого будет запущенnode_exporter
(используется только на Unix платформах).
Следующие переменные используются при сборке node_exporter
из источников:
node_exporter_install_from_binary
: Когдаtrue
,node_exporter
будет установлен из бинарной версии, а не через менеджер пакетов. Эта опция не поддерживается на всех типах систем (см. раздел "Требования" выше).node_exporter_binary_arch
: Архитектура бинарного файла для скачивания бинарной версииnode_exporter
.node_exporter_version
: Версияnode_exporter
, которую необходимо установить из источников.
Следующие переменные используются на Windows:
windows_exporter_version
: Версияwindows_exporter
, которую необходимо установить с помощью Chocolatey.
Смотрите файл defaults/main.yml
для полной документации по необходимым
и опциональным переменным роли.
Пример плейбука
---
- name: Установить node_exporter на хостах
hosts: "all"
vars:
node_exporter_port: 9100
node_exporter_binary_arch: "amd64"
node_exporter_group: "{{ ansible_user }}"
node_exporter_user: "{{ ansible_user }}"
node_exporter_version: "0.18.1"
pre_tasks:
- name: Заставить хосты macOS установить из источника, чтобы можно было использовать конкретную версию
set_fact:
node_exporter_install_from_binary: true
when: ansible_os_family == "Darwin"
- name: Установить необходимое программное обеспечение для хостов macOS
homebrew:
name: golang
state: present
roles:
- ableton.prometheus_node_exporter
Лицензия
MIT
Поддержка
Этот проект поддерживается следующими пользователями GitHub:
ansible-galaxy install ableton/ansible-role-prometheus-node-exporter