Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_software_update — обновление программного обеспечения NetApp ONTAP

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_software_update.

Добавлено в netapp.ontap 2.7.0

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

Краткое описание

  • Обновление программного обеспечения ONTAP
  • Требуется подключение по HTTPS; подключение по HTTP не поддерживается

Требования

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

  • Ansible 2.9 или более поздней версии; рекомендуется версия 2.12 или более поздняя.
  • Python3; рекомендуется версия 3.9 или более поздняя.
  • netapp-lib — только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib объявлена устаревшей и больше не поддерживается. Используйте на свой страх и риск.
  • Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии, для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр

Комментарии

cert_filepath

string

добавлено в netapp.ontap 20.6.0

путь к файлу сертификата клиента SSL (.pem).

Не поддерживается в Python 2.6.

download_only

boolean

добавлено в netapp.ontap 20.4.0

Позволяет загрузить образ без обновления.

Варианты:

  • false ← (по умолчанию)
  • true

feature_flags

dictionary

добавлено в netapp.ontap 20.5.0

Включение или отключение новой функции.

Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются.

force_ontap_version

string

добавлено в netapp.ontap 21.23.0

Переопределяет версию ONTAP кластера при использовании REST.

Если версия не совпадает с версией целевого кластера, поведение не определено.

Этот параметр служит обходным решением в случаях, когда из-за проблем с правами доступа невозможно прочитать версию кластера. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Значение должно иметь формат 9.10 или 9.10.1, где каждый компонент является целым числом.

Если use_rest имеет значение auto, этот параметр может принудительно переключить модуль на ZAPI в зависимости от версии и возможностей платформы.

Игнорируется при использовании ZAPI.

force_update

boolean

добавлено в netapp.ontap 20.11.0

принудительно выполняет обновление, даже если package_version совпадает с установленной версией.

Варианты:

  • false ← (по умолчанию)
  • true

hostname

string / обязательный

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределяет порт по умолчанию (80 или 443), задавая этот порт

https

boolean

Включает и отключает HTTPS.

Варианты:

  • false
  • true ← (по умолчанию)

ignore_validation_warning

псевдонимы: skip_warnings

boolean

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

Варианты:

  • false ← (по умолчанию)
  • true

key_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу ключа клиента SSL.

nodes

псевдонимы: node, nodes_to_update

list / элементы=string

Список обновляемых узлов; узлы должны входить в пару высокой доступности (HA).

Для REST требуется ONTAP 9.9.

ontapi

integer

Версия API ONTAP, которую следует использовать

package_url

string

Задает URL-адрес пакета для его загрузки.

Обязательный параметр, если state имеет значение present, за исключением случаев, когда пакет уже находится на диске.

package_version

string / обязательный

Задает версию пакета, до которой следует обновить программное обеспечение ONTAP, или версию пакета, который следует удалить.

password

псевдоним: pass

string

Пароль указанного пользователя.

stabilize_minutes

integer

добавлено в netapp.ontap 20.6.0

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

Для REST требуется ONTAP 9.8.

state

string

Этот модуль загружает и при необходимости устанавливает программное обеспечение ONTAP в кластере.

После успешной установки пакет программного обеспечения удаляется.

Если пакет программного обеспечения уже находится на диске, он не загружается и не заменяется.

Если state имеет значение absent, пакет удаляется с диска.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

timeout

integer

Время ожидания завершения обновления в секундах.

По умолчанию: 1800

use_lambda

boolean

добавлено в netapp.ontap 23.2.0

Указывает, следует ли использовать функциональность прокси AWS Lambda для подключения к системе ONTAP.

Поддерживается только с REST.

Варианты:

  • false ← (по умолчанию)
  • true

use_rest

string

Использовать REST или ZAPI.

always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка.

never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка.

auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае использовать ZAPI.

По умолчанию: "always"

username

псевдоним: user

string

Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или SVM.

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации

  1. Базовая аутентификация с использованием имени пользователя и пароля.
  2. Аутентификация по сертификату SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа.

Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.

validate_after_download

boolean

добавлено в netapp.ontap 21.11.0

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

Для систем MetroCluster параметр download_only следует сначала запустить на одном из сайтов MetroCluster. После завершения задания обновите остальные сайты.

Варианты:

  • false ← (по умолчанию)
  • true

validate_certs

boolean

Если задано значение no, сертификаты SSL проверяться не будут.

Задавайте значение False только на сайтах под личным управлением, использующих самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Для выполнения обновлений без прерывания работы ONTAP требует, чтобы узлы входили в пары высокой доступности (HA).
  • В конфигурации с одним узлом он обновляется и перезагружается.
  • Поддерживаются ZAPI и REST.
  • Поддерживается check_mode.
  • Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
  • HTTPS включен по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: start ONTAP software update Precheck on Metrocluster DR Site B
  netapp.ontap.na_ontap_software_update:
    state: present
    nodes: "{{ nodes }}"
    package_url: "{{ url }}"
    download_only: true
    validate_after_download: true
    package_version: "9.16.1P4"
    ignore_validation_warning: true
    timeout: 36000
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: start ONTAP software update on DR Site A
  netapp.ontap.na_ontap_software_update:
    state: present
    nodes: "{{ nodes }}"
    package_url: "{{ url }}"
    package_version: "9.16.1P4"
    ignore_validation_warning: true
    timeout: 36000
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

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

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

Ключ

Описание

validation_reports

string

validation_reports_after_update в виде строки для обратной совместимости.

Возвращается: всегда

validation_reports_after_download

list / элементы=string

Список отчетов о проверке после загрузки пакета программного обеспечения.

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

Возвращается: всегда

validation_reports_after_updates

list / элементы=string

Список отчетов о проверке после попытки обновления пакета программного обеспечения.

Возвращается: всегда

Авторы

  • Команда NetApp Ansible (@carchi8py)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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/netapp/ontap/na_ontap_software_update_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API