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

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

Описание

Этот модуль позволяет настроить разделы блочного устройства с помощью инструмента командной строки 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`. Для таблицы разделов 'sun' нельзя использовать ни `part_type`, ни `name`.
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 сложный тип		success	Текущая информация о разделах Пример: {'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.9/modules/parted_module.html