theforeman.foreman.content_export_version (4.0.0) — module

Manage content view version content exports

| "added in version" 3.6.0 of theforeman.foreman"

Authors: Jeremy Lenz (@jeremylenz)

Install collection

Install with ansible-galaxy collection install theforeman.foreman:==4.0.0


Add to requirements.yml

  collections:
    - name: theforeman.foreman
      version: 4.0.0

Description

Export a content view version to a directory.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "Export content view version (full)"
  theforeman.foreman.content_export_version:
    content_view: RHEL8
    content_view_version: '1.0'
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    organization: "Default Organization"
    destination_server: "airgapped.example.com"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "Export content view version (full) in chunks of 10 GB"
  theforeman.foreman.content_export_version:
    content_view: RHEL8
    content_view_version: '1.0'
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    organization: "Default Organization"
    destination_server: "airgapped.example.com"
    chunk_size_gb: 10
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "Export content view version (full) and fail if any repos are unexportable"
  theforeman.foreman.content_export_version:
    content_view: RHEL8
    content_view_version: '1.0'
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    organization: "Default Organization"
    destination_server: "airgapped.example.com"
    fail_on_missing_content: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "Export content view version (incremental) since the most recent export"
  theforeman.foreman.content_export_version:
      content_view: RHEL8
      content_view_version: '1.0'
      username: "admin"
      password: "changeme"
      server_url: "https://foreman.example.com"
      organization: "Default Organization"
      destination_server: "airgapped.example.com"
      incremental: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "Export content view version (incremental) since a specific export"
  theforeman.foreman.content_export_version:
      content_view: RHEL8
      content_view_version: '1.0'
      username: "admin"
      password: "changeme"
      server_url: "https://foreman.example.com"
      organization: "Default Organization"
      destination_server: "airgapped.example.com"
      incremental: true
      from_history_id: 12345

Inputs

    
format:
    choices:
    - syncable
    - importable
    description:
    - Export format.
    - Choose C(syncable) if the exported content needs to be in a yum format.
    required: false
    type: str
    version_added: 3.10.0
    version_added_collection: theforeman.foreman

password:
    description:
    - Password of the user accessing the Foreman server.
    - If the value is not specified in the task, the value of environment variable C(FOREMAN_PASSWORD)
      will be used instead.
    required: true
    type: str

username:
    description:
    - Username accessing the Foreman server.
    - If the value is not specified in the task, the value of environment variable C(FOREMAN_USERNAME)
      will be used instead.
    required: true
    type: str

server_url:
    description:
    - URL of the Foreman server.
    - If the value is not specified in the task, the value of environment variable C(FOREMAN_SERVER_URL)
      will be used instead.
    required: true
    type: str

incremental:
    description:
    - Export only the content that has changed since the last export.
    required: false
    type: bool

content_view:
    description:
    - Content view name.
    required: true
    type: str

organization:
    description:
    - Organization that the entity is in
    required: true
    type: str

chunk_size_gb:
    description:
    - Split the exported content into archives no greater than the specified size in gigabytes.
    required: false
    type: int

validate_certs:
    default: true
    description:
    - Whether or not to verify the TLS certificates of the Foreman server.
    - If the value is not specified in the task, the value of environment variable C(FOREMAN_VALIDATE_CERTS)
      will be used instead.
    type: bool

from_history_id:
    description:
    - Export history identifier used for incremental export. If not provided the most
      recent export history will be used.
    required: false
    type: int

destination_server:
    description:
    - Destination server name; optional parameter to differentiate between exports
    required: false
    type: str

content_view_version:
    description:
    - Content view version, e.g. "7.0"
    required: true
    type: str

fail_on_missing_content:
    description:
    - Fails if any of the repositories belonging to this version are unexportable.
    required: false
    type: bool