Модуль community.general.pmem — настройка модулей постоянной памяти Intel Optane

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: community.general.pmem.

Добавлено в community.general 4.5.0

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

Краткое описание

Этот модуль позволяет настраивать модули постоянной памяти Intel Optane (PMem) с помощью инструментов командной строки ipmctl и ndctl.

Требования

Следующие требования необходимы на узле, который выполняет этот модуль.

Инструменты командной строки ipmctl и ndctl
xmltodict

Параметры

Параметр	Комментарии
appdirect integer	Процент общей ёмкости, используемый в режиме AppDirect (`0`–`100`). Создаёт ёмкость AppDirect с аппаратным чередованием между указанными модулями PMem, если это применимо для заданной цели. Сумма значений `appdirect`, `memorymode` и `reserved` должна составлять `100`.
appdirect_interleaved boolean	Создать ёмкость AppDirect с чередованием между другими модулями PMem. Варианты: `false` `true` ← (по умолчанию)
memorymode integer	Процент общей ёмкости, используемый в режиме памяти (`0`–`100`).
namespace list / elements=dictionary	Позволяет задать конфигурацию пространств имён PMem.
mode string / обязательный	Режим пространства имён. Подробное описание режима приведено на странице руководства ndctl-create-namespace. Варианты: `"raw"` `"sector"` `"fsdax"` `"devdax"`
size string	Размер пространства имён. Этот параметр поддерживает суффиксы `k`, `K` или `KB` для KiB, `m`, `M` или `MB` для MiB, `g`, `G` или `GB` для GiB и `t`, `T` или `TB` для TiB. Этот параметр обязателен, если настроено несколько пространств имён. Если параметр не задан, настраивается всё доступное пространство региона.
type string	Тип пространства имён. Подробное описание типа приведено на странице руководства ndctl-create-namespace. Варианты: `"pmem"` `"blk"`
namespace_append boolean	Разрешить добавление новых пространств имён в систему. По умолчанию установлено значение `false`, поэтому все существующие пространства имён, не перечисленные в `namespace`, удаляются. Варианты: `false` ← (по умолчанию) `true`
reserved integer	Процент ёмкости, резервируемой (`0`–`100`). `reserved` не отображается в физическом адресном пространстве системы и представляется как зарезервированная ёмкость в командах Show Device и Show Memory Resources. Если параметр не настроен, `reserved` задаётся автоматически.
socket list / elements=dictionary	Позволяет задать конфигурацию для каждого сокета, используя его идентификатор. Сумма значений `appdirect`, `memorymode` и `reserved` в пределах одного сокета должна составлять `100`.
appdirect integer / обязательный	Процент общей ёмкости сокета с указанным идентификатором, используемый в режиме AppDirect (`0`–`100`).
appdirect_interleaved boolean	Создать ёмкость AppDirect с чередованием между другими модулями PMem в пределах сокета с указанным идентификатором. Варианты: `false` `true` ← (по умолчанию)
id integer / обязательный	Идентификатор сокета модуля PMem.
memorymode integer / обязательный	Процент общей ёмкости сокета с указанным идентификатором, используемый в режиме памяти (`0`–`100`).
reserved integer	Процент ёмкости сокета с указанным идентификатором, резервируемой (`0`–`100`).

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевую систему.
diff_mode	Поддержка: нет	В режиме сравнения возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примеры

- name: Configure the Pmem as AppDirect 10, Memory Mode 70, and the Reserved 20 percent.
  community.general.pmem:
    appdirect: 10
    memorymode: 70

- name: Configure the Pmem as AppDirect 10, Memory Mode 80, and the Reserved 10 percent.
  community.general.pmem:
    appdirect: 10
    memorymode: 80
    reserved: 10

- name: Configure the Pmem as AppDirect with not interleaved 10, Memory Mode 70, and the Reserved 20 percent.
  community.general.pmem:
    appdirect: 10
    appdirect_interleaved: false
    memorymode: 70

- name: Configure the Pmem each socket.
  community.general.pmem:
    socket:
      - id: 0
        appdirect: 10
        appdirect_interleaved: false
        memorymode: 70
        reserved: 20
      - id: 1
        appdirect: 10
        memorymode: 80
        reserved: 10

- name: Configure the two namespaces.
  community.general.pmem:
    namespace:
      - size: 1GB
        type: pmem
        mode: raw
      - size: 320MB
        type: pmem
        mode: sector

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
reboot_required boolean	Указывает, что для завершения настройки PMem требуется перезагрузка системы. Возвращается: при успехе Пример: `true`
result list / elements=dictionary	Отображает значения ёмкости AppDirect, режима памяти и зарезервированного пространства в байтах. Если указан аргумент `socket`, отображает значения для каждого сокета в `socket`, содержащем идентификатор сокета. Если указан аргумент `namespace`, отображаются сведения о каждом пространстве имён. Возвращается: при успехе Пример: `[{"appdirect": 111669149696, "memorymode": 970662608896, "reserved": 3626500096, "socket": 0}, {"appdirect": 111669149696, "memorymode": 970662608896, "reserved": 3626500096, "socket": 1}]`
appdirect integer	Размер AppDirect в байтах. Возвращается: при успехе
memorymode integer	Размер в режиме памяти в байтах. Возвращается: при успехе
namespace list / elements=string	Список сведений о пространствах имён. Возвращается: при успехе
reserved integer	Зарезервированный размер в байтах. Возвращается: при успехе
socket integer	Идентификатор настраиваемого сокета. Возвращается: при успехе

Авторы

Masayoshi Mizuma (@mizumm)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/pmem_module.html