parted - Настройка разделов блочного устройства
Новое в версии 2.3.
Обзор
- Этот модуль позволяет настроить разделы блочного устройства с помощью инструмента командной строки
parted. Полное описание полей и опций см. в руководстве GNU parted.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Этот модуль требует версию parted 1.8.3 и выше.
- Если версия parted ниже 3.1, требуется версия Linux, в которой работает файловая система sysfs
/sys/.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| align |
| Установить выравнивание для вновь созданных разделов. |
| device обязательно | Блочное устройство (диск), на котором нужно выполнить операцию. | |
| flags | Список флагов, которые должны быть установлены для раздела. | |
| label |
| Создает новую метку диска. |
| name | Устанавливает имя для номера раздела (только GPT, Mac, MIPS и PC98). | |
| number | Номер раздела для работы или номер раздела, который будет создан. Необходимо при выполнении любых действий на диске, кроме получения информации. | |
| part_end | Значение по умолчанию: 100% | Точка окончания раздела как смещение от начала диска, то есть «расстояние» от начала диска. Расстояние можно указать со всеми единицами измерения, поддерживаемыми parted (кроме compat), и оно чувствительно к регистру. Например, 10GiB, 15%. |
| part_start | Значение по умолчанию: 0% | Точка начала раздела как смещение от начала диска, то есть «расстояние» от начала диска. Расстояние можно указать со всеми единицами измерения, поддерживаемыми parted (кроме compat), и оно чувствительно к регистру. Например, 10GiB, 15%. |
| part_type |
| Может быть 'primary', 'extended' или 'logical' и может быть указан только для таблиц разделов 'msdos' или 'dvh'. Для таблицы разделов 'gpt' необходимо указать имя. Ни part_type, ни имя не могут быть использованы с таблицей разделов 'sun'. |
| state |
| Если создать или удалить раздел. Если установлено значение info, модуль вернет только информацию об устройстве. |
| unit |
| Выбирает текущее значение по умолчанию для единиц измерения, которые будет использовать Parted для отображения расположений и объёмов на диске, и для интерпретации введённых пользователем, если они не имеют суффикса единиц измерения. При получении информации о диске рекомендуется всегда указывать единицы измерения. |
Примечания
Примечание
- При получении информации о новом диске и когда версия parted, установленная в системе, предшествует версии 3.1, модуль запрашивает ядро через
/sys/для получения информации о диске. В этом случае единицы измерения CHS и CYL не поддерживаются.
Примеры
# Create a new primary partition
- parted:
device: /dev/sdb
number: 1
state: present
# Remove partition number 1
- parted:
device: /dev/sdb
number: 1
state: absent
# Create a new primary partition with a size of 1GiB
- parted:
device: /dev/sdb
number: 1
state: present
part_end: 1GiB
# Create a new primary partition for LVM
- parted:
device: /dev/sdb
number: 2
flags: [ lvm ]
state: present
part_start: 1GiB
# Read device information (always use unit when probing)
- parted: device=/dev/sdb unit=MiB
register: sdb_info
# Remove all partitions from disk
- parted:
device: /dev/sdb
number: "{{ item.num }}"
state: absent
with_items:
- "{{ sdb_info.partitions }}"
Возвращаемые значения
Общие значения, возвращаемые модулями, описаны здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| partition_info сложное | success | Текущая информация о разделах | |
| device словарь | Общая информация об устройстве. | ||
| sample | | ||
| partitions список | Список разделов устройства. | ||
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Автор
- 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.5/modules/parted_module.html