ansible.posix.mount – Управление активными и настроенными точками монтирования

Примечание

Этот плагин входит в состав коллекции ansible.posix (версия 1.1.1).

Для его установки используйте: ansible-galaxy collection install ansible.posix.

Для использования в книге задач укажите: ansible.posix.mount.

Новое в версии 1.0.0: модуля ansible.posix

Описание
Параметры
Примечания
Примеры

Описание

Этот модуль управляет активными и настроенными точками монтирования в /etc/fstab.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backup boolean	Варианты: нет ← да	Создать резервную копию файла, включая информацию о дате и времени, чтобы вы могли восстановить исходный файл, если по ошибке его повредите.
boot boolean	Варианты: нет да ←	Определяет, должен ли файловая система монтироваться при загрузке. Применимо только к системам Solaris.
dump string	Значение по умолчанию: 0	Dump (см. fstab(5)). Обратите внимание, что если установлено значение `null`, а state установлено в `present`, это перестанет работать, и будут создаваться дублирующиеся записи при последующих запусках. Не оказывает влияния на системы Solaris.
fstab string		Файл для использования вместо `/etc/fstab`. Не следует использовать этот параметр, если вы не знаете, что делаете. Это может быть полезно, если вам нужно настроить точки монтирования в среде chroot. OpenBSD не позволяет указывать альтернативные файлы fstab при монтировании, поэтому не используйте это на OpenBSD с любым состоянием, работающим с активной файловой системой. Этот параметр по умолчанию устанавливается в /etc/fstab или /etc/vfstab на системах Solaris.
fstype string		Тип файловой системы. Требуется, когда state имеет значение `present` или `mounted`.
opts string		Параметры монтирования (см. fstab(5) или vfstab(4) на системах Solaris).
passno string	Значение по умолчанию: 0	Passno (см. fstab(5)). Обратите внимание, что если установлено значение `null`, а state установлено в `present`, это перестанет работать, и будут создаваться дублирующиеся записи при последующих запусках. Устарело для систем Solaris.
path путь / обязательно		Путь к точке монтирования (например, `/mnt/files`). До Ansible 2.3 этот параметр был доступен только как dest, destfile и name. псевдонимы: name
src путь		Устройство (или объем NFS, или что-то еще), которое необходимо смонтировать на path. Требуется, когда state установлено в `present` или `mounted`.
state строка / обязательно	Варианты: absent mounted present unmounted remounted	Если `mounted`, устройство будет активно смонтировано и должным образом настроено в fstab. Если точка монтирования отсутствует, она будет создана. Если `unmounted`, устройство будет размонтировано без изменения fstab. `present` только указывает, что устройство должно быть настроено в fstab и не запускает и не требует монтирования. `absent` указывает, что запись монтирования устройства будет удалена из fstab, а также размонтирует устройство и удалит точку монтирования. `remounted` указывает, что устройство будет повторно смонтировано для принудительного обновления самого монтирования (добавлен в 2.9). Это всегда вернет changed=true. Если opts установлен, параметры будут применены к повторному монтированию, но fstab не изменится. Кроме того, если opts установлен, а команда повторного монтирования завершается ошибкой, модуль выдаст ошибку, чтобы предотвратить непредвиденные изменения монтирования. Попробуйте использовать `mounted` вместо этого, чтобы обойти эту проблему.

Примечания

Примечание

Начиная с Ansible 2.3, параметр name изменён на path по умолчанию, но name всё ещё работает.
Использование remounted с установленным параметром opts может привести к неожиданным результатам, в зависимости от уже определённых параметров монтирования, поэтому следует тщательно убедиться, что противоречивых параметров нет.

Примеры

# Before 2.3, option 'name' was used instead of 'path'
- name: Mount DVD read-only
  ansible.posix.mount:
    path: /mnt/dvd
    src: /dev/sr0
    fstype: iso9660
    opts: ro,noauto
    state: present

- name: Mount up device by label
  ansible.posix.mount:
    path: /srv/disk
    src: LABEL=SOME_LABEL
    fstype: ext4
    state: present

- name: Mount up device by UUID
  ansible.posix.mount:
    path: /home
    src: UUID=b3e48f45-f933-4c8e-a700-22a159ec9077
    fstype: xfs
    opts: noatime
    state: present

- name: Unmount a mounted volume
  ansible.posix.mount:
    path: /tmp/mnt-pnt
    state: unmounted

- name: Remount a mounted volume
  ansible.posix.mount:
    path: /tmp/mnt-pnt
    state: remounted

# The following will not save changes to fstab, and only be temporary until
# a reboot, or until calling "state: unmounted" followed by "state: mounted"
# on the same "path"
- name: Remount a mounted volume and append exec to the existing options
  ansible.posix.mount:
    path: /tmp
    state: remounted
    opts: exec

- name: Mount and bind a volume
  ansible.posix.mount:
    path: /system/new_volume/boot
    src: /boot
    opts: bind
    state: mounted
    fstype: none

- name: Mount an NFS volume
  ansible.posix.mount:
    src: 192.168.1.100:/nfs/ssd/shared_data
    path: /mnt/shared_data
    opts: rw,sync,hard,intr
    state: mounted
    fstype: nfs

Авторы

Команда разработчиков Ansible
Сет Видаль (@skvidal)

© 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/ansible/posix/mount_module.html