From 160e3d2a79a06a9fdfafb7374b6b0c0f53d07ba6 Mon Sep 17 00:00:00 2001 From: yuobrezkov Date: Tue, 25 Mar 2025 15:05:09 +0300 Subject: [PATCH] Added README for node-exporters role --- k8s/roles/common-kubernetes/README.md | 38 +++++++++++---------------- 1 file changed, 16 insertions(+), 22 deletions(-) diff --git a/k8s/roles/common-kubernetes/README.md b/k8s/roles/common-kubernetes/README.md index b33c788..0cce7ec 100644 --- a/k8s/roles/common-kubernetes/README.md +++ b/k8s/roles/common-kubernetes/README.md @@ -1,29 +1,28 @@ -# Роль Ansible: Инициализация кластера K8s +# Роль Ansible: node-exporters-common ## Описание -Данная роль предназначена для базовой настройки и инициализации кластера Kubernetes. В рамках выполнения роли: +Данная роль предназначена для установки и настройки **Node Exporter** для сбора метрик с хостов и их отправки в Prometheus. В рамках выполнения роли: -1. Обновляются и очищаются пакеты системы. -2. Удаляются старые репозитории и GPG-ключи Kubernetes и CRI-O. -3. Отключается swap. -4. Загружаются необходимые модули ядра и включается пересылка IPv4-трафика. -5. Устанавливаются базовые пакеты и инструменты для работы с Kubernetes. -6. Добавляются репозитории и GPG-ключи Kubernetes и CRI-O. -7. Устанавливаются `kubelet`, `kubeadm`, `kubectl`, а также `cri-o`. -8. Включается и запускается служба `cri-o`. +1. Устанавливается и запускается контейнер **Node Exporter**. +2. Настроены необходимые параметры для работы контейнера, включая монтирование файловой системы хоста и правильную настройку прав. +3. Контейнер настраивается с использованием параметров, таких как `--path.rootfs=/host` для корректной работы с файловой системой хоста. ## Требования -- Поддерживаемая версия ОС: Debian/Ubuntu +- Поддерживаемая версия ОС: Debian/Ubuntu, CentOS, RHEL +- Установлен Docker на целевых хостах. - Ansible с правами `root` (например, через `become: yes`) -## Переменные роли +## TODO: Переменные роли -| Переменная | Значение по умолчанию | -|---------------|--------------------| -| `k8s_version` | `v1.31` | -| `crio_version` | `v1.30` | +| Переменная | Значение по умолчанию | Описание | +|--------------------------|----------------------------------------|----------| +| `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'` | Команда для запуска контейнера | ## Зависимости @@ -37,9 +36,4 @@ - hosts: all become: yes roles: - - common-kubernetes -``` - -## Автор - -Автор: [Юрий Обрезков] \ No newline at end of file + - node-exporters-common