theforeman.foreman.content_upload 模块 – 上传内容到仓库

注意

此模块是 theforeman.foreman 集合(版本 4.2.0)的一部分。

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

要安装它,请使用:ansible-galaxy collection install theforeman.foreman。您需要进一步的要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:theforeman.foreman.content_upload

theforeman.foreman 1.0.0 中的新增功能

概要

  • 允许将内容上传到仓库

别名:katello_upload

要求

执行此模块的主机需要以下要求。

  • python-debian(用于 deb 包上传)

  • requests

  • rpm(用于 rpm 上传)

参数

参数

注释

组织

字符串 / 必需

实体所在的组织

ostree_repository_name

字符串

OSTree 存档中的仓库名称。

OSTree 上传必需。

密码

字符串 / 必需

访问 Foreman 服务器的用户的密码。

如果任务中未指定该值,则将改用环境变量 FOREMAN_PASSWORD 的值。

产品

字符串 / 必需

仓库所在的产品

仓库

字符串 / 必需

要将文件上传到的仓库

server_url

字符串 / 必需

Foreman 服务器的 URL。

如果任务中未指定该值,则将改用环境变量 FOREMAN_SERVER_URL 的值。

src

别名:file

路径 / 必需

要上传的文件(在远程/目标机器上)

用户名

字符串 / 必需

访问 Foreman 服务器的用户名。

如果任务中未指定该值,则将改用环境变量 FOREMAN_USERNAME 的值。

validate_certs

布尔值

是否验证 Foreman 服务器的 TLS 证书。

如果任务中未指定该值,则将改用环境变量 FOREMAN_VALIDATE_CERTS 的值。

选项

  • false

  • true ← (默认)

属性

属性

支持

描述

check_mode

支持:完整

可以在 check_mode 下运行,并在不修改实体的情况下返回更改状态预测

diff_mode

支持:完整

当处于 diff 模式时,将返回有关已更改内容(或可能需要在 check_mode 中更改的内容)的详细信息

备注

注意

  • 目前仅支持上传到 deb、RPM、OSTree 和文件仓库

  • 对于文件仓库以外的任何内容,必须安装支持库。请参阅要求。

  • OSTree 内容上传不是幂等的 - 多次运行将尝试上传内容单元。

示例

- name: "Upload my.rpm"
  theforeman.foreman.content_upload:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    src: "my.rpm"
    repository: "Build RPMs"
    product: "My Product"
    organization: "Default Organization"

- name: "Upload ostree-archive.tar"
  theforeman.foreman.content_upload:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    src: "ostree_archive.tar"
    repository: "My OStree Repository"
    product: "My Product"
    organization: "Default Organization"
    ostree_repository_name: "small"

作者

  • Eric D Helms (@ehelms)