From f8b5230a4969e65f3546c4c2e5d5d82360989e36 Mon Sep 17 00:00:00 2001
From: svs1370 <34687689+svs1370@users.noreply.github.com>
Date: Thu, 9 Jul 2020 10:37:39 +0300
Subject: [PATCH] =?UTF-8?q?Updated=2007.=20=D0=9C=D0=BE=D0=B4=D1=83=D0=BB?=
=?UTF-8?q?=D1=8C=20decort=5Fpfw=20(markdown)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
07.-Модуль-decort_pfw.md | 15 +++++++++++++--
1 file changed, 13 insertions(+), 2 deletions(-)
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