Модуль ngine_io.cloudstack.firewall — управление правилами брандмауэра в облаках на базе Apache CloudStack.
Примечание
Этот модуль входит в состав коллекции ngine_io.cloudstack (версия 3.0.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.firewall.
Добавлено в ngine_io.cloudstack 0.1.0
Краткое описание
- Создаёт и удаляет правила брандмауэра.
Псевдонимы: cs_firewall
Требования
Перечисленные ниже компоненты должны быть установлены на узле, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
Параметр | Комментарии |
|---|---|
account string | Учётная запись, к которой относится правило брандмауэра. |
api_http_method string | Метод HTTP, используемый для запроса конечной точки API. Если параметр не задан, используется переменная окружения Варианты:
|
api_key string / обязательный | Ключ API CloudStack. Если параметр не задан, используется переменная окружения |
api_secret string / обязательный | Секретный ключ API CloudStack. Если параметр не задан, используется переменная окружения |
api_timeout integer | Тайм-аут HTTP в секундах. Если параметр не задан, используется переменная окружения По умолчанию: |
api_url string / обязательный | URL API CloudStack, например https://cloud.example.com/client/api. Если параметр не задан, используется переменная окружения |
api_verify_ssl_cert string | Проверять файл сертификата центра сертификации. Если параметр не задан, используется переменная окружения |
cidrs псевдонимы: cidr list / элементы=string | Список диапазонов CIDR (в полной нотации), используемых для правила брандмауэра. Начиная с версии 2.5, это список диапазонов CIDR. По умолчанию: |
domain string | Домен, к которому относится правило брандмауэра. |
end_port integer | Конечный порт для этого правила. Учитывается, если protocol=tcp или protocol=udp. Если не задан, равен start_port. |
icmp_code integer | Код ошибки для этого сообщения ICMP. Учитывается, если protocol=icmp. |
icmp_type integer | Тип отправляемого сообщения ICMP. Учитывается, если protocol=icmp. |
ip_address string | Публичный IP-адрес, которому назначено правило входящего трафика. Обязателен, если type=ingress. |
network string | Сеть, к которой относится правило исходящего трафика. Обязателен, если type=egress. |
poll_async boolean | Ожидать завершения асинхронных заданий, опрашивая их состояние. Варианты:
|
project string | Название проекта, к которому относится правило брандмауэра. |
protocol string | Протокол правила брандмауэра.
Варианты:
|
start_port псевдонимы: port integer | Начальный порт для этого правила. Учитывается, если protocol=tcp или protocol=udp. |
state string | Состояние правила брандмауэра. Варианты:
|
tags псевдонимы: tag list / элементы=dictionary | Список тегов. Теги представляют собой список словарей с ключами key и value. Чтобы удалить все теги, задайте пустой список, например tags: []. |
type string | Тип правила брандмауэра. Варианты:
|
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0 | Если значение Если параметр не задан, используется переменная окружения Используйте этот параметр только на контролируемых вами узлах с самоподписанными сертификатами. Варианты:
|
zone string / обязательный | Название зоны, в которой находится виртуальная машина. |
Примечания
Примечание
- Подробное руководство по модулям CloudStack см. в руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Allow inbound port 80/tcp from 1.2.3.4 to 4.3.2.1
ngine_io.cloudstack.firewall:
ip_address: 4.3.2.1
zone: zone01
port: 80
cidr: 1.2.3.4/32
- name: Allow inbound tcp/udp port 53 to 4.3.2.1
ngine_io.cloudstack.firewall:
ip_address: 4.3.2.1
zone: zone01
port: 53
protocol: '{{ item }}'
with_items:
- tcp
- udp
- name: Ensure firewall rule is removed
ngine_io.cloudstack.firewall:
ip_address: 4.3.2.1
zone: zone01
start_port: 8000
end_port: 8888
cidr: 17.0.0.0/8
state: absent
- name: Allow all outbound traffic
ngine_io.cloudstack.firewall:
network: my_network
zone: zone01
type: egress
protocol: all
- name: Allow only HTTP outbound traffic for an IP
ngine_io.cloudstack.firewall:
network: my_network
zone: zone01
type: egress
port: 80
cidr: 10.101.1.20
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cidr string | Строка CIDR правила. Возвращается: при успешном выполнении Пример: |
cidrs list / элементы=string | Список диапазонов CIDR правила. Возвращается: при успешном выполнении Пример: |
end_port integer | Конечный порт правила. Возвращается: при успешном выполнении Пример: |
icmp_code integer | Код ICMP правила. Возвращается: при успешном выполнении Пример: |
icmp_type integer | Тип ICMP правила. Возвращается: при успешном выполнении Пример: |
id string | UUID правила. Возвращается: при успешном выполнении Пример: |
ip_address string | IP-адрес правила, если Возвращается: при успешном выполнении Пример: |
network string | Название сети, если Возвращается: при успешном выполнении Пример: |
protocol string | Протокол правила. Возвращается: при успешном выполнении Пример: |
start_port integer | Начальный порт правила. Возвращается: при успешном выполнении Пример: |
type string | Тип правила. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/firewall_module.html
