Модуль community.general.pmem — Настройка модулей Intel Optane Persistent Memory

Примечание

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

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

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

Для использования в плейбуке укажите: community.general.pmem.

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

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

Описание

Этот модуль позволяет настроить модули Intel Optane Persistent Memory (PMem) с использованием командных инструментов ipmctl и ndctl.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

Командные инструменты ipmctl и ndctl
xmltodict

Параметры

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

Атрибуты

Атрибут	Поддержка	Описание
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 список / элементы=словарь	Показывает значение AppDirect, режима памяти и размера зарезервированного пространства в байтах. Если предоставлен аргумент `socket`, отображаются значения в каждом сокете с `socket`, содержащим идентификатор сокета. Если предоставлен аргумент `namespace`, отображаются подробности каждого пространства имен. Возвращено: успех Пример: `[{"appdirect": 111669149696, "memorymode": 970662608896, "reserved": 3626500096, "socket": 0}, {"appdirect": 111669149696, "memorymode": 970662608896, "reserved": 3626500096, "socket": 1}]`
appdirect целое число	Размер AppDirect в байтах. Возвращено: успех
memorymode целое число	Размер режима памяти в байтах. Возвращено: успех
namespace список / элементы=строка	Список подробностей о пространстве имен. Возвращено: успех
reserved целое число	Размер зарезервированного пространства в байтах. Возвращено: успех
socket целое число	Идентификатор сокета, подлежащий конфигурации. Возвращено: успех

Авторы

Масаёси Мизума (@mizumm)

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

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