community.general.pam_limits 模块 – 修改 Linux PAM 限制

注意

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

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

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

要在剧本中使用它，请指定： community.general.pam_limits。

概要

  • community.general.pam_limits 模块修改 PAM 限制。

  • 默认文件是 /etc/security/limits.conf。

  • 有关完整文档，请参见 man 5 limits.conf。

参数

参数

注释

backup

布尔值

创建一个包含时间戳信息的备份文件，以便您可以找回原始文件，以防您意外地错误地修改了它。

选项

  • false ← (默认)

  • true

comment

字符串

与限制关联的注释。

默认： ""

dest

字符串

修改 limits.conf 路径。

默认： "/etc/security/limits.conf"

domain

字符串 / 必需

用户名、@组名、通配符、UID/GID 范围。

limit_item

字符串 / 必需

要设置的限制。

选项

  • "core"

  • "data"

  • "fsize"

  • "memlock"

  • "nofile"

  • "rss"

  • "stack"

  • "cpu"

  • "nproc"

  • "as"

  • "maxlogins"

  • "maxsyslogins"

  • "priority"

  • "locks"

  • "sigpending"

  • "msgqueue"

  • "nice"

  • "rtprio"

  • "chroot"

limit_type

字符串 / 必需

限制类型，请参见 man 5 limits.conf 获取说明。

选项

  • "hard"

  • "soft"

  • "-"

use_max

布尔值

如果设置为 true，则将使用或保留最大值。

如果指定的值高于文件中的值，则文件内容将被替换为新值，否则内容不会被修改。

选项

  • false ← (默认)

  • true

use_min

布尔值

如果设置为 true，则将使用或保留最小值。

如果指定的值低于文件中的值，则文件内容将被替换为新值，否则内容不会被修改。

选项

  • false ← (默认)

  • true

value

字符串 / 必需

限制的值。

值必须是 unlimited、infinity 或 -1，所有这些都表示无限制，或者限制为 0 或更大。

如果 limit_item 设置为 nice 或 priority，则值必须是 -20 到 19（含）之间的数字。

有关更多详细信息，请参阅 man 5 limits.conf 手册页。

属性

属性

支持

描述

check_mode

支持：完全支持

在 community.general 2.0.0 中添加

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

diff_mode

支持：完全支持

在 community.general 2.0.0 中添加

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

备注

注意

  • 如果 dest 文件不存在，则会创建它。

示例

- name: Add or modify nofile soft limit for the user joe
  community.general.pam_limits:
    domain: joe
    limit_type: soft
    limit_item: nofile
    value: 64000

- name: Add or modify fsize hard limit for the user smith. Keep or set the maximal value
  community.general.pam_limits:
    domain: smith
    limit_type: hard
    limit_item: fsize
    value: 1000000
    use_max: true

- name: Add or modify memlock, both soft and hard, limit for the user james with a comment
  community.general.pam_limits:
    domain: james
    limit_type: '-'
    limit_item: memlock
    value: unlimited
    comment: unlimited memory lock for james

- name: Add or modify hard nofile limits for wildcard domain
  community.general.pam_limits:
    domain: '*'
    limit_type: hard
    limit_item: nofile
    value: 39693561

作者

  • Sebastien Rohaut (@usawa)