diff --git a/07.-Модуль-decort_pfw.md b/07.-Модуль-decort_pfw.md index ccb1ca8..f09a4aa 100644 --- a/07.-Модуль-decort_pfw.md +++ b/07.-Модуль-decort_pfw.md @@ -25,11 +25,15 @@ ## 07.3 Возвращаемые значения модуля _decort_pfw_ -Модуль _decort_pfw_ возвращает информацию о XXX в виде словаря `facts` со следующими ключами: +Модуль _decort_pfw_ возвращает информацию о правилах трансляции сетевых портов и сопутсвтующую информацию в виде словаря `facts` со следующими ключами: | Ключ | Тип данных | Описание | | --- | --- | --- | -| | | | +| compute_id | int | Идентификатор _compute_, для которого настроены перечисленные правила трансляции. | +| public_ip | string | IP адрес на внешнем сетевом интерфейсе ViNS. Перечисленные ниже правила трансляции настраиваются на этом интерфейсе. | +| rules | list of dict | Список словарей, описывающих правила трансляции сетевых портов. Структура словаря:
(int) `id` - идентификатор правила.
(int) `publicPortStart` - номер внешнего порта (на публичном интерфейсе ViNS, см. `public_ip`) для начала диапазона.
(int) `publicPortEnd` - номер внешнего порта для конца диапазона. Если требуется правило "один к одному", то `publicPortEnd` можно не указывать или указать равным `publicPortStart`.
(int) `localPort` - номер порта на интерфейсе экземпляра _Compute_, заданного параметром `compute_id`. Если задаётся правило "диапазон в диапазон", то `localPort` указывает начало диапазона для трансляции. В случае правила "один к одному" `publicPortStart` просто транслируется в `localPort`.
(string) `protocol` - протокол, `tcp` или `udp`.| +| state | string | Статус правил. Для корректно отработавшего модуля это поле должно иметь значение "PRESENT". | +| vins_id | int | Идентификатор виртуального сетевого сегмента (ViNS), в котором настроены перечисленные выше правила трансляции. | ## 07.4 Пример использования модуля _decort_pfw_ @@ -57,5 +61,12 @@ local_port: 30080 proto: tcp state: present + register: my_pfw delegate_to: localhost ``` + +В данном примере результат выполнения модуля _decort_pfw_ записывается в переменную `my_pfw`. Для доступа к списку правил используйте следующую конструкцию: + +``` +"{{ my_pfw.facts.rules }}" +``` \ No newline at end of file