ansible.builtin.yum_repository 模块 – 添加或移除 YUM 仓库

注意

此模块是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，即使不指定 collections 关键字，也可以使用简短的模块名称 yum_repository。但是，我们建议您使用 完全限定的集合名称 (FQCN) ansible.builtin.yum_repository，以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合冲突。

概要

• 在基于 RPM 的 Linux 发行版中添加或移除 YUM 仓库。

• 如果您希望更新现有的仓库定义，请改用 community.general.ini_file。

参数

参数	注释
async 布尔值	如果设置为 true，则 Yum 将尽可能并行下载此仓库中的软件包和元数据。 在 ansible-core 2.11、2.12 和 2.13 中，默认值为 true。 此选项已在 RHEL 8 中移除。如果您使用的是上面列出的版本之一，可以将此选项设置为 null 以避免传递未知的配置选项。 此参数已弃用，因为它已从 ansible-core 支持的系统中移除，并将从 ansible-core 2.22 中移除。 选项 false true
attributes 别名：attr 字符串	生成的 filesystem 对象应具有的属性。 要获取支持的标志，请查看目标系统上 chattr 的手册页。 此字符串应包含与 lsattr 显示的顺序相同的属性。 默认情况下假定使用 = 运算符，否则需要在字符串中包含 + 或 - 运算符。
bandwidth 字符串	最大可用网络带宽，单位为字节/秒。与 throttle 选项一起使用。 如果 throttle 是百分比且带宽为 0，则带宽限制将被禁用。如果 throttle 表示为数据速率（字节/秒），则忽略此选项。默认为 0（无带宽限制）。
baseurl 列表 / 元素=字符串	指向 yum 仓库的“repodata”目录所在的目录的 URL。 它也可以是多个 URL 的列表。 如果 state 设置为 present，则需要此参数、metalink 或 mirrorlist 参数。
cost 字符串	访问此仓库的相对成本。用于将一个仓库的软件包的权重设置高于/低于任何其他仓库。
countme 布尔值 在 ansible-core 2.18 中添加	每周是否应向随机选择的 metalink/mirrorlist 查询添加特殊标志。这允许仓库所有者估计使用它的系统数量。 选项 false true
deltarpm_metadata_percentage 字符串	当 deltarpm 元数据与软件包的相对大小大于此值时，不会从仓库下载 deltarpm 元数据。请注意，您可以提供大于 100 的值，因此 200 表示元数据的大小需要是软件包大小的一半。使用 0 关闭此检查，并始终下载元数据。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。
deltarpm_percentage 字符串	当 delta 与软件包的相对大小大于此值时，不使用 delta。使用 0 关闭 delta rpm 处理。本地仓库（使用 file://baseurl）默认情况下关闭 delta rpm。
description 字符串	描述仓库的人类可读字符串。此选项对应于 repo 文件中的 name 属性。 仅当 state=present 时，此参数才必需。
enabled 布尔值	这告诉 yum 是否使用此仓库。 Yum 默认值为 true。 选项 false true
enablegroups 布尔值	确定 yum 是否允许为此仓库使用软件包组。 Yum 默认值为 true。 选项 false true
exclude 别名：excludepkgs 列表 / 元素=字符串	要从更新或安装中排除的软件包列表。这应该是一个空格分隔的列表。允许使用通配符（例如 * 和 ?）的 shell 通配符。 列表也可以是常规的 YAML 数组。 excludepkgs 别名在 ansible-core 2.18 中添加。
failovermethod 字符串	roundrobin 随机选择一个 URL 从 URL 列表开始，并在遇到联系主机失败时依次遍历每个 URL。 priority 从列出的第一个 baseurl 开始，并按顺序读取它们。 选项 "roundrobin" "priority"
file 字符串	保存仓库的文件名，不包括 .repo 扩展名。默认为 name 的值。
gpgcakey 字符串	指向仓库的 ASCII 编码 CA 密钥文件的 URL。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。
gpgcheck 布尔值	告诉 yum 是否应该对软件包执行 GPG 签名检查。 无默认设置。如果未设置该值，则将使用来自 /etc/yum.conf 的系统设置或 false 的系统默认值。 选项 false true
gpgkey 列表 / 元素=字符串	指向仓库的 ASCII 编码 GPG 密钥文件的 URL。 它也可以是多个 URL 的列表。
group 字符串	应拥有文件系统对象的组的名称，就像传递给 chown 一样。 如果未指定，则它使用当前用户的当前组，除非您是 root 用户，在这种情况下，它可以保留之前的拥有权。
http_caching 字符串	确定如何指示上游 HTTP 缓存处理 Yum 执行的任何 HTTP 下载。 all 表示应缓存所有 HTTP 下载。 packages 表示仅应缓存 RPM 软件包下载（但不缓存仓库元数据下载）。 none 表示不应缓存任何 HTTP 下载。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。 选项 "all" "packages" "none"
include 字符串	包含外部配置文件。支持本地路径和URL。配置文件将插入到include=行的位置。包含的文件可能包含更多include行。如果检测到包含循环，Yum将中止并报错。
includepkgs 列表 / 元素=字符串	您只想从存储库中使用的软件包列表。这应该是一个空格分隔的列表。允许使用通配符（例如*和?）的shell通配符。此处将遵守替换变量（例如$releasever）。 列表也可以是常规的 YAML 数组。
ip_resolve 字符串	确定yum如何解析主机名。 4或IPv4 - 只解析为IPv4地址。 6或IPv6 - 只解析为IPv6地址。 选项 "4" "6" "IPv4" "IPv6" "whatever"
keepalive 布尔值	这告诉yum是否应在此存储库中使用HTTP/1.1 keepalive。通过在从存储库下载多个文件时使用一个连接，可以提高传输速度。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。 选项 false true
keepcache 字符串	1或0。确定yum是否在成功安装后保留报头和软件包的缓存。 此参数已弃用，因为它仅在主配置中有效，并将从ansible-core 2.20中删除。 选项 "0" "1"
metadata_expire 字符串	元数据过期的时间（以秒为单位）。 默认值为6小时。
metadata_expire_filter 字符串	过滤metadata_expire时间，如果命令不需要，则允许以速度换取准确性。每个yum命令都可以指定它需要来自远程存储库的特定时间性质量级别。从“我即将安装/升级，所以这最好是最新的”到“任何可用的都足够好”。 never - 不过滤任何内容，始终遵守metadata_expire。 read-only:past - 只关心过去信息的命令将从元数据过期中过滤掉。例如，yum history信息（如果历史记录需要查找有关先前事务的任何信息，则根据定义，远程软件包过去是可用的）。 read-only:present - 在过去和未来之间取得平衡的命令。例如，yum list yum。 read-only:future - 可能会导致运行其他命令的命令，这些命令将需要最新的元数据。例如，yum check-update。 请注意，此选项不会覆盖yum clean expire-cache。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。 选项 "never" "read-only:past" "read-only:present" "read-only:future"
metalink 字符串	指定repomd.xml的metalink文件的URL，通过将repomd.xml文件的镜像转换为baseurl，生成整个存储库的镜像列表。 如果state设置为present，则需要此参数、baseurl或mirrorlist参数。
mirrorlist 字符串	指定包含baseurl列表的URL。 如果state设置为present，则需要此参数、baseurl或metalink参数。
mirrorlist_expire 字符串	本地缓存的镜像列表过期的时间（以秒为单位）。 默认值为6小时。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。
mode any	生成的filesystem对象应具有的权限。 对于习惯使用/usr/bin/chmod的用户，请记住模式实际上是八进制数。您必须向Ansible提供足够的信息才能正确解析它们。为了获得一致的结果，请引用八进制数（例如'644'或'1777'），以便Ansible接收一个字符串，并可以自行将字符串转换为数字。添加前导零（例如0755）有时有效，但在循环和其他情况下可能会失败。 如果不遵循这些规则中的任何一条，则向Ansible提供数字将得到一个十进制数，这将产生意外的结果。 从Ansible 1.8开始，模式可以指定为符号模式（例如u+rwx或u=rw,g=r,o=r）。 如果未指定mode并且目标filesystem对象**不存在**，则在设置新创建的filesystem对象的模式时，将使用系统上的默认umask。 如果未指定mode并且目标filesystem对象**存在**，则将使用现有filesystem对象的模式。 指定mode是确保以正确的权限创建filesystem对象的最佳方法。有关更多详细信息，请参阅CVE-2020-1736。
module_hotfixes 布尔值 在ansible-core 2.11中添加	禁用模块RPM过滤并使存储库中的所有RPM都可用。默认为null。 选项 false true
name 字符串 / 必需	唯一的存储库ID。此选项构建repo文件中存储库的节名称。 如果state设置为present或absent，则此参数是必需的。
owner 字符串	应该拥有filesystem对象的用户的名称，如同提供给chown一样。 如果未指定，则使用当前用户，除非您是root用户，在这种情况下，它可以保留之前的拥有权。 指定数字用户名将被认为是用户ID而不是用户名。避免使用数字用户名以避免此混淆。
password 字符串	与用户名一起用于基本身份验证的密码。
priority 字符串	强制执行存储库的有序保护。该值是一个1到99之间的整数。 此选项仅在安装了YUM Priorities插件后才有效。
protect 布尔值	保护软件包免受其他存储库的更新。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。 选项 false true
proxy 字符串	yum应使用的代理服务器的URL。设置为_none_以禁用全局代理设置。
proxy_password 字符串	此代理的密码。
proxy_username 字符串	用于代理的用户名。
repo_gpgcheck 布尔值	这告诉yum是否应该对来自此存储库的repodata执行GPG签名检查。 选项 false true
reposdir path	存储.repo文件的目录。 默认值： "/etc/yum.repos.d"
retries 字符串	设置在返回错误之前应重试检索文件的任何尝试的次数。将其设置为0使yum无限尝试。
s3_enabled 布尔值	启用对S3存储库的支持。 此选项仅在安装了YUM S3插件后才有效。 选项 false true
selevel 字符串	SELinux filesystem对象上下文的级别部分。 这是MLS/MCS属性，有时称为range。 设置为_default时，如果可用，它将使用策略的level部分。
serole 字符串	SELinux 文件系统对象上下文中的角色部分。 设置为_default时，如果可用，它将使用策略的role部分。
setype 字符串	SELinux 文件系统对象上下文中的类型部分。 设置为_default时，如果可用，它将使用策略的type部分。
seuser 字符串	SELinux 文件系统对象上下文中的用户部分。 默认情况下，它在适用时使用system策略。 设置为_default时，如果可用，它将使用策略的user部分。
skip_if_unavailable 布尔值	如果设置为true，如果由于任何原因无法联系此存储库，yum 将继续运行。应谨慎设置此选项，因为所有存储库都会被任何给定命令查询。 选项 false true
ssl_check_cert_permissions 布尔值	yum 是否应检查存储库（远程和本地）上证书路径的权限。 如果我们无法读取任何文件，则 yum 将强制skip_if_unavailable为true。这对于在具有仅 root 可读的客户端证书文件的存储库上使用 yum 的非 root 进程最为有用。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。 选项 false true
sslcacert 别名：ca_cert 字符串	包含 yum 应用于验证 SSL 证书的证书颁发机构数据库的目录的路径。
sslclientcert 别名：client_cert 字符串	yum 应用于连接到存储库/远程站点的 SSL 客户端证书的路径。
sslclientkey 别名：client_key 字符串	yum 应用于连接到存储库/远程站点的 SSL 客户端密钥的路径。
sslverify 别名：validate_certs 布尔值	定义 yum 是否应完全验证 SSL 证书/主机。 选项 false true
state 字符串	存储库文件的状。 选项 "absent" "present" ← (默认)
throttle 字符串	启用下载带宽限制。 此选项可以表示为以字节/秒为单位的绝对数据速率。可以将 SI 前缀 (k、M 或 G) 附加到带宽值。
timeout 字符串	等待连接超时之前的秒数。
ui_repoid_vars 字符串	显示存储库 ID 时，如果这些 yum 变量用于baseurl等，则将这些变量附加到字符串中。变量按列出的顺序（以及找到的顺序）附加。 此参数已弃用，因为它对作为底层包管理器的 dnf 没有影响，并将从 ansible-core 2.22 中移除。
unsafe_writes 布尔值	影响何时使用原子操作来防止目标文件系统对象的数据损坏或不一致读取。 默认情况下，此模块使用原子操作来防止目标文件系统对象的数据损坏或不一致读取，但有时系统配置不当或损坏，无法实现这一点。一个例子是 docker 挂载的文件系统对象，无法从容器内部以原子方式更新，只能以不安全的方式写入。 此选项允许 Ansible 在原子操作失败时回退到不安全的文件系统对象更新方法（但是，它不会强制 Ansible 执行不安全的写入）。 重要！不安全的写入容易出现竞争条件，并可能导致数据损坏。 选项 false ← (默认) true
username 字符串	用于对存储库或任何 URL 进行基本身份验证的用户名。

