community.hrobot.firewall_info – Управление брандмауэром выделенного сервера Hetzner

Примечание

Этот плагин входит в коллекцию community.hrobot (версия 1.1.0).

Для его установки используйте: ansible-galaxy collection install community.hrobot.

Чтобы использовать его в книге задач, укажите: community.hrobot.firewall_info.

Описание
Параметры
См. также
Примеры
Возвращаемые значения

Описание

Управление брандмауэром выделенного сервера Hetzner.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
hetzner_password строка / обязательно		Пароль пользователя веб-сервиса Robot.
hetzner_user строка / обязательно		Имя пользователя веб-сервиса Robot.
server_ip строка / обязательно		Основной IP-адрес сервера.
timeout целое число	По умолчанию: 180	Тайм-аут (в секундах) ожидания конфигурации брандмауэра.
wait_delay целое число	По умолчанию: 10	Задержка ожидания (в секундах) перед повторной проверкой конфигурации брандмауэра.
wait_for_configured логическое	Варианты: нет да ←	Ожидать завершения успешной конфигурации брандмауэра перед возвратом из модуля. API возвращает статус `in progress`, когда брандмауэр настраивается. В этом случае модуль будет повторять попытку, пока статус не изменится на `active` или `disabled`. Обратите внимание на ограничение запросов. Если необходимо выполнить несколько обновлений, лучше отключить ожидание и регулярно использовать community.hrobot.firewall_info для запроса статуса.

См. также

Документация по брандмауэру: Документация Hetzner по бесстановочному брандмауэру для выделенных серверов
community.hrobot.firewall: Настройка брандмауэра.

Примеры

- name: Get firewall configuration for server with main IP 1.2.3.4
  community.hrobot.firewall_info:
    hetzner_user: foo
    hetzner_password: bar
    server_ip: 1.2.3.4
  register: result

- ansible.builtin.debug:
    msg: "{{ result.firewall }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ				Возвращаемое значение	Описание
firewall словарь				успех	Конфигурация брандмауэра.
	port строка			успех	Порт брандмауэра. `main` или `kvm`. Пример: main
	rules словарь			успех	Правила брандмауэра.
		input список / элементы=словарь		успех	Правила брандмауэра для входящих соединений.
			action строка	успех	Действие при совпадении правила. `accept` или `discard`. Пример: принять
			dst_ip строка	успех	IP-адрес или подсеть назначения. Нотация CIDR. Пример: 1.2.3.4/32
			dst_port строка	успех	Порт или диапазон портов назначения. Пример: 443
			ip_version строка	успех	Версия интернет-протокола. Пример: ipv4
			name строка	успех	Имя правила брандмауэра. Пример: Разрешить доступ к серверу по HTTP
			protocol строка	успех	Протокол выше уровня IP. Пример: tcp
			src_ip строка	успех	IP-адрес или подсеть источника. Нотация CIDR.
			src_port строка	успех	Порт или диапазон портов источника.
			tcp_flags строка	успех	Флаги TCP или логическое сочетание флагов.
	server_ip строка			успех	Основной IP-адрес сервера. Пример: 1.2.3.4
	server_number целое число			успех	Внутренний номер сервера Hetzner. Пример: 12345
	status строка			успех	Статус брандмауэра. `active` или `disabled`. Будет `in process`, если брандмауэр обновляется, а wait_for_configured установлен в `no` или timeout имеет слишком маленькое значение. Пример: активный
	whitelist_hos логическое			успех	Разрешен ли доступ к сервисам Hetzner. Пример: True

Авторы

Felix Fontein (@felixfontein)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/hrobot/firewall_info_module.html