ancestor: 0.8.1 releases: 1.0.0: changes: breaking_changes: - | All modules were renamed to drop the ``foreman_`` and ``katello_`` 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 release_summary: | This is the first stable release of the ``theforeman.foreman`` collection. modules: - description: Manage Activation Keys name: activation_key namespace: '' - description: Manage Architectures name: architecture namespace: '' - description: Manage LDAP Authentication Sources name: auth_source_ldap namespace: '' - description: Manage Bookmarks name: bookmark namespace: '' - description: Manage Compute Attributes name: compute_attribute namespace: '' - description: Manage Compute Profiles name: compute_profile namespace: '' - description: Manage Compute Resources name: compute_resource namespace: '' - description: Manage (Puppet) Config Groups name: config_group namespace: '' - description: Manage Content Credentials name: content_credential namespace: '' - description: Upload content to a repository name: content_upload namespace: '' - description: Manage Content Views name: content_view namespace: '' - description: Manage Content View Filters name: content_view_filter namespace: '' - description: Manage Content View Versions name: content_view_version namespace: '' - description: Manage Domains name: domain namespace: '' - description: Manage External User Groups name: external_usergroup namespace: '' - description: Manage Global Parameters name: global_parameter namespace: '' - description: Manage Hardware Models name: hardware_model namespace: '' - description: Manage Hosts name: host namespace: '' - description: Manage Host Collections name: host_collection namespace: '' - description: Manage Power State of Hosts name: host_power namespace: '' - description: Manage Hostgroups name: hostgroup namespace: '' - description: Manage Images name: image namespace: '' - description: Manage Installation Media name: installation_medium namespace: '' - description: Manage Job Templates name: job_template namespace: '' - description: Manage Lifecycle Environments name: lifecycle_environment namespace: '' - description: Manage Locations name: location namespace: '' - description: Manage Operating Systems name: operatingsystem namespace: '' - description: Manage Organizations name: organization namespace: '' - description: Manage Default Template Associations To Operating Systems name: os_default_template namespace: '' - description: Manage Partition Table Templates name: partition_table namespace: '' - description: Manage Products name: product namespace: '' - description: Manage Provisioning Templates name: provisioning_template namespace: '' - description: Manage Puppet Environments name: puppet_environment namespace: '' - description: Manage Realms name: realm namespace: '' - description: Interact with a Red Hat Satellite Subscription Manifest name: redhat_manifest namespace: '' - description: Manage Repositories name: repository namespace: '' - description: Enable/disable Repositories in Repository Sets name: repository_set namespace: '' - description: Sync a Repository or Product name: repository_sync namespace: '' - description: Gather information about resources name: resource_info namespace: '' - description: Manage Roles name: role namespace: '' - description: Manage SCAP content name: scap_content namespace: '' - description: Manage SCAP Tailoring Files name: scap_tailoring_file namespace: '' - description: Manage SUSE Customer Center Accounts name: scc_account namespace: '' - description: Subscribe SUSE Customer Center Account Products name: scc_product namespace: '' - description: Manage Settings name: setting namespace: '' - description: Manage Smart Class Parameters name: smart_class_parameter namespace: '' - description: Manage Snapshots name: snapshot namespace: '' - description: Manage Subnets name: subnet namespace: '' - description: Manage Subscription Manifests name: subscription_manifest namespace: '' - description: Manage Sync Plans name: sync_plan namespace: '' - description: Sync Templates from a repository name: templates_import namespace: '' - description: Manage Users name: user namespace: '' - description: Manage User Groups name: usergroup namespace: '' release_date: '2020-06-19' 1.0.1: changes: release_summary: | Documentation fixes to reflect the correct module names. release_date: '2020-06-29' 1.1.0: changes: bugfixes: - inventory plugin - fix want_params handling (https://github.com/theforeman/foreman-ansible-modules/issues/847) 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) fragments: - 836-add-reporter-to-callback.yaml - 847-want_params-fix.yaml - 865-limit-inventory-per-host.yaml - 878-cidr-only-v4.yaml - 901-document-return-values.yaml - 915-activation_key-description.yaml modules: - description: Manage HTTP Proxies name: http_proxy namespace: '' release_date: '2020-08-17' 1.2.0: changes: bugfixes: - image - fix quoting of search values (https://github.com/theforeman/foreman-ansible-modules/issues/927) minor_changes: - compute_resource - added ``caching_enabled`` option for VMware compute resources - domain, 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) fragments: - 927-image-quoting.yaml - 932-host-add-compute_attributes.yaml - 935-repository-params.yaml - 939-compute_resource-added_caching_enabled.yaml - bz1855008-single_call_parameters.yaml - bz1871978-template_kinds.yaml release_date: '2020-09-03' 1.3.0: changes: 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) minor_changes: - external_usergroup - rename the ``auth_source_ldap`` parameter to ``auth_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) fragments: - 837-env-fallback.yaml - 919-include-empty-parent-groups.yml - 956-external_usergroup-non-ldap.yaml - 966-subnet-external_ipam.yaml - bz1875314-content_view-remove.yaml - bz1878693-scope_image_lookups.yaml modules: - description: Get status info name: status_info namespace: '' release_date: '2020-09-22' 1.4.0: changes: 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 the ``pxe_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 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-options - redhat_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 specifying ``remote_execution_proxies`` - the ``apypie`` library is vendored inside the collection, so users only have to install ``requests`` manually now. fragments: - 820-redhat_manifest-sca.yaml - 969-allow-unset-entity.yml - 971-pxe_loader-none.yaml - 975-filter-update-payload.yml - 997-compute_profile-update.yaml - bz1889952-os_default_template-kind.yaml - global_parameter-hidden_values.yaml - job_template-template_inputs-validation.yaml - rex-proxy-subnet-check.yaml - venored_apypie.yaml modules: - description: Invoke Remote Execution Jobs name: job_invocation namespace: '' - description: Manage Smart Proxies name: smart_proxy namespace: '' release_date: '2020-10-21' 1.5.0: changes: 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`` and ``concurrency_control`` to the server - repository - 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) 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`` parameter - update vendored ``apypie`` to 0.3.2 fragments: - 1043-chunked_content_upload.yml - 1059-repository_set-docs.yml - 1062-warnings.yml - 1070-compose_inventory_hostname.yml - 757-host_interfaces.yml - bz1868145-cv_version_examples.yml - content_upload-decode-old-rpm.yml - inventory_plugin_report_api.yml - subnet-externalipam_group.yml - theforeman.foreman.content_view_version_cleanup_role.yml - theforeman.foreman.manifest_role.yml release_date: '2020-12-03' 2.0.0: changes: breaking_changes: - 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`` in ``params`` 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`` and ``public_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 fragments: - 1027-repositories_role.yml - 1045-host-owner.yml - 1052-compute_resource-params.yaml - 1065-sync-plans_role.yml - 1068-activation-keys_role.yml - 1087-content_view_version-safenet.yml - 1090-scope_kickstart_repository_tighter.yml - 1095-nested_list-lookup-fix.yml - 1096-lifecycle-environments-role.yml - 1104-network_id-lookup.yml - 1145-role_prefix.yml - 541-activation-key-upstream-pool.yml - bz1901716-dont_scope_requests.yml - host-hostgroup-ak-parameter.yml - resource_info-params-id.yml modules: - description: Fetch information about Hosts name: host_info namespace: '' - description: Import Puppet Classes from a Proxy name: puppetclasses_import namespace: '' - description: Fetch information about Repositories name: repository_info namespace: '' release_date: '2021-02-22' 2.0.1: changes: bugfixes: - host - don't filter ``false`` values for ``interfaces_attributes`` (https://github.com/theforeman/foreman-ansible-modules/issues/1148) - host_info, repository_info - correctly fetch all entities when neither ``name`` nor ``search`` is set - host_info, repository_info - enforce mutual exclusivity of ``name`` and ``search`` fragments: - 1148-dont-filter-false-params.yml - 20210224-info_module_fixes.yml release_date: '2021-03-02' 2.1.0: changes: 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) 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 use - compute_resource - add ``sub_id`` parameter for handling the Azure Subscription ID instead of the ``user`` parameter - host - Add ``Redfish`` to list of possible BMC providers of an interface - host, 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 fragments: - 1097-content-rhel-role.yml - 1109-organizations-role.yml - 1111-content_views_role.yml - 1116-hostgroups-role.yml - 1123-ansible-roles-for-hostgroups.yml - 1160-pass-image-in-compute-attributes.yml - 1196-content_credentials-role.yml - azure-clouds.yml - azure-subid.yml - bz1885234-storage-lookup.yml - domain-info-module.yml - foreman-fact-upload.yml - host-redfish-bmc.yml - subnet-bmc-proxy-param.yml modules: - description: Fetch information about Content Views name: content_view_info namespace: '' - description: Fetch information about Content Views name: content_view_version_info namespace: '' - description: Fetch information about Domains name: domain_info namespace: '' - description: Fetch information about Host Errata name: host_errata_info namespace: '' - description: Fetch information about Red Hat Repositories name: repository_set_info namespace: '' - description: Fetch information about Settings name: setting_info namespace: '' - description: Fetch information about Subnets name: subnet_info namespace: '' - description: Fetch information about Subscriptions name: subscription_info namespace: '' release_date: '2021-05-20' 2.1.1: changes: 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) fragments: - bz1967649-usergroup_lookup.yml - bz1967904-dont_override_params.yml release_date: '2021-06-22' 2.1.2: changes: 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 fragments: - 1245-search_vm_attr_as_string.yml - BZ1974314-cv_cleanup_keep_0.yml - bz1980274.yml - katello41-subscription-org-required.yml release_date: '2021-07-13' 2.2.0: changes: bugfixes: - host, hostgroup - don't accidentally duplicate ``kt_activation_keys`` param (https://github.com/theforeman/foreman-ansible-modules/issues/1268) minor_changes: - repository - add support for filtering repositories by OS version based on API feature apidoc/v2/repositories/create.html fragments: - 1268-ak_param_duplicate.yml - repository.yml release_date: '2021-08-24'