theforeman.foreman.content_export_library 模块 – 管理库内容导出

注意

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

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

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

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

theforeman.foreman 3.5.0 中的新增功能

概要

  • 将库内容导出到目录。

要求

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

  • requests

参数

参数

注释

chunk_size_gb

整数

将导出的内容拆分为不大于指定大小(以千兆字节为单位)的存档。

仅适用于 format=importablesyncable 导出不能拆分。

destination_server

字符串

目标服务器名称;可选参数,用于区分导出

fail_on_missing_content

布尔值

如果属于此组织的任何存储库不可导出,则失败。

选择

  • false

  • true

format

字符串

在 theforeman.foreman 3.10.0 中添加

导出格式。

如果导出的内容需要为 yum 格式,请选择 syncable

选择

  • "syncable"

  • "importable"

from_history_id

整数

用于增量导出的导出历史标识符。如果未提供,将使用最新的导出历史记录。

incremental

布尔值

仅导出自上次导出以来已更改的内容。

选择

  • false

  • true

organization

字符串 / 必需

实体所在的组织

password

字符串 / 必需

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

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

server_url

字符串 / 必需

Foreman 服务器的 URL。

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

username

字符串 / 必需

访问 Foreman 服务器的用户名。

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

validate_certs

布尔值

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

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

选择

  • false

  • true ← (默认)

属性

属性

支持

描述

check_mode

支持: 完全

可以在 check_mode 下运行并返回更改状态预测,而无需修改实体

diff_mode

支持: 完全

在 diff 模式下,将返回已更改(或可能需要在 check_mode 下更改)的详细信息

示例

- name: "Export library content (full)"
  theforeman.foreman.content_export_library:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    organization: "Default Organization"
    destination_server: "airgapped.example.com"

- name: "Export library content (full) and fail if any repos are unexportable"
  theforeman.foreman.content_export_library:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    organization: "Default Organization"
    destination_server: "airgapped.example.com"
    fail_on_missing_content: true

- name: "Export library content (full) in chunks of 10 GB"
  theforeman.foreman.content_export_library:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    chunk_size_gb: 10
    organization: "Default Organization"
    destination_server: "airgapped.example.com"

- name: "Export library content (incremental) since the most recent export"
  theforeman.foreman.content_export_library:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    organization: "Default Organization"
    destination_server: "airgapped.example.com"
    incremental: true

- name: "Export library content (incremental) since a specific export"
  theforeman.foreman.content_export_library:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    organization: "Default Organization"
    destination_server: "airgapped.example.com"
    incremental: true
    from_history_id: 12345

作者

  • Jeremy Lenz (@jeremylenz)