community.general.pulp_repo 模块 – 添加或删除远程主机的 Pulp 仓库

注意

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

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

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

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

概要 

在远程主机上添加或删除 Pulp 仓库。
注意，这仅适用于 Pulp 2。

参数 

参数	注释
add_export_distributor 布尔值	是否将导出分发器添加到新的 `rpm` 仓库。选项 `false` ← (默认值) `true`
client_cert 路径	用于 SSL 客户端身份验证的 PEM 格式证书链文件。此文件也可以包含密钥，如果包含密钥，则不需要 `client_key`。
client_key 路径	包含用于 SSL 客户端身份验证的私钥的 PEM 格式文件。如果 `client_cert` 包含证书和密钥，则不需要此选项。
feed 字符串	接收更新的上游 feed URL。
feed_ca_cert 别名：importer_ssl_ca_cert 字符串	用于验证 feed 源 SSL 证书的 CA 证书字符串。这可以是文件内容或文件路径。
feed_client_cert 别名：importer_ssl_client_cert 字符串	在同步仓库时用作客户端证书的证书。这用于向 feed 源通信身份验证信息。此选项的值必须是证书的完整路径。指定的文件可以是证书本身，也可以是包含证书和私钥的单个文件。这可以是文件内容或文件路径。
feed_client_key 别名：importer_ssl_client_key 字符串	在 `feed_client_cert` 中指定的证书的私钥，假设它不包含在证书文件本身中。这可以是文件内容或文件路径。
force 布尔值	如果 `yes`，则不获取缓存副本。选项 `false` ← (默认值) `true`
force_basic_auth 布尔值	ansible.builtin.uri 模块使用的库 httplib2 仅在 Web 服务以 401 状态响应初始请求时才发送身份验证信息。由于某些基本身份验证服务未正确发送 401，因此登录将失败。此选项强制在初始请求时发送基本身份验证标头。选项 `false` ← (默认值) `true`
generate_sqlite 布尔值	布尔标志，指示在仓库发布期间是否应生成 sqlite 文件。选项 `false` ← (默认值) `true`
http_agent 字符串	用于标识的标头，通常出现在 Web 服务器日志中。默认值： `"ansible-httpget"`
name 别名：repo 字符串 / 必需	要添加或删除的仓库的名称。这与 Pulp 中的 repo-id 相关。
proxy_host 字符串	Pulp 仓库导入器的代理 URL 设置。格式为 scheme://host。
proxy_password 字符串	Pulp 仓库导入器的代理密码。
proxy_port 字符串	Pulp 仓库导入器的代理端口设置。
proxy_username 字符串	Pulp 仓库导入器的代理用户名。
publish_distributor 字符串	当 `state=publish` 时使用的分发器。默认情况下发布所有分发器。
pulp_host 字符串	要连接的 Pulp 服务器的 URL。默认值： `"https://127.0.0.1"`
relative_url 字符串	本地仓库的相对 URL。当 state=present 时需要。
repo_type 字符串	要使用的Repo插件类型（即，`rpm`，`docker`）。默认值： `"rpm"`
repoview 布尔值	是否为已发布的仓库生成repoview文件。将其设置为`true`会自动激活`generate_sqlite`。选项 `false` ← (默认值) `true`
serve_http 布尔值	使仓库通过HTTP可用。选项 `false` ← (默认值) `true`
serve_https 布尔值	使仓库通过HTTPS可用。选项 `false` `true` ← (默认)
state 字符串	仓库状态。状态为`sync`将排队同步仓库。这是异步的，但不像计划同步那样延迟。状态为`publish`将使用仓库的分发器发布内容。选项 `"present"` ← (默认) `"absent"` `"sync"` `"publish"`
url 字符串	HTTP、HTTPS或FTP URL，格式为(http\|https\|ftp)://[user[:pass]]@host.domain[:port]/path
url_password 字符串	用于对Pulp API进行HTTP基本身份验证的密码。如果未指定`url_username`参数，则不会使用`url_password`参数。
url_username 字符串	用于对Pulp API进行HTTP基本身份验证的用户名。
use_gssapi 布尔值在ansible-core 2.11中添加	使用GSSAPI进行身份验证，通常用于Kerberos或通过Negotiate身份验证的Kerberos。需要安装Python库gssapi。 GSSAPI的凭据可以使用`url_username`/`url_password`或使用指定自定义Kerberos凭据缓存的GSSAPI环境变量`KRB5CCNAME`来指定。即使已安装用于NTLM的GSSAPI机制，也不支持NTLM身份验证。选项 `false` ← (默认值) `true`
use_proxy 布尔值	如果为`no`，即使在目标主机上的环境变量中定义了代理，它也不会使用代理。选项 `false` `true` ← (默认)
validate_certs 布尔值	如果为`false`，则不会验证SSL证书。这仅应在使用自签名证书的个人控制站点上使用。选项 `false` `true` ← (默认)
wait_for_completion 布尔值	等待异步任务完成后再返回。选项 `false` ← (默认值) `true`

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在`check_mode`下运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：不支持	在差异模式下，将返回有关已更改内容（或可能需要在`check_mode`中更改的内容）的详细信息。

备注 

注意

此模块目前只能在rpm仓库上创建分发器和导入器。欢迎贡献以支持其他仓库类型。

示例 

- name: Create a new repo with name 'my_repo'
  community.general.pulp_repo:
    name: my_repo
    relative_url: my/repo
    state: present

- name: Create a repo with a feed and a relative URL
  community.general.pulp_repo:
    name: my_centos_updates
    repo_type: rpm
    feed: http://mirror.centos.org/centos/6/updates/x86_64/
    relative_url: centos/6/updates
    url_username: admin
    url_password: admin
    force_basic_auth: true
    state: present

- name: Remove a repo from the pulp server
  community.general.pulp_repo:
    name: my_old_repo
    repo_type: rpm
    state: absent

返回值 

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

键	描述
repo 字符串	执行操作的仓库名称。返回：成功示例： `"my_repo"`

作者

Joe Adams (@sysadmind)