Модуль community.general.lvg — настройка групп томов LVM

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

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

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

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

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

Параметры

Параметр	Комментарии
force логическое значение	Если `true`, разрешает удалять группу томов с логическими томами. Варианты: `false` ← (по умолчанию) `true`
pesize строка	Размер физического экстента. `pesize` должен быть степенью двойки и составлять не менее одного сектора (размер сектора определяется как наибольший размер сектора среди PV, используемых в данный момент в VG) или не менее 128 КиБ. `pesize` можно дополнить суффиксом единицы измерения (k/K/m/M/g/G); единица измерения по умолчанию — мегабайт. По умолчанию: `"4"`
pv_options строка	Дополнительные параметры, передаваемые в `pvcreate` при создании группы томов. По умолчанию: `""`
pvresize логическое значение добавлено в community.general 0.2.0	Если `true`, изменить размер физического тома до максимально доступного. Варианты: `false` ← (по умолчанию) `true`
pvs список / элементы типа string	Список устройств, разделённых запятыми, которые следует использовать в качестве физических устройств в этой группе томов. Обязательный параметр при создании группы томов или изменении её размера. При необходимости модуль запускает `pvcreate`. Этот параметр задаёт желаемое состояние физических томов в группе томов. Если группа томов уже существует, физические тома, не указанные здесь, по умолчанию удаляются из неё. Чтобы добавить физические тома, не удаляя существующие неуказанные тома, задайте `remove_extra_pvs=false`.
remove_extra_pvs логическое значение добавлено в community.general 10.4.0	Удалять из группы томов физические тома, отсутствующие в `pvs`. Варианты: `false` `true` ← (по умолчанию)
reset_pv_uuid логическое значение добавлено в community.general 7.1.0	Следует ли заново генерировать UUID физических томов группы томов. Операция неидемпотентна. Указание этого параметра всегда приводит к изменению. Варианты: `false` ← (по умолчанию) `true`
reset_vg_uuid логическое значение добавлено в community.general 7.1.0	Следует ли заново генерировать UUID группы томов. Операция неидемпотентна. Указание этого параметра всегда приводит к изменению. Варианты: `false` ← (по умолчанию) `true`
state строка	Управляет наличием группы томов и её состоянием. Состояния `active` и `inactive` подразумевают состояние `present`. Добавлено в версии 7.1.0. При значении `active` или `inactive` модуль управляет текущим состоянием логических томов в VG. Модуль также управляет состоянием автоматической активации VG, если эта возможность поддерживается, за исключением случаев создания группы томов, когда параметр автоматической активации указан в `vg_options`. Варианты: `"absent"` `"present"` ← (по умолчанию) `"active"` `"inactive"`
vg строка / обязательный	Имя группы томов.
vg_options строка	Дополнительные параметры, передаваемые в `vgcreate` при создании группы томов. По умолчанию: `""`

Атрибуты

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

Примечания

Примечание

Этот модуль не изменяет размер PE для уже существующей группы томов.

См. также

community.general.filesystem: Создаёт файловую систему.
community.general.lvol: Настраивает логические тома LVM.
community.general.parted: Настраивает разделы блочных устройств.

Примеры

- name: Create a volume group on top of /dev/sda1 with physical extent size = 32MB
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sda1
    pesize: 32

- name: Create a volume group on top of /dev/sdb with physical extent size = 128KiB
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sdb
    pesize: 128K

# If, for example, we already have VG vg.services on top of /dev/sdb1,
# this VG will be extended by /dev/sdc5.  Or if vg.services was created on
# top of /dev/sda5, we first extend it with /dev/sdb1 and /dev/sdc5,
# and then reduce by /dev/sda5.
- name: Create or resize a volume group on top of /dev/sdb1 and /dev/sdc5.
  community.general.lvg:
    vg: vg.services
    pvs:
      - /dev/sdb1
      - /dev/sdc5

- name: Remove a volume group with name vg.services
  community.general.lvg:
    vg: vg.services
    state: absent

- name: Create a volume group on top of /dev/sda3 and resize the volume group /dev/sda3 to the maximum possible
  community.general.lvg:
    vg: resizableVG
    pvs: /dev/sda3
    pvresize: true

- name: Deactivate a volume group
  community.general.lvg:
    state: inactive
    vg: vg.services

- name: Activate a volume group
  community.general.lvg:
    state: active
    vg: vg.services

- name: Add new PVs to volume group without removing existing ones
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sdb1,/dev/sdc1
    remove_extra_pvs: false
    state: present

- name: Reset a volume group UUID
  community.general.lvg:
    state: inactive
    vg: vg.services
    reset_vg_uuid: true

- name: Reset both volume group and pv UUID
  community.general.lvg:
    state: inactive
    vg: vg.services
    pvs:
      - /dev/sdb1
      - /dev/sdc5
    reset_vg_uuid: true
    reset_pv_uuid: true

Авторы

Alexander Bulimov (@abulimov)

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

© 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/lvg_module.html