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