Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_nfs — состояние NFS в NetApp ONTAP

Примечание

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

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

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

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

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

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры

Обзор

  • Включение или отключение NFS в ONTAP

Требования

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

  • Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
  • Python 3 — рекомендуется версия 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.

credential_cache

dictionary

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

Этот параметр можно задать или изменить при использовании REST.

Если параметр не указан в POST, ONTAP использует значения TTL по умолчанию.

Требуется ONTAP 9.11.0 или более поздней версии.

negative_ttl

integer

Задает срок хранения в миллисекундах отрицательно кэшированных учетных данных, по истечении которого они удаляются из кэша.

positive_ttl

integer

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

transient_error_ttl

integer

Задает срок хранения в миллисекундах кэшированных записей при временной ошибке.

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.

hostname

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

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

http_port

integer

Переопределяет порт по умолчанию (80 или 443), используя указанный порт.

https

boolean

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

Игнорируется при использовании REST, так как поддерживается только HTTPS.

Игнорируется при использовании аутентификации с сертификатом SSL, поскольку для нее требуется SSL.

Варианты:

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

key_filepath

string

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

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

lambda_config

dictionary

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

Параметры конфигурации прокси-функциональности AWS Lambda.

Этот параметр и его подопции поддерживаются только при использовании REST.

aws_profile

string

Имя профиля AWS для аутентификации.

aws_region

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

Имя региона AWS.

function_name

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

Имя вызываемой функции AWS Lambda.

nfsv3

string

Состояние NFSv3.

Варианты:

  • "enabled"
  • "disabled"

nfsv3_64bit_identifiers_enabled

string

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

Указывает, включена ли поддержка 64-разрядных FSID и идентификаторов файлов для NFSv3.

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

Варианты:

  • "enabled"
  • "disabled"

nfsv3_connection_drop

string

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

Указывает, включено ли разрывание соединения при сбросе запроса NFSv3.

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

Варианты:

  • "enabled"
  • "disabled"

nfsv3_ejukebox_enabled

string

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

Указывает, включена ли ошибка EJUKEBOX для NFSv3.

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

Варианты:

  • "enabled"
  • "disabled"

nfsv3_fsid_change

string

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

Указывает, видят ли клиенты NFSv3 изменение FSID при перемещении по файловым системам.

Поддержка REST добавлена в версии коллекции 23.2.0; требуется ONTAP 9.11.0 или более поздней версии.

Варианты:

  • "enabled"
  • "disabled"

nfsv3_hide_snapdir

string

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

Указывает, включено ли скрытие каталога моментальных снимков в точке монтирования NFSv3 (поддерживается начиная с ONTAP 9.13).

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

Варианты:

  • "enabled"
  • "disabled"

nfsv3_mount_root_only

string

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

Указывает, разрешает ли SVM вызовы протокола MOUNT только с привилегированных портов (номера портов меньше 1024).

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

Варианты:

  • "enabled"
  • "disabled"

nfsv4

string

Состояние NFSv4.

Варианты:

  • "enabled"
  • "disabled"

nfsv40_acl

string

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

Состояние функции ACL NFS v4.0.

Варианты:

  • "enabled"
  • "disabled"

nfsv40_acl_preserve

string

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

Указывает, сохраняется ли ACL NFSv4 или удаляется при выполнении chmod.

При использовании унифицированного стиля безопасности этот параметр также указывает, сохраняются ли разрешения NTFS для файлов или удаляются при выполнении chmod, chgrp или chown.

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

Варианты:

  • "enabled"
  • "disabled"

nfsv40_read_delegation

string

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

Состояние функции делегирования чтения NFS v4.0.

Варианты:

  • "enabled"
  • "disabled"

nfsv40_referrals

string

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

Состояние перенаправлений NFS v4.0.

Поддержка REST добавлена в версии коллекции 23.2.0; требуется ONTAP 9.13.1 или более поздней версии.

Варианты:

  • "enabled"
  • "disabled"

nfsv40_write_delegation

string

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

Состояние функции делегирования записи NFS v4.0.

Варианты:

  • "enabled"
  • "disabled"

