Графы

💾 Актуально для версии Атом.Порт: 63ef9982


Значение словаря nodes

Словарь узлов nodes содержит пары ключ-значение, где ключом является название определяемого узла, а значением — объект, определяющий свойства узла. Объект может содержать следующие поля (ключи):

Поле	Обязательное	Тип	Значение
description		Строка	Человекочитаемое описание узла.
unit_type	✔	Строка	Тип узла.
unit_data		Словарь	Параметры, специфичные для данного unit_name.
retry_limit		Целое число	Количество повторных запусков узла в случае неуспешного выполнения до того, как узел будет помечен неуспешным 🔴.

Типы узлов

Следующие типы узлов могут быть указаны в качестве значения поля unit_type.

UnitAutoProcess

Запускает другую автоматизации. Текущая автоматизация становится на паузу.

Допустимые ключи, которые передаются unit_kwarg узла:

Поле	Обязательное	Тип	Значение
graph_name	✔	Строка	Название графа, который будет запущен.
timeout		Целое число	Время ожидания автоматизации. Когда истекает, узел помечается неуспешным 🔴, если автоматизация ещё не выполнилась.

UnitCommand

Запускает функций модулей исполнения SaltStack. Это основные узлы для конфигурирования рабочих станций

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
function	✔	Словарь	Название функции модуля исполнения SaltStack в формате модуль.функция, пример: test.ping
args		Список	Позиционные аргументы для передачи функции.
kwargs		Словарь	Именованные аргументы для передачи функции.
minion_type	✔	Строка [windows|linux|helper|active|master]	Тип миньона рабочей станции, для которого запускается функция. active выбирает текущий активный с наибольшей продолжительностью активности (как правило хост, а не виртуальная машина). master выбирает сервер, к которому подключена рабочая станция.
timeout		Целое число	Время ожидания исполнения команды в секундах.

👉 При применении состояний функцией state.apply для передачи значений в формулу SaltStack используйте именованный аргумент pillar, имеющий формат словаря.

UnitEnd

Завершает путь. Конечный узел, сток. Обычно инженеру не требуется определять узлы такого типа самостоятельно.

UnitFail

Безусловно устанавливает вес входящей дуги в бесконечность. Преимущественно для отладки.

UnitGroup

Добавляет и удаляет рабочую станцию из заданных групп.

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
groups	*	Список строк	Группы для изменения, указываемые иерархическими именами вида /Родительская группа/Название целевой группы.
action	*	Строка [add|remove]	Действие (добавить или удалить рабочую станцию из группы)

UnitIF

Условный оператор, производящий сравнение переменных Атом.Порт и литералов. Устанавливает вес входящей дуги в зависимости от результата.

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
op	*	Строка [eq|ne|gt|ge|lt|le|in|notin]	Оператор для сравнения
val_1	*	Литерал	Левый операнд, значение или путь идентификатор Атом.Порт
val_2	*	Литерал	Правый операнд, значение или путь идентификатор Атом.Порт

UnitMessage

Отправляет уведомление в Телеграм. Интеграция с мессенджером должна быть настроена.

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
message	*	Строка	Текст сообщения

UnitPause

Ожидает перед проходом дальше.

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
delay	*	Целое число	Кол-во секунд для ожидания

UnitRunner

Запускает функции модулей бегунков (раннеров) SaltStack.

Допустимые ключи, которые передаются unit_data узла: аналогично UnitCommand, однако function должнен указывать на функцию модуля бегунков, например state.orchestrate.

UnitSet

Устанавливает значения переменных Атом.Порт.

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
target	*	строка	Идентификатор переменной Атом.Порт (доступно хранилище ключ-значение)
value	*	строка	Устанавливаемое значение

UnitStart

Начинает путь. Начальный узел, исток. Обычно инженеру не требуется определять узлы такого типа самостоятельно.

UnitSystemMessage

Отправляет уведомление через интерфейс Атом.Порт.

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
message	*	Строка	Текст сообщения
message_type	*	Целое число [1-4]	Тип отправляемого уведомления

UnitWaitingMinion

Ожидает доступности миньона указанного типа. Полезно при перезагрузке рабочей станции в другую операционную систему.

Допустимые ключи, которые передаются unit_data узла:

Поле	Обязательное	Тип	Значение
minion_type	*	Строка [windows|linux|helper|active|master]	Тип миньона рабочей станции, для которого запускается функция, см. UnitCommand
timeout		Целое число	Время ожидания миньона в секундах до того, как узел будет помечен неуспешным 🔴
activity_timeout		Целое число	Временно́е окно в секундах, учитывающее прошлую активность миньона. По умолчанию 120 сек.