netapp.ontap.na_ontap_software_update – NetApp ONTAP Update Software
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в плейбуке укажите: netapp.ontap.na_ontap_software_update.
Новое в версии 2.7.0: от netapp.ontap
Обзор
- Обновление ПО ONTAP
- Требуется подключение https и не поддерживается по протоколу http
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Ansible 2.6
- Сильно рекомендуется Ansible 2.9 или более поздние версии, так как они обеспечивают новую систему доставки коллекций.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- Сильно рекомендуется netapp-lib 2020.3.12, так как она обеспечивает лучшую обработку сообщений об ошибках для проблем с подключением.
- Чтобы включить http в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлено в 20.6.0 от netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с Python 2.6. | |
| download_only булево добавлено в 20.4.0 от netapp.ontap |
| Позволяет загрузить образ без обновления. |
| feature_flags словарь добавлено в 20.5.0 от netapp.ontap | Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| force_update булево добавлено в 20.11.0 от netapp.ontap |
| принудительно выполнить обновление, даже если package_version совпадает с тем, что указано как установленное. |
| hostname строка / требуется | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт | |
| https булево |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. |
| ignore_validation_warning булево |
| Разрешает продолжить обновление, если во время фазы проверки встречаются предупреждения. |
| key_filepath строка добавлено в 20.6.0 от netapp.ontap | путь к файлу закрытого ключа SSL-клиента. | |
| nodes список / элементы=строка | Список узлов, которые необходимо обновить, узлы должны входить в пару HA. псевдонимы: узел | |
| ontapi целое число | Версия API ontap для использования | |
| package_url строка / требуется | Указывает URL-адрес пакета для загрузки пакета. | |
| package_version строка / требуется | Указывает версию пакета для обновления ПО. | |
| password строка | Пароль для указанного пользователя. псевдонимы: пароль | |
| stabilize_minutes целое число добавлено в 20.6.0 от netapp.ontap | Количество минут, которое обновление должно ждать после завершения захвата или возврата. | |
| state строка |
| Указывает, следует ли обновлять указанный пакет ONTAP. |
| timeout целое число | Значение по умолчанию: 1800 | время ожидания завершения обновления в секундах. |
| use_rest строка | Значение по умолчанию: "auto" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае вернется к ZAPI. всегда -- всегда будет использовать REST API никогда -- всегда будет использовать ZAPI автоматически -- попытается использовать REST API |
| username строка | Это может быть учетная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. аутентификация по умолчанию, с использованием имени пользователя и пароля, 2. аутентификация по SSL-сертификату, с использованием файла SSL-сертификата клиента и, необязательно, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификату. псевдонимы: пользователь | |
| validate_certs булево |
| Если установлено значение no, SSL-сертификаты не будут проверены.Это следует установить только в False на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов. |
Примечания
Примечание
- Модули с префиксом na_ontap созданы для поддержки платформы хранения ONTAP.
Примеры
- name: ONTAP software update
na_ontap_software_update:
state: present
nodes: vsim1
package_url: "{{ url }}"
package_version: "{{ version_name }}"
ignore_validation_warning: True
download_only: True
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 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/netapp/ontap/na_ontap_software_update_module.html
