community.network.ftd_install – Установка образа FTD pkg на межсетевой экран

Примечание

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

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

Для использования в книге задач, укажите: community.network.ftd_install.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Модуль управления ресурсами для устройств FTD, который устанавливает образ ROMMON (при необходимости) и образ FTD pkg на межсетевой экран.
Может использоваться с типами подключения httpapi и local. Подключение httpapi предпочтительнее, подключение local следует использовать только в случае, если к устройству нельзя получить доступ через REST API.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python >= 3.5
firepower-kickstart

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
console_ip строка / обязательный		IP-адрес терминального сервера. Используется для настройки SSH-соединения с консольным портом устройства через терминальный сервер.
console_password строка / обязательный		Пароль для входа на терминальный сервер.
console_port строка / обязательный		Порт устройства на терминальном сервере.
console_username строка / обязательный		Имя пользователя для входа на терминальный сервер.
device_gateway строка		Шлюз устройства интерфейса управления. Если не указано и соединение является 'httpapi', модуль пытается получить значение через REST API. Для типа подключения 'local' этот параметр является обязательным.
device_hostname строка / обязательный		Имя хоста устройства, как оно отображается в подсказке (например, 'firepower-5516').
device_ip строка		IP-адрес устройства интерфейса управления. Если не указано и соединение является 'httpapi', модуль пытается получить значение через REST API. Для типа подключения 'local' этот параметр является обязательным.
device_model строка	Варианты: Cisco ASA5506-X Threat Defense Cisco ASA5508-X Threat Defense Cisco ASA5516-X Threat Defense Cisco Firepower 2110 Threat Defense Cisco Firepower 2120 Threat Defense Cisco Firepower 2130 Threat Defense Cisco Firepower 2140 Threat Defense	Модель платформы устройства (например, 'Cisco ASA5506-X Threat Defense'). Если не указано и соединение является 'httpapi', модуль пытается получить модель устройства через REST API. Для типа подключения 'local' этот параметр является обязательным.
device_netmask строка		Маска сети устройства интерфейса управления. Если не указано и соединение является 'httpapi', модуль пытается получить значение через REST API. Для типа подключения 'local' этот параметр является обязательным.
device_new_password строка		Новый пароль устройства, который необходимо установить после установки образа. Если не указано, используется текущий пароль из свойства `device_password`. Не применимо для устройств серии ASA5500-X.
device_password строка / обязательный		Пароль для входа на устройство.
device_sudo_password строка		Пароль root для устройства. Если не указано, используется `device_password`.
device_username строка	По умолчанию: "admin"	Имя пользователя для входа на устройство. По умолчанию 'admin', если не указано.
dns_server строка		IP-адрес DNS-сервера интерфейса управления. Если не указано и соединение является 'httpapi', модуль пытается получить значение через REST API. Для типа подключения 'local' этот параметр является обязательным.
force_install булево	Варианты: нет ← да	Принудительно устанавливает образ FTD, даже если та же версия уже установлена на межсетевом экране. По умолчанию, модуль останавливает выполнение, когда целевая версия установлена в устройстве.
image_file_location строка / обязательный		Путь к образу FTD pkg на сервере для загрузки. Обычно поддерживаются протоколы FTP, SCP, SFTP, TFTP или HTTP, но могут зависеть от модели устройства.
image_version строка / обязательный		Версия образа FTD, которая должна быть установлена. Помогает сравнить целевую и текущую версии FTD для предотвращения ненужной повторной установки.
rommon_file_location строка / обязательный		Путь к образу загрузки (ROMMON) на TFTP-сервере. Поддерживается только TFTP.
search_domains строка	По умолчанию: "cisco.com"	Домены поиска, разделенные запятыми. По умолчанию 'cisco.com', если не указано.

Примечания

Примечание

Требуется библиотека firepower-kickstart, которую необходимо установить отдельно, и она требует Python >= 3.5.
На локальном хосте Ansible все еще можно запускать с Python >= 2.7, но интерпретатор для этого конкретного модуля должен быть Python >= 3.5.
Интерпретатор Python для модуля может быть переопределен в переменной ansible_python_interpreter.

Примеры

- name: Install image v6.3.0 on FTD 5516
  community.network.ftd_install:
    device_hostname: firepower
    device_password: pass
    device_ip: 192.168.0.1
    device_netmask: 255.255.255.0
    device_gateway: 192.168.0.254
    dns_server: 8.8.8.8

    console_ip: 10.89.0.0
    console_port: 2004
    console_username: console_user
    console_password: console_pass

    rommon_file_location: 'tftp://10.89.0.11/installers/ftd-boot-9.10.1.3.lfbff'
    image_file_location: 'https://10.89.0.11/installers/ftd-6.3.0-83.pkg'
    image_version: 6.3.0-83

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

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

Ключ	Возвращаемое значение	Описание
msg строка	всегда	Сообщение, указывающее, был ли образ установлен или объяснение причины, по которой установка не удалась.

Авторы

Cisco Systems, Inc. (@annikulin)

© 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/network/ftd_install_module.html