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

Примечание

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

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

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

Новое в версии 1.0.0: of ansible.posix

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backup boolean	Варианты: no ← yes	Создает резервную копию файла, включая информацию о времени создания, чтобы вы могли восстановить исходный файл, если его неправильно перезаписали.
boot boolean	Варианты: no yes ←	Определяет, должен ли файловая система быть смонтирована при загрузке. Применимо только к системам Solaris.
dump string	Значение по умолчанию: 0	Dump (см. fstab(5)). Обратите внимание, что если установлено значение `null` и state установлено на `present`, это перестанет работать, и будут созданы дублирующиеся записи при последующих запусках. Не оказывает влияния на системы Solaris.
fstab string		Файл для использования вместо `/etc/fstab`. Вы не должны использовать этот параметр, если вы не точно знаете, что делаете. Это может быть полезно, если вам нужно настроить точки монтирования в среде chroot. OpenBSD не позволяет указывать альтернативные файлы fstab с mount, поэтому не используйте это на 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 path / required		Путь к точке монтирования (например, `/mnt/files`). До Ansible 2.3 этот параметр был доступен только как dest, destfile и name. псевдонимы: имя
src path		Устройство (или NFS-том, или что-то еще), которое должно быть смонтировано в path. Требуется, когда state установлено на `present` или `mounted`.
state string / required	Варианты: 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
Seth Vidal (@skvidal)

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