Модуль community.general.lvol — настройка логических томов LVM

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

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

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

Чтобы использовать коллекцию в плейбуке, укажите: community.general.lvol.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры

Краткое описание

Этот модуль создает, удаляет логические тома или изменяет их размер.

Параметры

Параметр	Комментарии
active boolean	Указывает, активен ли том и виден ли он хосту. Варианты: `false` `true` ← (по умолчанию)
force boolean	Для операций уменьшения размера или удаления томов требуется этот параметр. Он предотвращает случайное повреждение или уничтожение файловых систем. Варианты: `false` ← (по умолчанию) `true`
lv string	Имя логического тома.
opts string	Произвольные параметры, передаваемые команде lvcreate.
pvs list / элементы=string	Список физических томов (например, `/dev/sda, /dev/sdb`).
resizefs boolean	Изменить размер файловой системы вместе с логическим томом. Поддерживаются файловые системы `ext2`, `ext3`, `ext4`, `reiserfs` и `XFS`. Попытка изменить размер файловой системы другого типа приведет к ошибке. Варианты: `false` ← (по умолчанию) `true`
shrink boolean	Уменьшать размер, если текущий размер превышает запрошенный. Варианты: `false` `true` ← (по умолчанию)
size string	Размер логического тома согласно lvcreate(8) `--size`; по умолчанию — в мегабайтах, при необходимости можно указать одну из единиц [bBsSkKmMgGtTpPeE]; или согласно lvcreate(8) `--extents` — в процентах от [VG\|PVS\|FREE\|ORIGIN]. Значения с плавающей точкой должны начинаться с цифры. При изменении размера, помимо указания абсолютного размера, согласно lvextend(8)\|lvreduce(8) `--size` можно указать величину увеличения логического тома с префиксом `+` или величину уменьшения логического тома с префиксом `-`. Изменение размера с помощью `+` или `-` не поддерживалось до версии community.general 3.0.0. Обратите внимание: при использовании `+`, `-` или процентного значения FREE модуль не является идемпотентным.
snapshot string	Имя настраиваемого тома-снимка. При создании тома-снимка параметр `lv` указывает исходный том.
state string	Управляет существованием логического тома. Если указано `present` и том еще не существует, требуется параметр `size`. Варианты: `"absent"` `"present"` ← (по умолчанию)
thinpool string	Имя тома тонкого пула. Чтобы создать том с тонким выделением ресурсов, укажите имя тома тонкого пула.
vg string / обязательный	Группа томов, к которой относится этот логический том.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме `check_mode` и возвращать прогноз изменения состояния без изменения целевого узла.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о том, что, возможно, требуется изменить в `check_mode`).

Примечания

Примечание

Необходимо указать lv (при управлении состоянием логических томов) или thinpool (при управлении томом с тонким выделением ресурсов).

Примеры

- name: Create a logical volume of 512m
  community.general.lvol:
    vg: firefly
    lv: test
    size: 512

- name: Create a logical volume of 512m with disks /dev/sda and /dev/sdb
  community.general.lvol:
    vg: firefly
    lv: test
    size: 512
    pvs:
      - /dev/sda
      - /dev/sdb

- name: Create cache pool logical volume
  community.general.lvol:
    vg: firefly
    lv: lvcache
    size: 512m
    opts: --type cache-pool

- name: Create a logical volume of 512g.
  community.general.lvol:
    vg: firefly
    lv: test
    size: 512g

- name: Create a logical volume the size of all remaining space in the volume group
  community.general.lvol:
    vg: firefly
    lv: test
    size: 100%FREE

- name: Create a logical volume with special options
  community.general.lvol:
    vg: firefly
    lv: test
    size: 512g
    opts: -r 16

- name: Extend the logical volume to 1024m.
  community.general.lvol:
    vg: firefly
    lv: test
    size: 1024

- name: Extend the logical volume to consume all remaining space in the volume group
  community.general.lvol:
    vg: firefly
    lv: test
    size: +100%FREE

- name: Extend the logical volume by given space
  community.general.lvol:
    vg: firefly
    lv: test
    size: +512M

- name: Extend the logical volume to take all remaining space of the PVs and resize the underlying filesystem
  community.general.lvol:
    vg: firefly
    lv: test
    size: 100%PVS
    resizefs: true

- name: Resize the logical volume to % of VG
  community.general.lvol:
    vg: firefly
    lv: test
    size: 80%VG
    force: true

- name: Reduce the logical volume to 512m
  community.general.lvol:
    vg: firefly
    lv: test
    size: 512
    force: true

- name: Reduce the logical volume by given space
  community.general.lvol:
    vg: firefly
    lv: test
    size: -512M
    force: true

- name: Set the logical volume to 512m and do not try to shrink if size is lower than current one
  community.general.lvol:
    vg: firefly
    lv: test
    size: 512
    shrink: false

- name: Remove the logical volume.
  community.general.lvol:
    vg: firefly
    lv: test
    state: absent
    force: true

- name: Create a snapshot volume of the test logical volume.
  community.general.lvol:
    vg: firefly
    lv: test
    snapshot: snap1
    size: 100m

- name: Deactivate a logical volume
  community.general.lvol:
    vg: firefly
    lv: test
    active: false

- name: Create a deactivated logical volume
  community.general.lvol:
    vg: firefly
    lv: test
    size: 512g
    active: false

- name: Create a thin pool of 512g
  community.general.lvol:
    vg: firefly
    thinpool: testpool
    size: 512g

- name: Create a thin volume of 128g
  community.general.lvol:
    vg: firefly
    lv: test
    thinpool: testpool
    size: 128g

Авторы

Jeroen Hoekx (@jhoekx)
Alexander Bulimov (@abulimov)
Raoul Baudach (@unkaputtbar112)
Ziga Kern (@zigaSRC)

Ссылки на коллекцию

© 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/community/general/lvol_module.html