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'
  3.0.0:
    changes:
      breaking_changes:
      - Set use_reports_api default value to true for the inventory plugin
      - Support for Ansible 2.8 is removed
      bugfixes:
      - host, hostgroup - fix updating puppetclasses while also updating description
        (or other string-like attributes) (https://github.com/theforeman/foreman-ansible-modules/issues/1231)
      minor_changes:
      - Add a role `convert2rhel` to perform setup for converting systems to RHEL
      - inventory plugin - enable certificate validation by default
      - repository - add ``arch`` parameter to limit architectures of the repository
        (https://github.com/theforeman/foreman-ansible-modules/issues/1265)
    fragments:
    - 1231-puppetclasses-and-description-update.yml
    - 1265-repository-arch.yml
    - 1291-foreman-ansible-inventory-default.yml
    - convert2rhel.yml
    - drop-ansible28.yml
    - validate-inventory-certs.yml
    release_date: '2021-11-11'
  3.1.0:
    changes:
      bugfixes:
      - callback plugin - include timezone information in the callback reported data
        (https://github.com/theforeman/foreman-ansible-modules/issues/1171)
      - hostgroup, location - don't fail when trying to delete a Hostgroup or Location
        where the parent is already absent
      - inventory plugin - fetch *all* facts, not only the first 250, when using the
        old Hosts API
      minor_changes:
      - Warn if the user tries to use a plain HTTP server URL and fail if the URL
        is neither HTTPS nor HTTP.
      - new ``compute_profiles`` role to manage compute profiles
      - new ``compute_resources`` role to manage compute resources
      - new ``content_view_publish`` role to publish a list of content views (https://github.com/theforeman/foreman-ansible-modules/issues/1209)
      - new ``domains`` role to manage domains
      - new ``operatingsystems`` role to manage operating systems
      - new ``provisioning_templates`` role to manage provisioning templates
      - new ``settings`` role to manage settings
      - new ``subnets`` role to manage subnets
      - repository - new ``download_concurrency`` parameter (https://github.com/theforeman/foreman-ansible-modules/issues/1273)
    fragments:
    - 1171-timezone.yml
    - 1209-content_views_role.yml
    - 1301-failsafe-parents.yml
    - 1303-foreman-repository-download-concurrency.yml
    - add-compute-profile-role.yml
    - add-compute-resource-role.yml
    - add-domains-role.yml
    - add-operatingsystems-role.yml
    - add-provisioning-templates-role.yml
    - add-settings-role.yml
    - add-subnets-role.yml
    - explicit-http-warning.yml
    - inventory-facts-batch-size.yml
    release_date: '2022-01-14'
  3.10.0:
    changes:
      bugfixes:
      - auth_sources_ldap role - don't assume ``account`` and ``account_password``
        are set, they are documented as optional
      - auth_sources_ldap role, compute_resources role, repositories role - do not
        log loop data when it contains sensitive data (https://bugzilla.redhat.com/show_bug.cgi?id=2183357)
      minor_changes:
      - content_export_library, content_export_repository, content_export_version
        - add ``format`` option to control the export format
      - content_view_filter - add support for creating modulemd filters
      - content_view_publish role - also accept a list of dicts as the ``content_views``
        role for publishing (https://github.com/theforeman/foreman-ansible-modules/issues/1436)
      - setting - document how to obtain valid setting names (https://bugzilla.redhat.com/show_bug.cgi?id=2174367)
    fragments:
    - 1436-cv-publish-vars.yml
    - 1573-cv-filter-modulemd.yml
    - auth_sources_ldap_role-dont_force_account.yml
    - bz2174367.yml
    - bz2183357-role-log.yml
    - content-export-format.yml
    release_date: '2023-04-04'
  3.11.0:
    changes:
      bugfixes:
      - compute_profile, host - properly support nested VMware clusters (https://bugzilla.redhat.com/show_bug.cgi?id=2211394)
      - content_credential - don't require ``content_type`` and ``content`` parameters
        when removing credentials (https://github.com/theforeman/foreman-ansible-modules/issues/1588)
      - content_credentials role - don't require ``content_type`` and ``content``
        parameters when removing credentials
      - content_view_filter - don't fail when creating a modulemd filter (https://github.com/theforeman/foreman-ansible-modules/issues/1608,
        https://bugzilla.redhat.com/show_bug.cgi?id=2208557)
      - repositories role - don't log repository information when creating products
        (https://bugzilla.redhat.com/show_bug.cgi?id=2183357)
      minor_changes:
      - content_view_promote role - also accept all parameters of the `content_view_version`
        module (https://github.com/theforeman/foreman-ansible-modules/issues/1591)
      - content_view_version - include information about the published version in
        the return value of the module
      - job-invocation - add ``recurrence purpose`` and ``description_format`` parameters
      - organizations role - accept ``parameters`` and ``ignore_types`` like the module
        does
    fragments:
    - 1588-content_credential-absent.yml
    - 1591-cv-promote-parameters.yml
    - 1608-cv-filter-modulemd.yml
    - bz2183357-do_not_log_repositories_for_products.yml
    - bz2211394-nested-vmware-clusters.yml
    - content_view_version-return_value.yml
    - job-invocation-parameters.yml
    - organizations_role-parameters_ignore_types.yml
    release_date: '2023-06-14'
  3.2.0:
    changes:
      bugfixes:
      - content_upload - clarify that ``src`` refers to a remote file (https://bugzilla.redhat.com/show_bug.cgi?id=2055416)
      minor_changes:
      - new ``auth_sources_ldap`` role to manage LDAP authentication sources
    fragments:
    - add-auth-source-ldaps-role.yml
    - bz2055416.yaml
    release_date: '2022-03-01'
  3.3.0:
    changes:
      minor_changes:
      - content_upload - add support for OSTree content uploads (https://github.com/theforeman/foreman-ansible-modules/issues/628,
        https://projects.theforeman.org/issues/33299)
      - os_default_template, provisioning_template - add ``host_init_config`` to list
        of possible template types
    fragments:
    - 1297-host_init_config.yml
    - 628-ostree.yml
    release_date: '2022-04-04'
  3.4.0:
    changes:
      bugfixes:
      - content_upload - properly detect SRPMs and ensure idempotency during uploads
        (https://github.com/theforeman/foreman-ansible-modules/issues/1274)
      - inventory plugin - fix caching for Report API (https://github.com/theforeman/foreman-ansible-modules/issues/1246)
      - operatingsystem - find operatingsystems by title or full (name,major,minor)
        tuple (https://github.com/theforeman/foreman-ansible-modules/issues/1401)
      - os_default_template, provisioning_template - don't document invalid template
        kind ``ptable`` (https://bugzilla.redhat.com/show_bug.cgi?id=1970132)
      minor_changes:
      - add support for module defaults groups for Ansible core 2.12 (https://github.com/theforeman/foreman-ansible-modules/issues/1015)
      - all modules - report smaller diffs by dropping ``null`` values. This should
        result in not showing fields that were unset to begin with, and mark fields
        that were explicitly removed as "deleted" instead of "replaced by ``null``"
      - compute_resource - update libvirt examples (https://bugzilla.redhat.com/show_bug.cgi?id=1990119)
      - content_view - add support to set label during creation.
      - repository - add ``rhel-9`` to os version filter choices
      - repository - add support for ``mirroring_policy`` for Katello 4.4+ (https://github.com/theforeman/foreman-ansible-modules/issues/1388)
    fragments:
    - 1015-action_groups.yml
    - 1246-inventory_reports_cache.yml
    - 1274-content_upload-srpm.yml
    - 1388-repository-mirroring_policy.yml
    - 1397-content_view-label.yml
    - 1401-os-search-title.yml
    - 1970132-no-ptable-kind.yml
    - 1990119-libvirt-examples.yml
    - repository-rhel9.yml
    - smaller-diffs.yml
    release_date: '2022-05-17'
  3.5.0:
    changes:
      minor_changes:
      - add execution environment metadata
      - installation_medium, operatingsystem, partition_table - add ``Fcos``, ``Rhcos``,
        ``VRP`` OS families
      - job_template - add ``hidden_value`` to ``template_inputs`` parameters
      - job_template - allow ``value_type`` to be ``resource``
      - operatingsystems role - make ``provisioning_template`` parameter optional
      - repositories role - add ``ansible_collection_requirements``
      - repositories role - add ``arch`` and ``os_versions`` parameters
      - repositories role - support ``mirroring_policy``
      - repository, smart_proxy - document deprecation/removal status of ``download_policy=background``
      - setting - the ``foreman_setting`` return entry is deprecated and kept for
        backwards compatibility, please use ``entity`` as with any other module
      - smart_proxy - add ``inherit`` to possible values of ``download_policy`` (https://github.com/theforeman/foreman-ansible-modules/issues/1438)
      - smart_proxy - add ``streamed`` download policy
      - snapshot - add include_ram option when creating VMWare snapshot
    fragments:
    - 1438-smart_proxy-download_policy-inherit.yml
    - setting-return-deprecate.yml
    modules:
    - description: List pulp3 content exports
      name: content_export_info
      namespace: ''
    - description: Manage content exports
      name: content_export_library
      namespace: ''
    - description: Manage Host Discovery Rules
      name: discovery_rule
      namespace: ''
    release_date: '2022-08-22'
  3.6.0:
    modules:
    - description: Manage repository content exports
      name: content_export_repository
      namespace: ''
    - description: Manage content view version content exports
      name: content_export_version
      namespace: ''
    release_date: '2022-09-01'
  3.7.0:
    changes:
      bugfixes:
      - Properly use FQCN notation when redirecting the old ``foreman_*`` and ``katello_*``
        module names. (https://github.com/theforeman/foreman-ansible-modules/issues/1484)
      - convert2rhel role - Content views for activation keys (https://bugzilla.redhat.com/2118790)
      minor_changes:
      - repository - add support for ``include_tags`` and ``exclude_tags`` parameters
        for Katello 4.4+
      - subscription_manifest - increase the import timeout to 10 minutes (https://github.com/theforeman/foreman-ansible-modules/issues/1474)
      - sync_plans role - document the ``enabled`` parameter (https://github.com/theforeman/foreman-ansible-modules/issues/1477)
      - sync_plans role - expose the ``state`` parameter of the underlying module,
        thus allowing to delete plans (https://github.com/theforeman/foreman-ansible-modules/issues/1477)
    fragments:
    - 1474-subscription_manifest-timeout.yaml
    - 1477-sync_plans-enhancements.yml
    - 1484-redirect-fqcn.yaml
    - bz2118790.yml
    - repository-include-exclude-tags.yaml
    release_date: '2022-10-05'
  3.8.0:
    changes:
      bugfixes:
      - activation_key - properly fetch *all* repositories when managing content overrides
        (https://bugzilla.redhat.com/show_bug.cgi?id=2134605)
      - redhat_manifest - properly report http errors (https://github.com/theforeman/foreman-ansible-modules/issues/1497)
      - repository_sync - report an error instead of syncing the whole product when
        the repository could not be found
      minor_changes:
      - job_template - add ``default`` option to the ``template_inputs`` parameter
      - location, organization - add ``ignore_types`` parameter to adjust automatic
        association of resources
      - redhat_manifest - Search by UUID on the server side if UUID is known. This
        is faster and allows fetching of manifest in big accounts (>1000 allocations).
      - redhat_manifest - return the UUID of the manifest so it can be reused later
      - redhat_manifest - set default ``quantity`` to 1 (https://github.com/theforeman/foreman-ansible-modules/pull/1499)
    fragments:
    - 1497-redhat_manifest-report-error.yml
    - 1509-taxonomy-ignore_types.yaml
    - 1519-job_template-input-default.yml
    - 2134605-ak-product_contents-per_page.yml
    - manifest-uuid-return.yml
    - redhat_manifest-default_quantity.yml
    - redhat_manifest-uuid-search.yml
    - repository_sync-no-failsaife-repository.yml
    modules:
    - description: Fetch information about Foreman Snapshots
      name: snapshot_info
      namespace: ''
    release_date: '2022-12-20'
  3.9.0:
    changes:
      bugfixes:
      - content_export_* - increase task timeout to 12h as export tasks can be time
        intensive (https://bugzilla.redhat.com/show_bug.cgi?id=2162678)
    fragments:
    - bz2162678-content_export-timeout.yaml
    modules:
    - description: Fetch information about a Content View Filter
      name: content_view_filter_info
      namespace: ''
    - description: Manage content view filter rules
      name: content_view_filter_rule
      namespace: ''
    - description: Fetch information about a Content View Filter Rule
      name: content_view_filter_rule_info
      namespace: ''
    - description: Get information about hostgroup(s)
      name: hostgroup_info
      namespace: ''
    release_date: '2023-02-20'