theforeman.foreman Release Notes¶
This changelog describes changes after version 0.8.1.
v2.1.2¶
Bugfixes¶
activation_key - submit organization_id when querying subs, required for Katello 4.1
content_view_version_cleanup - sort content view versions before deleting (https://github.com/RedHatSatellite/satellite-ansible-collection/issues/30, https://bugzilla.redhat.com/show_bug.cgi?id=1980274)
content_view_version_cleanup role - properly clean up when users set keep=0 (https://bugzilla.redhat.com/show_bug.cgi?id=1974314)
host, compute_profile - when resolving cluster and other values in vm_attrs, compare them as strings (https://github.com/theforeman/foreman-ansible-modules/issues/1245)
subscription_info - mark
organization
parameter as required, to match Katello
v2.1.1¶
Bugfixes¶
external_usergroup - always lookup the ID of the usergroup, instead of passing the name to the API (https://bugzilla.redhat.com/show_bug.cgi?id=1967649)
host, hostgroup - don’t override already set parameters when passing an activation key only (and vice versa) (https://bugzilla.redhat.com/show_bug.cgi?id=1967904)
v2.1.0¶
Minor Changes¶
Add a domain_info module
Add a hostgroups role (https://github.com/theforeman/foreman-ansible-modules/issues/1116)
Add a role content_rhel to perform basic setup for registering and syncing RHEL content hosts
Add content credentials role
callback plugin - collect facts during the run, merge them correctly and upload them once at the end
compute_resource - add
cloud
param for the AzureRm provider, to select which Azure cloud to usecompute_resource - add
sub_id
parameter for handling the Azure Subscription ID instead of theuser
parameterhost - Add
Redfish
to list of possible BMC providers of an interfacehost, compute_profile - look up the correct id for storage pods and domains given as part of
volumes_attributes
(https://bugzilla.redhat.com/show_bug.cgi?id=1885234)hostgroup - add a
ansible_roles
parameter (https://github.com/theforeman/foreman-ansible-modules/issues/1123)new
content_views
role to manage content views (https://github.com/theforeman/foreman-ansible-modules/issues/1111)new
organizations
role to manage organizations (https://github.com/theforeman/foreman-ansible-modules/issues/1109)subnet - add
bmc_proxy
parameter to configure BMC proxies for subnets
Bugfixes¶
host - pass the right image id to the compute resource when creating a host (https://github.com/theforeman/foreman-ansible-modules/issues/1160, https://bugzilla.redhat.com/show_bug.cgi?id=1911670)
New Modules¶
theforeman.foreman.content_view_info - Fetch information about Content Views
theforeman.foreman.content_view_version_info - Fetch information about Content Views
theforeman.foreman.domain_info - Fetch information about Domains
theforeman.foreman.host_errata_info - Fetch information about Host Errata
theforeman.foreman.repository_set_info - Fetch information about Red Hat Repositories
theforeman.foreman.setting_info - Fetch information about Settings
theforeman.foreman.subnet_info - Fetch information about Subnets
theforeman.foreman.subscription_info - Fetch information about Subscriptions
v2.0.1¶
Bugfixes¶
host - don’t filter
false
values forinterfaces_attributes
(https://github.com/theforeman/foreman-ansible-modules/issues/1148)host_info, repository_info - correctly fetch all entities when neither
name
norsearch
is sethost_info, repository_info - enforce mutual exclusivity of
name
andsearch
v2.0.0¶
Minor Changes¶
Add a role activation_keys to manage activation keys
Add a role lifecycle_environments to manage lifecycle environments
Add a role repositories to manage products, repositories, and repository_sets
Add a role sync_plans to manage sync plans
activation_key - add support for selecting subscriptions by
upstream_pool_id
compute_resource - add
set_console_password
,keyboard_layout
andpublic_key
parameters (https://github.com/theforeman/foreman-ansible-modules/issues/1052)host - clarify that
owner
refers to a users login, not their full name (https://github.com/theforeman/foreman-ansible-modules/issues/1045)host - look up the correct network id for a network given as part of
interfaces_attributes
(https://github.com/theforeman/foreman-ansible-modules/issues/1104)host, hostgroup - add
activation_keys
parameter to ease configuring activation keys for deploments
Breaking Changes / Porting Guide¶
All role variables are now prefixed with
foreman_
to avoid clashes with similarly named variables from roles outside this collection.
Bugfixes¶
content_view_version - make the
version
parameter not fail when the version was entered without a minor part (https://github.com/theforeman/foreman-ansible-modules/issues/1087)host - allow moving hosts between Organizations and Locations (https://bugzilla.redhat.com/show_bug.cgi?id=1901716)
host - fix subnet/domain assignment when multiple interfaces are defined (https://github.com/theforeman/foreman-ansible-modules/issues/1095)
host, hostgroup - select kickstart_repository based on lifecycle_environment and content_view if those are set (https://github.com/theforeman/foreman-ansible-modules/issues/1090, https://bugzilla.redhat.com/1915872)
resource_info - correctly show the exact resource when passing
id
inparams
New Modules¶
theforeman.foreman.host_info - Fetch information about Hosts
theforeman.foreman.puppetclasses_import - Import Puppet Classes from a Proxy
theforeman.foreman.repository_info - Fetch information about Repositories
v1.5.0¶
Minor Changes¶
content_upload - use
to_native
to decode RPM headers if needed (RPM 4.15+ returns strings)content_view_version - provide examples how to obtain detailed information about content view versions (https://bugzilla.redhat.com/show_bug.cgi?id=1868145)
content_view_version_cleanup - new role for cleaning up unused content view versions (https://github.com/theforeman/foreman-ansible-modules/issues/497)
host - allow management of interfaces (https://github.com/theforeman/foreman-ansible-modules/issues/757)
inventory plugin - add support for the Report API present in Foreman 1.24 and later
inventory plugin - allow to compose the
inventory_hostname
(https://github.com/theforeman/foreman-ansible-modules/issues/1070)manifest - new role for easier handling of subscription manifest workflows
subnet - add new
externalipam_group
parameterupdate vendored
apypie
to 0.3.2
Bugfixes¶
content_upload - Fix upload of files bigger than 2MB in Pulp3-based setups (https://github.com/theforeman/foreman-ansible-modules/issues/1043)
job_invocation - properly submit
ssh
,recurrence
,scheduling
andconcurrency_control
to the serverrepository - don’t emit a false warning about
organization_id
not being supported by the server (https://github.com/theforeman/foreman-ansible-modules/issues/1055)repository_set, repository - clarify documentation which module should be used for Red Hat Repositories (https://github.com/theforeman/foreman-ansible-modules/issues/1059)
v1.4.0¶
Minor Changes¶
global_parameter - allow to set hidden flag (https://github.com/theforeman/foreman-ansible-modules/issues/1024)
job_template - stricter validation of
template_inputs
sub-optionsredhat_manifest - allow configuring content access mode (https://github.com/theforeman/foreman-ansible-modules/issues/820)
subnet - verify the server has the
remote_execution
plugin when specifyingremote_execution_proxies
the
apypie
library is vendored inside the collection, so users only have to installrequests
manually now.
Bugfixes¶
Don’t try to update an entity, if only parameters that aren’t supported by the server are detected as changed. (https://github.com/theforeman/foreman-ansible-modules/issues/975)
allow to pass an empty string when refering to entities, thus unsetting the value (https://github.com/theforeman/foreman-ansible-modules/issues/969)
compute_profile - don’t fail when trying to update compute attributes of a profile (https://github.com/theforeman/foreman-ansible-modules/issues/997)
host, hostgroup - support
None
as thepxe_loader
(https://github.com/theforeman/foreman-ansible-modules/issues/971)job_template - don’t fail when trying to update template_inputs
os_default_template - document possible template kind choices (https://bugzilla.redhat.com/show_bug.cgi?id=1889952)
smart_class_parameters - don’t fail when trying to update override_values
New Modules¶
theforeman.foreman.job_invocation - Invoke Remote Execution Jobs
theforeman.foreman.smart_proxy - Manage Smart Proxies
v1.3.0¶
Minor Changes¶
external_usergroup - rename the
auth_source_ldap
parameter toauth_source
(auth_source_ldap
is still supported via an alias)server URL and credentials can now also be specified using environment variables (https://github.com/theforeman/foreman-ansible-modules/issues/837)
subnet - add support for external IPAM (https://github.com/theforeman/foreman-ansible-modules/issues/966)
Bugfixes¶
content_view - remove CVs from lifecycle environments before deleting them (https://bugzilla.redhat.com/show_bug.cgi?id=1875314)
external_usergroup - support non-LDAP external groups (https://github.com/theforeman/foreman-ansible-modules/issues/956)
host - properly scope image lookups by the compute resource (https://bugzilla.redhat.com/show_bug.cgi?id=1878693)
inventory plugin - include empty parent groups in the inventory (https://github.com/theforeman/foreman-ansible-modules/issues/919)
New Modules¶
theforeman.foreman.status_info - Get status info
v1.2.0¶
Minor Changes¶
compute_resource - added
caching_enabled
option for VMware compute resourcesdomain, host, hostgroup, operatingsystem, subnet - manage parameters in a single API call (https://bugzilla.redhat.com/show_bug.cgi?id=1855008)
host - add
compute_attributes
parameter to module (https://bugzilla.redhat.com/show_bug.cgi?id=1871815)provisioning_template - update list of possible template kinds (https://bugzilla.redhat.com/show_bug.cgi?id=1871978)
repository - update supported parameters (https://github.com/theforeman/foreman-ansible-modules/issues/935)
Bugfixes¶
image - fix quoting of search values (https://github.com/theforeman/foreman-ansible-modules/issues/927)
v1.1.0¶
Minor Changes¶
activation_key - add
description
parameter (https://github.com/theforeman/foreman-ansible-modules/issues/915)callback plugin - add reporter to report logs sent to Foreman (https://github.com/theforeman/foreman-ansible-modules/issues/836)
document return values of modules (https://github.com/theforeman/foreman-ansible-modules/pull/901)
inventory plugin - allow to control batch size when pulling hosts from Foreman (https://github.com/theforeman/foreman-ansible-modules/pull/865)
subnet - Require mask/cidr only on ipv4 (https://github.com/theforeman/foreman-ansible-modules/issues/878)
Bugfixes¶
inventory plugin - fix want_params handling (https://github.com/theforeman/foreman-ansible-modules/issues/847)
New Modules¶
theforeman.foreman.http_proxy - Manage HTTP Proxies
v1.0.1¶
Release Summary¶
Documentation fixes to reflect the correct module names.
v1.0.0¶
Release Summary¶
This is the first stable release of the theforeman.foreman
collection.
Breaking Changes / Porting Guide¶
All modules were renamed to drop the
foreman_
andkatello_
prefixes. Additionally to the prefix removal, the following modules were further ranamed:katello_upload to content_upload
katello_sync to repository_sync
katello_manifest to subscription_manifest
foreman_search_facts to resource_info
foreman_ptable to partition_table
foreman_model to hardware_model
foreman_environment to puppet_environment
New Modules¶
theforeman.foreman.activation_key - Manage Activation Keys
theforeman.foreman.architecture - Manage Architectures
theforeman.foreman.auth_source_ldap - Manage LDAP Authentication Sources
theforeman.foreman.bookmark - Manage Bookmarks
theforeman.foreman.compute_attribute - Manage Compute Attributes
theforeman.foreman.compute_profile - Manage Compute Profiles
theforeman.foreman.compute_resource - Manage Compute Resources
theforeman.foreman.config_group - Manage (Puppet) Config Groups
theforeman.foreman.content_credential - Manage Content Credentials
theforeman.foreman.content_upload - Upload content to a repository
theforeman.foreman.content_view - Manage Content Views
theforeman.foreman.content_view_filter - Manage Content View Filters
theforeman.foreman.content_view_version - Manage Content View Versions
theforeman.foreman.domain - Manage Domains
theforeman.foreman.external_usergroup - Manage External User Groups
theforeman.foreman.global_parameter - Manage Global Parameters
theforeman.foreman.hardware_model - Manage Hardware Models
theforeman.foreman.host - Manage Hosts
theforeman.foreman.host_collection - Manage Host Collections
theforeman.foreman.host_power - Manage Power State of Hosts
theforeman.foreman.hostgroup - Manage Hostgroups
theforeman.foreman.image - Manage Images
theforeman.foreman.installation_medium - Manage Installation Media
theforeman.foreman.job_template - Manage Job Templates
theforeman.foreman.lifecycle_environment - Manage Lifecycle Environments
theforeman.foreman.location - Manage Locations
theforeman.foreman.operatingsystem - Manage Operating Systems
theforeman.foreman.organization - Manage Organizations
theforeman.foreman.os_default_template - Manage Default Template Associations To Operating Systems
theforeman.foreman.partition_table - Manage Partition Table Templates
theforeman.foreman.product - Manage Products
theforeman.foreman.provisioning_template - Manage Provisioning Templates
theforeman.foreman.puppet_environment - Manage Puppet Environments
theforeman.foreman.realm - Manage Realms
theforeman.foreman.redhat_manifest - Interact with a Red Hat Satellite Subscription Manifest
theforeman.foreman.repository - Manage Repositories
theforeman.foreman.repository_set - Enable/disable Repositories in Repository Sets
theforeman.foreman.repository_sync - Sync a Repository or Product
theforeman.foreman.resource_info - Gather information about resources
theforeman.foreman.role - Manage Roles
theforeman.foreman.scap_content - Manage SCAP content
theforeman.foreman.scap_tailoring_file - Manage SCAP Tailoring Files
theforeman.foreman.scc_account - Manage SUSE Customer Center Accounts
theforeman.foreman.scc_product - Subscribe SUSE Customer Center Account Products
theforeman.foreman.setting - Manage Settings
theforeman.foreman.smart_class_parameter - Manage Smart Class Parameters
theforeman.foreman.snapshot - Manage Snapshots
theforeman.foreman.subnet - Manage Subnets
theforeman.foreman.subscription_manifest - Manage Subscription Manifests
theforeman.foreman.sync_plan - Manage Sync Plans
theforeman.foreman.templates_import - Sync Templates from a repository
theforeman.foreman.user - Manage Users
theforeman.foreman.usergroup - Manage User Groups