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 словарь | Общая информация об устройстве. | ||
| partitions список | Список разделов устройства. | ||
| sample | | ||
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимости.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/parted_module.html