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

注意

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

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

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

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

概要 

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

参数 

参数	注释
add_export_distributor 布尔值	是否将导出分发器添加到新的 `rpm` 仓库。选项 `false` ← (默认) `true`
client_cert 路径	用于 SSL 客户端身份验证的 PEM 格式的证书链文件。此文件也可以包含密钥，如果包含密钥，则不需要 `client_key`。
client_key 路径	包含您的私钥的 PEM 格式的文件，用于 SSL 客户端身份验证。如果 `client_cert` 同时包含证书和密钥，则不需要此选项。
feed 字符串	接收更新的上游源 URL。
feed_ca_cert 别名：importer_ssl_ca_cert 字符串	用于验证源 SSL 证书的 CA 证书字符串。这可以是文件内容或文件路径。
feed_client_cert 别名：importer_ssl_client_cert 字符串	在同步仓库时用作客户端证书的证书。这用于向源传递身份验证信息。此选项的值必须是证书的完整路径。指定的文件可以是证书本身，也可以是包含证书和私钥的单个文件。这可以是文件内容或文件路径。
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 字符串	要使用的仓库插件类型（即 `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。可以使用 `url_username`/`url_password` 或者使用 GSSAPI 环境变量 `KRB5CCNAME`（指定自定义的 Kerberos 凭据缓存）来指定 GSSAPI 的凭据。即使安装了 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)