nfsv41

псевдонимы: nfsv4.1

string

Состояние NFSv41.

Использование nfsv4.1 считается устаревшим, поскольку оно не соответствует соглашению об именовании Ansible. Псевдоним будет удален.

Для этого параметра используйте только nfsv41.

Варианты:

  • "enabled"
  • "disabled"

nfsv41_acl

string

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

Состояние функции ACL NFS v4.1.

Варианты:

  • "enabled"
  • "disabled"

nfsv41_pnfs

string

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

Состояние pNFS для NFSv41.

Варианты:

  • "enabled"
  • "disabled"

nfsv41_read_delegation

string

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

Состояние функции делегирования чтения NFS v4.1.

Варианты:

  • "enabled"
  • "disabled"

nfsv41_referrals

string

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

Состояние перенаправлений NFS v4.1.

Поддержка REST добавлена в версии коллекции 23.2.0; требуется ONTAP 9.13.1 или более поздней версии.

Варианты:

  • "enabled"
  • "disabled"

nfsv41_write_delegation

string

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

Состояние функции делегирования записи NFS v4.1.

Варианты:

  • "enabled"
  • "disabled"

nfsv42_seclabel_enabled

string

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

Указывает, включена ли метка безопасности NFSv4.2 или более поздней версии.

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

Варианты:

  • "enabled"
  • "disabled"

nfsv42_xattrs_enabled

string

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

Указывает, включены ли расширенные атрибуты NFSv4.2 или более поздней версии.

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

Варианты:

  • "enabled"
  • "disabled"

nfsv4_64bit_identifiers_enabled

string

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

Указывает, включена ли поддержка 64-разрядных FSID и идентификаторов файлов для NFSv4.x.

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

Варианты:

  • "enabled"
  • "disabled"

nfsv4_fsid_change

string

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

Указывает, видят ли клиенты NFSv4 изменение FSID при перемещении по файловым системам.

Поддержка REST добавлена в версии коллекции 23.2.0; требуется ONTAP 9.13.1 или более поздней версии.

Варианты:

  • "enabled"
  • "disabled"

nfsv4_grace_seconds

integer

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

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

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

nfsv4_id_domain

string

Имя используемого nfsv4_id_domain.

nfsv4_lease_seconds

integer

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

Задает срок аренды для клиентов NFSv4 в секундах. Если клиент неактивен дольше указанного времени, все состояния блокировок файлов на узле могут быть потеряны.

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

nfsv4_numeric_ids

string

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

Состояние числовых идентификаторов NFSv4.

Варианты:

  • "enabled"
  • "disabled"

ontapi

integer

Используемая версия API ONTAP.

password

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

string

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

root

dictionary

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

Этот параметр можно задать или изменить при использовании REST.

Требуется ONTAP 9.11.0 или более поздней версии.

ignore_nt_acl

boolean

Указывает, влияют ли списки управления доступом Windows (ACL) на доступ root через NFS.

Если этот параметр включен, доступ root через NFS игнорирует ACL NT, заданный для файла или каталога.

Варианты:

  • false
  • true

skip_write_permission_check

boolean

Указывает, следует ли пропускать проверку разрешений для вызовов NFS WRITE от root/владельца.

Для копирования файлов только для чтения в целевую папку с наследуемыми ACL этот параметр необходимо включить.

Варианты:

  • false
  • true

security

dictionary

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

Этот параметр можно задать или изменить при использовании REST.

Требуется ONTAP 9.11.0 или более поздней версии.

chown_mode

string

Указывает, может ли изменять владельца файла только суперпользователь или это также может делать пользователь без прав root.

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

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

Если для этого параметра задано значение use-export-policy, владелец файла может быть изменен в соответствии с соответствующими правилами экспорта.

Варианты:

  • "restricted"
  • "unrestricted"
  • "use_export_policy"

nt_acl_display_permission

boolean

Управляет разрешениями, отображаемыми клиентам NFSv3 и NFSv4 для файла или каталога, которому назначен NT ACL.

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

Если задано значение false, отображаемые разрешения основаны на минимальном уровне доступа, предоставленном NT ACL любому пользователю.

