community.general.modprobe 模块 – 加载或卸载内核模块

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您正在使用 ansible 包，则您可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.modprobe。

概要

  • 加载或卸载内核模块。

参数

参数

注释

name

字符串 / 必需

要管理的内核模块的名称。

params

字符串

模块参数。

默认值： ""

persistent

字符串

在 community.general 7.0.0 中添加

配置模块的重启之间的持久性。

此选项在 /etc/modules-load.d/ 和 /etc/modprobe.d/ 中创建文件，使您的模块配置在重启期间保持持久性。

如果为 present，则将模块名称添加到 /etc/modules-load.d/，并将参数添加到 /etc/modprobe.d/，以便在下次重启时加载模块。

如果为 absent，则会将模块名称从 /etc/modules-load.d/ 中注释掉，并将参数从 /etc/modprobe.d/ 中注释掉，以便在下次重启时不会加载模块。

如果为 disabled，则不会触碰任何内容，并保持 /etc/modules-load.d/ 和 /etc/modprobe.d/ 原样。

请注意，通常最好依靠内核模块本身中编码的 PCI ID、USB ID、DMI ID 或类似触发器进行自动模块加载，而不是像这样的配置。

事实上，大多数现代内核模块已经准备好自动加载了。

注意：当设置为 disabled 以外的值时，此选项仅适用于使用 systemd 的发行版。

选项

  • "disabled" ← (默认)

  • "absent"

  • "present"

state

字符串

模块是否应该存在或不存在。

选项

  • "absent"

  • "present" ← (默认)

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 中运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持：不支持

在差异模式下，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

示例

- name: Add the 802.1q module
  community.general.modprobe:
    name: 8021q
    state: present

- name: Add the dummy module
  community.general.modprobe:
    name: dummy
    state: present
    params: 'numdummies=2'

- name: Add the dummy module and make sure it is loaded after reboots
  community.general.modprobe:
    name: dummy
    state: present
    params: 'numdummies=2'
    persistent: present

作者

  • David Stygstra (@stygstra)

  • Julien Dauphant (@jdauphant)

  • Matt Jeffery (@mattjeffery)