udm_share — Управление сетевыми ресурсами Samba на корпоративном сервере Univention
Обзор
- Этот модуль позволяет управлять сетевыми ресурсами Samba на корпоративном сервере Univention (UCS). Он использует Python API UCS для создания нового объекта или редактирования существующего.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| directorymode | По умолчанию: "00755" | Разрешения для корневой директории общего ресурса. |
| group | По умолчанию: "0" | Группа владельца директории общего ресурса. |
| host | FQDN хоста (сервер, предоставляющий общий ресурс), например, {{ ansible_fqdn }}. Требуется, если state=present. | |
| name обязательно | Имя | |
| nfs_custom_settings | По умолчанию: [] | Имя опции в файле экспорта. псевдонимы: nfsCustomSettings |
| nfs_hosts | По умолчанию: [] | Разрешить доступ только для этого хоста, IP-адреса или сети. |
| ou обязательно | Организационная единица внутри базового DN LDAP. | |
| owner | По умолчанию: 0 | Владелец директории общего ресурса. |
| path | Директория на сервере, предоставляющем общий ресурс, например, /home. Требуется, если state=present. | |
| root_squash |
| Изменить идентификатор пользователя для пользователя root (root squashing). |
| samba_block_size | Размер блока. псевдонимы: sambaBlockSize | |
| samba_blocking_locks |
| Блокирующие блокировки. псевдонимы: sambaBlockingLocks |
| samba_browseable |
| Отображать в среде Windows Network. псевдонимы: sambaBrowseable |
| samba_create_mode | По умолчанию: "0744" | Режим файла. псевдонимы: sambaCreateMode |
| samba_csc_policy | По умолчанию: "manual" | Политика кеширования на стороне клиента. псевдонимы: sambaCscPolicy |
| samba_custom_settings | По умолчанию: [] | Имя опции в smb.conf и его значение. псевдонимы: sambaCustomSettings |
| samba_directory_mode | По умолчанию: "0755" | Режим директории. псевдонимы: sambaDirectoryMode |
| samba_directory_security_mode | По умолчанию: "0777" | Режим безопасности директории. псевдонимы: sambaDirectorySecurityMode |
| samba_dos_filemode |
| Пользователи с правом записи могут изменять разрешения. псевдонимы: sambaDosFilemode |
| samba_fake_oplocks |
| Имитация oplocks. псевдонимы: sambaFakeOplocks |
| samba_force_create_mode |
| Вынужденный режим файла. псевдонимы: sambaForceCreateMode |
| samba_force_directory_mode |
| Вынужденный режим директории. псевдонимы: sambaForceDirectoryMode |
| samba_force_directory_security_mode |
| Вынужденный режим безопасности директории. псевдонимы: sambaForceDirectorySecurityMode |
| samba_force_group | Вынужденная группа. псевдонимы: sambaForceGroup | |
| samba_force_security_mode |
| Вынужденный режим безопасности. псевдонимы: sambaForceSecurityMode |
| samba_force_user | Вынужденный пользователь. псевдонимы: sambaForceUser | |
| samba_hide_files | Скрыть файлы. псевдонимы: sambaHideFiles | |
| samba_hide_unreadable |
| Скрыть недоступные файлы/директории. псевдонимы: sambaHideUnreadable |
| samba_hosts_allow | По умолчанию: [] | Разрешенные хосты/сети. псевдонимы: sambaHostsAllow |
| samba_hosts_deny | По умолчанию: [] | Запрещенные хосты/сети. псевдонимы: sambaHostsDeny |
| samba_inherit_acls |
| Наследование ACL. псевдонимы: sambaInheritAcls |
| samba_inherit_owner |
| Создавать файлы/директории с владельцем родительской директории. псевдонимы: sambaInheritOwner |
| samba_inherit_permissions |
| Создавать файлы/директории с правами родительской директории. псевдонимы: sambaInheritPermissions |
| samba_invalid_users | Недействительные пользователи или группы. псевдонимы: sambaInvalidUsers | |
| samba_level_2_oplocks |
| Oplocks уровня 2. псевдонимы: sambaLevel2Oplocks |
| samba_locking |
| Блокировка. псевдонимы: sambaLocking |
| samba_msdfs_root |
| Корень MSDFS. псевдонимы: sambaMSDFSRoot |
| samba_name | Имя в Windows. Требуется, если state=present.псевдонимы: sambaName | |
| samba_nt_acl_support |
| Поддержка NT ACL. псевдонимы: sambaNtAclSupport |
| samba_oplocks |
| Oplocks. псевдонимы: sambaOplocks |
| samba_postexec | Скрипт postexec. псевдонимы: sambaPostexec | |
| samba_preexec | Скрипт preexec. псевдонимы: sambaPreexec | |
| samba_public |
| Разрешить анонимный доступ только для чтения с помощью гостевого пользователя. псевдонимы: sambaPublic |
| samba_security_mode | По умолчанию: "0777" | Режим безопасности. псевдонимы: sambaSecurityMode |
| samba_strict_locking | По умолчанию: "Auto" | Строгая блокировка. псевдонимы: sambaStrictLocking |
| samba_valid_users | Действительные пользователи или группы. псевдонимы: sambaValidUsers | |
| samba_vfs_objects | Объекты VFS. псевдонимы: sambaVFSObjects |
| samba_write_list | Ограничить запись для этих пользователей/групп. псевдонимы: sambaWriteList | |
| samba_writeable |
| Доступ к записи Samba. псевдонимы: sambaWriteable |
| state |
| Наличие общего ресурса. |
| subtree_checking |
| Проверка поддерева. |
| sync | По умолчанию: "sync" | Синхронизация NFS. |
| writeable |
| Доступ к записи NFS. |
Примеры
# Create a share named home on the server ucs.example.com with the path /home.
- udm_share:
name: home
path: /home
host: ucs.example.com
sambaName: Home
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. в разделе здесь.
Автор
- Tobias Rueetschi (@2-B)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/udm_share_module.html
