theforeman.foreman.content_import_version module – Manage content view version content imports
Note
This module is part of the theforeman.foreman collection (version 5.11.0).
You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.
To install it, use: ansible-galaxy collection install theforeman.foreman. You need further requirements to be able to use this module, see Requirements for details.
To use it in a playbook, specify: theforeman.foreman.content_import_version.
New in theforeman.foreman 4.1.0
Synopsis
- Import a content view version.
Requirements
The below requirements are needed on the host that executes this module.
- requests
Parameters
Parameter | Comments |
|---|---|
ca_path path | PEM formatted file that contains a CA certificate to be used for validation. If the value is not specified in the task, the value of environment variable |
metadata dictionary | Contents of the metadata.json file. This is not required if the metadata_file location is provided. |
metadata_file string | Location of the metadata.json file. Not required if the metadata has been already provided via the other parameter. |
oauth1_consumer_key string | OAuth1 consumer key for accessing the Foreman server. If the value is not specified in the task, the value of environment variable |
oauth1_consumer_secret string | OAuth1 consumer secret for accessing the Foreman server. If the value is not specified in the task, the value of environment variable |
organization string / required | Organization that the entity is in |
password string | Password of the user accessing the Foreman server. If the value is not specified in the task, the value of environment variable |
path string / required | Directory containing the exported repository, version or library. |
server_url string / required | URL of the Foreman server. If the value is not specified in the task, the value of environment variable |
use_gssapi boolean | Use GSSAPI to perform the authentication, typically this is for Kerberos or Kerberos through Negotiate authentication. Requires the Python library requests-gssapi to be installed. If the value is not specified in the task, the value of environment variable Choices:
|
username string | Username accessing the Foreman server. If the value is not specified in the task, the value of environment variable |
validate_certs boolean | 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 Choices:
|
Attributes
Attribute | Support | Description |
|---|---|---|
check_mode | Support: full | Can run in check_mode and return changed status prediction without modifying the entity |
diff_mode | Support: full | Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode |
Examples
- name: "Import content view version from metadata"
theforeman.foreman.content_import_version:
path: "/var/lib/pulp/imports/example-content"
metadata: "{{ lookup('file', '/tmp/metadata.json') | from_json }}"
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
- name: "Import content view version with specific metadata json"
theforeman.foreman.content_import_version:
path: "/var/lib/pulp/imports/example-content"
metadata_file: "/tmp/metadata.json"
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
Collection links
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/theforeman/foreman/content_import_version_module.html