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