community.general.lvg 模块 – 配置 LVM 卷组

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.lvg。

概要

  • 此模块创建、删除或调整卷组的大小。

参数

参数

注释

force

boolean

如果 true，允许删除带有逻辑卷的卷组。

选择

  • false ← (默认)

  • true

pesize

string

物理扩展的大小。 pesize 必须是至少 1 个扇区（其中扇区大小是 VG 中当前使用的 PV 的最大扇区大小）的 2 的幂，或至少 128KiB。

pesize 可以选择以 UNIT（k/K/m/M/g/G）为后缀，默认单位为兆字节。

默认值： "4"

pv_options

string

创建卷组时要传递给 pvcreate 的其他选项。

默认值： ""

pvresize

boolean

在 community.general 0.2.0 中添加

如果 true，则将物理卷调整为最大可用大小。

选择

  • false ← (默认)

  • true

pvs

列表 / 元素=字符串

要在此卷组中用作物理设备的逗号分隔的设备列表。

在创建或调整卷组大小时是必需的。

如果需要，该模块将负责运行 pvcreate。

reset_pv_uuid

boolean

在 community.general 7.1.0 中添加

是否重新生成卷组的物理卷的 UUID。

这是非幂等的。指定此参数始终会导致更改。

选择

  • false ← (默认)

  • true

reset_vg_uuid

boolean

在 community.general 7.1.0 中添加

是否重新生成卷组的 UUID。

这是非幂等的。指定此参数始终会导致更改。

选择

  • false ← (默认)

  • true

state

string

控制卷组是否存在及其状态。

状态 active 和 inactive 暗示 present 状态。在 7.1.0 中添加

如果 active 或 inactive，则该模块管理 VG 的逻辑卷的当前状态。该模块还处理 VG 的自动激活状态（如果支持），除非在创建卷组且在 vg_options 中指定的自动激活选项的情况下。

选择

  • "absent"

  • "present" ← (默认)

  • "active"

  • "inactive"

vg

string / 必需

卷组的名称。

vg_options

string

创建卷组时要传递给 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: 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)