parted – Настройка разделов блочных устройств

Новая в версии 2.3.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Этот модуль позволяет настроить разделы блочного устройства с помощью утилиты командной строки parted. Полное описание полей и опций см. в руководстве GNU parted.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

Этот модуль требует parted версии 1.8.3 и выше.
Если версия parted ниже 3.1, требуется система Linux, на которой работает файловая система sysfs /sys/.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
align строка	Варианты: cylinder minimal none optimal ←	Установить выравнивание для вновь созданных разделов.
device строка / обязательно		Блочное устройство (диск), над которым нужно произвести операцию.
flags список		Список флагов, которые необходимо установить для раздела.
label строка	Варианты: aix amiga bsd dvh gpt loop mac msdos ← pc98 sun	Создаёт новую метку диска.
name строка		Устанавливает имя для номера раздела (только GPT, Mac, MIPS и PC98).
number целое число		Номер раздела для работы или номер раздела, который будет создан. Требуется при выполнении любых действий с диском, кроме извлечения информации.
part_end строка	Значение по умолчанию: "100%"	Где раздел закончится как смещение от начала диска, то есть "расстояние" от начала диска. Расстояние можно задать всеми единицами, поддерживаемыми parted (кроме compat), и оно чувствительно к регистру, например, `10GiB`, `15%`.
part_start строка	Значение по умолчанию: "0%"	Где раздел начнётся как смещение от начала диска, то есть "расстояние" от начала диска. Расстояние можно задать всеми единицами, поддерживаемыми parted (кроме compat), и оно чувствительно к регистру, например, `10GiB`, `15%`.
part_type строка	Варианты: extended logical primary ←	Можно указать только с таблицами разделов 'msdos' или 'dvh'. Для таблицы разделов 'gpt' необходимо указать `name`. Ни `part_type`, ни `name` нельзя использовать с таблицей разделов 'sun'.
state строка	Варианты: absent present info ←	Создавать или удалять раздел. Если установлено `info`, модуль вернёт только информацию об устройстве.
unit строка	Варианты: s B KB KiB ← MB MiB GB GiB TB TiB % cyl chs compact	Выбирает текущую единицу измерения, которую будет использовать parted для отображения расположения и ёмкости на диске, и для интерпретации введённых пользователем значений, если они не имеют суффикса. При получении информации о диске рекомендуется указывать единицу измерения.

Примечания

Примечание

При получении информации о новом диске и при установленной версии parted на системе ниже версии 3.1, модуль запрашивает ядро через /sys/ для получения информации о диске. В этом случае единицы CHS и CYL не поддерживаются.

Примеры

- name: Create a new primary partition
  parted:
    device: /dev/sdb
    number: 1
    state: present

- name: Remove partition number 1
  parted:
    device: /dev/sdb
    number: 1
    state: absent

- name: Create a new primary partition with a size of 1GiB
  parted:
    device: /dev/sdb
    number: 1
    state: present
    part_end: 1GiB

- name: Create a new primary partition for LVM
  parted:
    device: /dev/sdb
    number: 2
    flags: [ lvm ]
    state: present
    part_start: 1GiB

# Example on how to read info and reuse it in subsequent task
- name: Read device information (always use unit when probing)
  parted: device=/dev/sdb unit=MiB
  register: sdb_info

- name: Remove all partitions from disk
  parted:
    device: /dev/sdb
    number: '{{ item.num }}'
    state: absent
  loop: '{{ sdb_info.partitions }}'

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ		Возвращаемое значение	Описание
partition_info сложное		успех	Текущая информация о разделах Пример: {'disk': {'dev': '/dev/sdb', 'logical_block': 512, 'model': 'VMware Virtual disk', 'physical_block': 512, 'size': 5.0, 'table': 'msdos', 'unit': 'gib'}, 'partitions': [{'begin': 0.0, 'end': 1.0, 'flags': ['boot', 'lvm'], 'fstype': '', 'name': '', 'num': 1, 'size': 1.0}, {'begin': 1.0, 'end': 5.0, 'flags': [], 'fstype': '', 'name': '', 'num': 2, 'size': 4.0}]}
	device словарь		Общая информация об устройстве.
	partitions список		Список разделов устройства.

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Fabrizio Colonna (@ColOfAbRiX)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/parted_module.html