fortios_system_firmware_upgrade – Выполнение обновления прошивки устройства FortiGate или FortiOS (FOS)

Новая версия 2.9.

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

Обзор

Этот модуль может выполнить обновление прошивки устройства FortiGate или FortiOS (FOS), указав источник обновления прошивки, имя файла и необходимость форматирования раздела загрузки перед обновлением. Примеры включают все параметры и значения, которые необходимо настроить в источниках данных перед использованием. Тестировалось с FOS v6.0.2

Требования

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

fortiosapi>=0.9.8

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
host строка			IP-адрес FortiOS или FortiGate.
https логическое значение		Варианты: нет да ←	Указывает, нужно ли использовать протокол HTTPS для запросов к FortiGate.
password строка		Значение по умолчанию: ""	Пароль FortiOS или FortiGate.
ssl_verify логическое значение		Варианты: нет да ←	Обеспечивает проверку сертификата FortiGate с помощью надлежащего центра сертификации.
system_firmware словарь / обязательно		Значение по умолчанию: null	Возможные параметры для тела запроса. Укажите источник обновления прошивки, имя файла и необходимость форматирования раздела загрузки перед обновлением.
	file_content строка		Предоставляется при загрузке файла: данные файла в кодировке base64. Не должно содержать пробелы или другие недопустимые символы base64. Должен быть включен в тело HTTP-запроса.
	filename строка / обязательно		Имя и путь к локальному файлу прошивки.
	format_partition логическое значение	Варианты: нет да	Установите в значение true, чтобы отформатировать раздел загрузки перед обновлением.
	source строка / обязательно	Варианты: загрузка usb fortiguard	Источник данных файла прошивки [загрузка\|usb\|fortiguard].
username строка			Имя пользователя FortiOS или FortiGate.
vdom строка		Значение по умолчанию: "root"	Виртуальная область, среди ранее определённых. VDOM — виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

Примечания

Примечание

Требуется библиотека fortiosapi, разработанная Fortinet
Выполняется как local_action в вашем playbook

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
   ssl_verify: "False"
  tasks:
  - name: Perform firmware upgrade with local firmware file.
    fortios_system_firmware:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      ssl_verify: "False"
      system_firmware:
        file_content: "<your_own_value>"
        filename: "<your_own_value>"
        format_partition: "<your_own_value>"
        source: "upload"
    register: fortios_system_firmware_upgrade_result

  - debug:
      var:
        # please check the following status to confirm
        fortios_system_firmware_upgrade_result.meta.results.status

  - name: Perform firmware upgrade with firmware file on USB.
    fortios_system_firmware_upgrade:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      ssl_verify: "False"
      system_firmware:
        filename: "<your_own_value>"
        format_partition: "<your_own_value>"
        source: "usb"
    register: fortios_system_firmware_upgrade_result

  - debug:
      var:
        # please check the following status to confirm
        fortios_system_firmware_upgrade_result.meta.results.status

  - name: Perform firmware upgrade from FortiGuard.
    fortios_system_firmware_upgrade:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      ssl_verify: "False"
      system_firmware:
        filename: "<your_own_value>"
        format_partition: "<your_own_value>"
        source: "fortiguard"
    register: fortios_system_firmware_upgrade_result

  - debug:
      var:
        # please check the following status to confirm
        fortios_system_firmware_upgrade_result.meta.results.status

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

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

Ключ	Возвращаемое значение	Описание
build строка	всегда	Номер сборки изображения fortigate Пример: 1547
http_method строка	всегда	Последний метод, используемый для предоставления содержимого в FortiGate Пример: POST
name строка	всегда	Имя таблицы, используемой для выполнения запроса Пример: firmware
path строка	всегда	Путь к таблице, используемой для выполнения запроса Пример: system
revision строка	всегда	Внутренний номер ревизии Пример: 17.0.2.10658
serial строка	всегда	Серийный номер устройства Пример: FGVMEVYYQT3AB5352
status строка	всегда	Указание результата операции Пример: успех
vdom строка	всегда	Используемая виртуальная область Пример: root
version строка	всегда	Версия FortiGate Пример: v5.6.3

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль содержится в сообществе Ansible. [сообщество]

Авторы

Don Yao (@fortinetps)
Miguel Angel Munoz (@mamunozgonzalez)
Nicolas Thomas (@thomnico)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/fortios_system_firmware_upgrade_module.html