parted - Настройка разделов блочных устройств
Новая версия 2.3.
- Обзор
- Требования (для хоста, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Этот модуль позволяет настроить разделы блочного устройства с помощью утилиты командной строки
parted. Для получения полного описания полей и параметров см. руководство GNU parted.
Требования (для хоста, на котором выполняется модуль)
- Этот модуль требует parted версии 1.8.3 и выше.
- Если версия parted ниже 3.1, требуется версия Linux, работающая с файловой системой sysfs
/sys/.
Параметры
| параметр | обязательно | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| align | нет | optimal |
| Установить выравнивание для вновь созданных разделов. |
| device | да | Блочное устройство (диск), на котором нужно выполнить операцию. | ||
| flags | нет | Список флагов, которые должны быть установлены для раздела. | ||
| label | нет | msdos |
| Создает новую метку диска. |
| name | нет | Устанавливает имя для номера раздела (только GPT, Mac, MIPS и PC98). | ||
| number | нет | Номер раздела для работы или номер раздела, который будет создан. Требуется при выполнении любых действий с диском, кроме получения информации. | ||
| part_end | нет | 100% | Точка окончания раздела в виде смещения от начала диска, т.е. «расстояние» от начала диска. Расстояние может быть указано со всеми единицами, поддерживаемыми parted (кроме compat), и регистрозависимо. Например: 10GiB, 15%. | |
| part_start | нет | 0% | Точка начала раздела в виде смещения от начала диска, т.е. «расстояние» от начала диска. Расстояние может быть указано со всеми единицами, поддерживаемыми parted (кроме compat), и регистрозависимо. Например: 10GiB, 15%. | |
| part_type | нет | primary |
| Один из 'primary', 'extended' или 'logical' и может быть указан только с таблицами разделов 'msdos' или 'dvh'. Для таблицы разделов 'gpt' необходимо указать имя. Ни part_type, ни имя не могут быть использованы с таблицей разделов 'sun'. |
| state | нет | info |
| Если создавать или удалять раздел. Если установлено значение info, модуль вернёт только информацию о устройстве. |
| unit | нет | KiB |
| Выбирает текущую единицу измерения, которую Parted будет использовать для отображения местоположений и объемов на диске и для интерпретации значений, указанных пользователем, если они не имеют суффикса единицы. При получении информации о диске всегда рекомендуется указать единицу измерения. |
Примеры
# 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 | Текущая информация о разделах | успех | сложный | |||||||||||||||||||||
| содержит: |
| |||||||||||||||||||||||
Примечания
Примечание
- При получении информации о новом диске и при использовании версии parted, установленной на системе, до версии 3.1, модуль запрашивает ядро через
/sys/для получения информации о диске. В этом случае единицы CHS и CYL не поддерживаются.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Для помощи в разработке модулей, если вы заинтересованы, прочитайте Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/parted_module.html
