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

Примечание

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

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

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

Для использования в playbook укажите: community.general.lvol.

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

Описание

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

Параметры

Параметр	Комментарии
active boolean	Указывает, активен ли том и виден ли он хосту. Варианты: `false` `true` ← (по умолчанию)
force boolean	Требуется для операций уменьшения или удаления томов. Обеспечивает, что файловые системы не будут повреждены/уничтожены случайно. Варианты: `false` ← (по умолчанию) `true`
lv string	Имя логического тома.
opts string	Произвольные параметры для передачи команде lvcreate.
pvs list / elements=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	Поддержка: отсутствует	В режиме сравнения вернёт подробности о том, что изменилось (или, возможно, требует изменения в `check_mode`).

Примечания

Примечание

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

END_OF_DOCUMENT_MARKER

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/lvol_module.html