From cc6b9eb70e8853561633e20b3f07a08829d3fbbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BE=D0=BB=D0=B3=D0=B8=D0=B9=20=D0=90=D1=80=D1=82?=
 =?UTF-8?q?=D1=91=D0=BC?= <artem@da2001.ru>
Date: Wed, 20 Mar 2024 17:53:24 +0300
Subject: [PATCH] mod

---
 README.md | 117 ++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 109 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index f4cbcf9..03898d6 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,23 @@
   - [Настройка master](#настройка-master)
   - [Настройка minion](#настройка-minion)
   - [Ключи](#ключи)
+    - [Посмотреть все ключи](#посмотреть-все-ключи)
+    - [Принять ключ конкретного миньона](#принять-ключ-конкретного-миньона)
+    - [Принять ключи по маске идентификаторов](#принять-ключи-по-маске-идентификаторов)
+    - [Показать только принятые ключи](#показать-только-принятые-ключи)
+    - [Принять все предлагаемые ключи](#принять-все-предлагаемые-ключи)
+    - [Удалить ключи по маске](#удалить-ключи-по-маске)
+    - [Удалить конкретный ключ](#удалить-конкретный-ключ)
+    - [Удалить все ключи](#удалить-все-ключи)
   - [Первый тест](#первый-тест)
+  - [Сбор данных](#сбор-данных)
+    - [Сбор всех данных](#сбор-всех-данных)
+    - [Получение конкретных значений](#получение-конкретных-значений)
+  - [Указание конкретных миньонов для запуска](#указание-конкретных-миньонов-для-запуска)
+    - [По маске имён](#по-маске-имён)
+    - [По зёрнам (`grains`) в качестве фильтров](#по-зёрнам-grains-в-качестве-фильтров)
+    - [По группам узлов](#по-группам-узлов)
+    - [Составные подстановки](#составные-подстановки)
   - [Источники](#источники)
 
 ***
@@ -97,6 +113,18 @@ publish_port: 4505
 # Писать статистику после выполнения команд
 cli_summary: true
 
+# Объединение узлов в группы
+# Пробелы в выборках нужно обрабатывать
+# НЕ правильно - 'G@os:CentOS Strem'
+# Правильно - 'G@os:CentOS?Stream' или 'P@os:CentOS\sStream' или 'G@os:CentOS*'
+nodegroups:
+  alt: 'G@os:ALT'
+  centos-stream: 'G@os:CentOS?Stream'
+  centos: 'P@os:CentOS\sStream'
+  debian: 'G@os:Debian'
+  apt: 'deb-*'
+  rpm: 'centos-*'
+
 
 worker_threads: 5
 ```
@@ -126,7 +154,7 @@ id: centos-minion-1
 
 Некоторые примеры работы с ней:
 
-Посмотреть все ключи
+### Посмотреть все ключи
 
 ```bash
 [root@alt-master ~]#  salt-key -L
@@ -142,7 +170,7 @@ deb-minion-4
 Rejected Keys:
 ```
 
-Принять ключ конкретного миньона
+### Принять ключ конкретного миньона
 
 ```bash
 [root@alt-master ~]# salt-key -l accepted
@@ -155,7 +183,7 @@ Proceed? [n/Y]
 Key for minion centos-minion-1 accepted.
 ```
 
-Принять ключи по маске идентификаторов
+### Принять ключи по маске идентификаторов
 
 ```bash
 [root@alt-master ~]# salt-key -a 'deb*'
@@ -168,31 +196,31 @@ Key for minion deb-minion-3 accepted.
 Key for minion deb-minion-4 accepted.
 ```
 
-Показать только принятые ключи
+### Показать только принятые ключи
 
 ```bash
 salt-key -l accepted
 ```
 
-Принять все предлагаемые ключи
+### Принять все предлагаемые ключи
 
 ```bash
 salt-key -A
 ```
 
-Удалить ключи по маске
+### Удалить ключи по маске
 
 ```bash
 salt-key -d 'deb*'
 ```
 
-Удалить конкретный ключ
+### Удалить конкретный ключ
 
 ```bash
 salt-key -d deb-minion-3
 ```
 
-Удалить все ключи
+### Удалить все ключи
 
 ```bash
 salt-key -D
@@ -257,6 +285,79 @@ Summary
 -------------------------------------------
 ```
 
+## Сбор данных
+
+grains - зёрна, переменные, которые получает мастер с миньона
+
+```bash
+[root@alt-master ~]# salt 'alt-minion-6' grains.
+grains.append     grains.delval     grains.fetch      grains.get        grains.item       grains.ls         grains.set        grains.setvals    
+grains.delkey     grains.equals     grains.filter_by  grains.has_value  grains.items      grains.remove     grains.setval
+```
+
+двойной Tab покажет возможные варианты команды
+
+### Сбор всех данных
+
+```bash
+salt 'alt-minion-6' grains.items
+```
+
+### Получение конкретных значений
+
+```bash
+salt 'alt-minion-6' grains.item ipv4
+```
+
+```bash
+salt 'alt-minion-6' grains.item os
+```
+
+```bash
+salt 'alt-minion-6' grains.item cpuarch
+```
+
+## Указание конкретных миньонов для запуска
+
+### По маске имён
+
+```bash
+salt 'deb-*' test.ping
+```
+
+`*` - и прочие подстановочные символы необходимо оборачивать кавычками, иначе оболочка их будет интерпретировать по-своему - Glob-подстановки
+
+### По зёрнам (`grains`) в качестве фильтров
+
+**Пробелы в выборках нужно обрабатывать**  
+**НЕ правильно** - `'G@os:CentOS Strem'`  
+**Правильно** - `'G@os:CentOS?Stream'`  
+**Правильно** - `'P@os:CentOS\sStream'`
+**Правильно** - `G@os:CentOS*`
+
+```bash
+salt -G 'os:ALT' test.ping
+```
+
+```bash
+salt -G 'G@os:CentOS?Stream' test.ping
+```
+
+### По группам узлов
+
+Группы узлов необходимо заранее создать в настройках мастера
+
+```bash
+salt -N debian test.ping
+```
+
+### Составные подстановки
+
+```bash
+deb_ip=$(salt 'deb-minion-3' network.ipaddrs --out=newline_values_only)
+salt -C "( G@os:CentOS* and alt* ) or S@${deb_ip}" test.ping
+```
+
 
 ## Источники