netapp.ontap.na_ontap_interface – Конфигурация LIF NetApp ONTAP
Примечание
Этот плагин является частью коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в книге задач укажите: netapp.ontap.na_ontap_interface.
Новое в версии 2.6.0: of netapp.ontap
Обзор
- Создание/удаление и изменение LIF.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- Физическая или виртуальная кластеризованная система 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;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address строка | Указывает IP-адрес LIF. Требуется, когда state=present и is_ipv4_link_local равно false, а subnet_name не задано. | |
| admin_status строка |
| Указывает административный статус LIF. |
| cert_filepath строка добавлен в 20.6.0 от netapp.ontap | Путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| current_node строка | Указывает текущий узел LIF. По умолчанию, это home_node | |
| current_port строка | Указывает текущий порт LIF. | |
| dns_domain_name строка добавлен в 2.9.0 от netapp.ontap | Указывает уникальное полное доменное имя DNS-зоны этого LIF. | |
| failover_group строка добавлен в 20.1.0 от netapp.ontap | Указывает группу резервного копирования для LIF. | |
| failover_policy строка |
| Указывает политику резервного копирования для LIF. |
| feature_flags словарь добавлен в 20.5.0 от netapp.ontap | Включает или отключает новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| firewall_policy строка | Указывает политику брандмауэра для LIF. | |
| force_subnet_association логическое значение добавлен в 2.9.0 от netapp.ontap |
| Установите в значение true, чтобы получить адрес из указанной подсети и назначить подсеть LIF. |
| home_node строка | Указывает домашний узел LIF. По умолчанию, первый узел из кластера считается домашним узлом | |
| home_port строка | Указывает домашний порт LIF. Требуется, когда state=present
| |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределите порт по умолчанию (80 или 443) этим портом | |
| https логическое значение |
| Включает и отключает https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. |
| interface_name строка / обязательно | Указывает имя логического интерфейса (LIF). | |
| is_auto_revert логическое значение |
| Если true, данные LIF вернутся на свой домашний узел в определенных обстоятельствах, таких как запуск, и возможность балансировки нагрузки отключена автоматически |
| is_dns_update_enabled логическое значение добавлен в 2.9.0 от netapp.ontap |
| Указывает, включена ли функция обновления DNS для этого LIF. Динамические обновления будут отправляться для этого LIF, если обновления включены на уровне VServer. |
| is_ipv4_link_local логическое значение добавлен в 20.1.0 от netapp.ontap |
| Указывает, что LIF должен получить ipv4 link local адрес. Случай использования для этого - при создании кластерных LIF для автоматического назначения ipv4 link local адресов. |
| key_filepath строка добавлен в 20.6.0 от netapp.ontap | Путь к файлу SSL-ключа клиента. | |
| listen_for_dns_query логическое значение добавлен в 2.9.0 от netapp.ontap |
| Если True, этот IP-адрес будет принимать DNS-запросы для указанной dnszone. |
| netmask строка | Указывает маску подсети LIF. Требуется, когда state=present и is_ipv4_link_local равно false, а subnet_name не задано. | |
| ontapi целое число | Версия API ontap для использования | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| protocols список / элементы=строка | Указывает список протоколов данных, настроенных на LIF. По умолчанию значения в этом элементе — nfs, cifs и fcache. Другие поддерживаемые протоколы — iscsi и fcp. LIF может быть настроен так, чтобы не поддерживать никакие протоколы данных, указав 'none'. Значения протокола none, iscsi, fc-nvme или fcp не могут быть объединены с другими протоколами данных. Параметры address, netmask и firewall_policy не поддерживаются для опции 'fc-nvme'. | |
| role строка | Указывает роль LIF. При установке роли «intercluster» или «cluster» установка протокола не поддерживается. При создании роли «cluster» имя узла будет отображаться как префикс в имени LIF. Например, если указанное имя — clif, а имя узла — node1, имя LIF отображается в ONTAP как node1_clif. Возможные значения — 'undef', 'cluster', 'data', 'node-mgmt', 'intercluster', 'cluster-mgmt'. Требуется при state=present, если service_policy не указан, и версия ONTAP 9.8 или более поздняя. | |
| service_policy строка добавлен в 20.4.0 от netapp.ontap | Начиная с ONTAP 9.5, вы можете настроить политики сервиса LIF для идентификации одного сервиса или списка сервисов, которые будут использовать LIF. В ONTAP 9.5 вы можете назначить политики сервиса только для LIF в SVM администрирования. В ONTAP 9.6 вы дополнительно можете назначить политики сервиса для LIF в SVM данных. При указании политики сервиса для LIF, вам не нужно указывать протокол данных и роль для LIF. Обратите внимание, что роль по-прежнему требуется из-за проблемы ZAPI. Это ограничение устранено в ONTAP 9.8. Также поддерживается создание LIF с указанием роли и протоколов данных. | |
| state строка |
| Указывает, должен ли существовать указанный интерфейс или нет. |
| subnet_name строка добавлен в 2.8.0 от netapp.ontap | Подсеть, где выделяется адрес интерфейса. Если параметр не используется, IP-адрес должен быть предоставлен администратором во время настройки. | |
| use_rest строка | По умолчанию: "auto" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, которые необходимы модулю. В противном случае будет использоваться ZAPI. всегда -- всегда будет использовать REST API никогда -- всегда будет использовать ZAPI auto -- попытается использовать REST API |
| username строка | Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. базовая аутентификация, используя имя пользователя и пароль, 2. аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента и, необязательно, файл закрытого ключа. Для использования сертификата он должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификату. псевдонимы: user | |
| validate_certs логическое значение |
| Если установлено значение no, SSL-сертификаты не будут проверены.Это должно быть установлено только в False используемых на лично контролируемых сайтах с использованием самозаверяемых сертификатов. |
| vserver строка / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули, начинающиеся с na_ontap, разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create interface
na_ontap_interface:
state: present
interface_name: data2
home_port: e0d
home_node: laurentn-vsim1
role: data
protocols:
- nfs
- cifs
admin_status: up
failover_policy: local-only
firewall_policy: mgmt
is_auto_revert: true
address: 10.10.10.10
netmask: 255.255.255.0
force_subnet_association: false
dns_domain_name: test.com
listen_for_dns_query: true
is_dns_update_enabled: true
vserver: svm1
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Create cluster interface
na_ontap_interface:
state: present
interface_name: cluster_lif
home_port: e0a
home_node: cluster1-01
role: cluster
admin_status: up
is_auto_revert: true
is_ipv4_link_local: true
vserver: Cluster
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Migrate an interface
na_ontap_interface:
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
vserver: ansible
https: true
validate_certs: false
state: present
interface_name: carchi_interface3
home_port: e0d
home_node: ansdev-stor-1
current_node: ansdev-stor-2
role: data
failover_policy: local-only
firewall_policy: mgmt
is_auto_revert: true
address: 10.10.10.12
netmask: 255.255.255.0
force_subnet_association: false
admin_status: up
- name: Delete interface
na_ontap_interface:
state: absent
interface_name: data2
vserver: svm1
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_interface_module.html