Варианты:

  • false
  • true

ntfs_unix_security

string

Указывает, как изменения безопасности NFSv3 влияют на тома NTFS.

Если для этого параметра задано значение ignore, ONTAP игнорирует изменения безопасности NFSv3.

Если для этого параметра задано значение fail, оно имеет приоритет над параметрами безопасности UNIX, заданными в соответствующих правилах экспорта.

Если для этого параметра задано значение use_export_policy, ONTAP обрабатывает изменения безопасности NFSv3 в соответствии с соответствующими правилами экспорта.

Варианты:

  • "ignore"
  • "fail"
  • "use_export_policy"

permitted_encryption_types

list / elements=string

Указывает допустимые типы шифрования для Kerberos поверх NFS.

rpcsec_context_idle

integer

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

service_state

string

Определяет, следует ли включить или отключить указанную службу NFS. Если служба NFS не существует, она создается.

Варианты:

  • "started"
  • "stopped"

showmount

string

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

Определяет, разрешает ли SVM использование showmount.

Поддержка REST доступна начиная с ONTAP версии 9.8.

Варианты:

  • "enabled"
  • "disabled"

state

string

Определяет, должна ли существовать служба NFS.

Варианты:

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

tcp

string

Включить TCP (поддерживается начиная с ONTAP 9.3).

Варианты:

  • "enabled"
  • "disabled"

tcp_max_xfer_size

integer

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

Максимальный размер передачи TCP (в байтах). Значение по умолчанию — 65536.

Для этого параметра при использовании REST требуется ONTAP 9.11.0 или более поздней версии.

udp

string

Включить UDP (поддерживается начиная с ONTAP 9.3).

Варианты:

  • "enabled"
  • "disabled"

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_certs

boolean

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

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

Варианты:

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

vserver

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

Имя используемого vserver.

vstorage_state

string

Состояние vstorage_state.

Варианты:

  • "enabled"
  • "disabled"

windows

dictionary

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

Этот параметр можно задать или изменить при использовании REST.

Требуется ONTAP 9.11.0 или более поздней версии.

default_user

string

Указывает пользователя Windows по умолчанию для NFS-сервера.

map_unknown_uid_to_default_user

boolean

Указывает, включено ли сопоставление неизвестного UID с пользователем Windows по умолчанию.

Варианты:

  • false
  • true

v3_ms_dos_client_enabled

boolean

Указывает, включена ли поддержка клиентов MS-DOS для NFSv3.

Варианты:

  • false
  • true

Примечания

Примечание

  • Поддерживается функция прокси AWS Lambda при использовании REST. Примеры см. в файле README.
  • Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
  • HTTPS включен по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Change nfs status
  netapp.ontap.na_ontap_nfs:
    state: present
    service_state: stopped
    vserver: vs_hack
    nfsv3: disabled
    nfsv4: disabled
    nfsv41: enabled
    tcp: disabled
    udp: disabled
    vstorage_state: disabled
    nfsv4_id_domain: example.com
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create nfs configuration - REST
  netapp.ontap.na_ontap_nfs:
    state: present
    service_state: stopped
    vserver: vs_hack
    nfsv3: disabled
    nfsv4: disabled
    nfsv41: enabled
    tcp: disabled
    udp: disabled
    vstorage_state: disabled
    nfsv4_id_domain: example.com
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify nfs configuration - REST
  netapp.ontap.na_ontap_nfs:
    state: present
    vserver: vs_hack
    root:
      ignore_nt_acl: true
      skip_write_permission_check: true
    security:
      chown_mode: restricted
      nt_acl_display_permission: true
      ntfs_unix_security: fail
      rpcsec_context_idle: 5
    windows:
      v3_ms_dos_client_enabled: true
      map_unknown_uid_to_default_user: false
      default_user: test_user
    tcp_max_xfer_size: 16384
    nfsv3_hide_snapdir: enabled
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete nfs configuration
  netapp.ontap.na_ontap_nfs:
    state: absent
    vserver: vs_hack
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

  • Команда 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_nfs_module.html

Spec-Zone.ru

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