属性

属性	支持	描述
check_mode	支持：完全支持	可以在 check_mode 下运行并返回更改状态预测，而无需修改目标，如果不支持，则操作将被跳过。
diff_mode	支持：完全支持	在 diff 模式下，将返回有关已更改内容（或在 check_mode 下可能需要更改的内容）的详细信息。
platform	平台： rhel	可以对其进行操作的目标操作系统/系列。

备注

注意

• 如果修改现有存储库文件，所有注释都将被删除。

• 现有存储库文件中的节顺序将保留。

• 现有存储库文件中节中的参数将按字母顺序排序。

• 如果存储库文件不包含任何存储库，则该文件将自动删除。

• 删除存储库时，请注意磁盘上的元数据缓存可能仍然存在，直到运行yum clean all为止。为此使用通知处理程序。

• 由于规避了 Ansible 的参数处理，因此在 Ansible 2.5 中删除了params参数。

示例

- name: Add repository
  ansible.builtin.yum_repository:
    name: epel
    description: EPEL YUM repo
    baseurl: https://download.fedoraproject.org/pub/epel/$releasever/$basearch/

- name: Add multiple repositories into the same file (1/2)
  ansible.builtin.yum_repository:
    name: epel
    description: EPEL YUM repo
    file: external_repos
    baseurl: https://download.fedoraproject.org/pub/epel/$releasever/$basearch/
    gpgcheck: no

- name: Add multiple repositories into the same file (2/2)
  ansible.builtin.yum_repository:
    name: rpmforge
    description: RPMforge YUM repo
    file: external_repos
    baseurl: http://apt.sw.be/redhat/el7/en/$basearch/rpmforge
    mirrorlist: http://mirrorlist.repoforge.org/el7/mirrors-rpmforge
    enabled: no

# Handler showing how to clean yum metadata cache
- name: yum-clean-metadata
  ansible.builtin.command: yum clean metadata

# Example removing a repository and cleaning up metadata cache
- name: Remove repository (and clean up left-over metadata)
  ansible.builtin.yum_repository:
    name: epel
    state: absent
  notify: yum-clean-metadata

- name: Remove repository from a specific repo file
  ansible.builtin.yum_repository:
    name: epel
    file: external_repos
    state: absent

返回值

常见返回值已在此处记录，以下是此模块特有的字段

键	描述
repo 字符串	存储库名称 返回：成功 示例："epel"
state 字符串	执行后目标的状态 返回：成功 示例："present"

作者

• Jiri Tyr (@jtyr)

集合链接

• 问题跟踪器
• 存储库（源代码）
• 通信