ansible-playbooks/k8s/roles/common-kubernetes/README.md

40 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Роль Ansible: node-exporters-common
## Описание
Данная роль предназначена для установки и настройки **Node Exporter** для сбора метрик с хостов и их отправки в Prometheus. В рамках выполнения роли:
1. Устанавливается и запускается контейнер **Node Exporter**.
2. Настроены необходимые параметры для работы контейнера, включая монтирование файловой системы хоста и правильную настройку прав.
3. Контейнер настраивается с использованием параметров, таких как `--path.rootfs=/host` для корректной работы с файловой системой хоста.
## Требования
- Поддерживаемая версия ОС: Debian/Ubuntu, CentOS, RHEL
- Установлен Docker на целевых хостах.
- Ansible с правами `root` (например, через `become: yes`)
## TODO: Переменные роли
| Переменная | Значение по умолчанию | Описание |
|--------------------------|----------------------------------------|----------|
| `node_exporter_image` | `quay.io/prometheus/node-exporter:latest` | Образ контейнера для Node Exporter |
| `node_exporter_container_name` | `node_exporter` | Имя контейнера Node Exporter |
| `node_exporter_restart_policy` | `always` | Политика перезапуска контейнера |
| `node_exporter_volumes` | `['/host:/host:ro,rslave']` | Монтирование томов для доступа к файловой системе хоста |
| `node_exporter_command` | `'--path.rootfs=/host'` | Команда для запуска контейнера |
## Зависимости
Данная роль не имеет зависимостей от других ролей.
## Пример Playbook
Пример использования роли в Playbook:
```yaml
- hosts: all
become: yes
roles:
- node-exporters-common