1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00

Reformat and re-order changelogs/changelog.yaml.

(cherry picked from commit e794fa74da)
This commit is contained in:
Felix Fontein 2024-07-11 22:46:36 +02:00
parent 59d01c3f17
commit 4e3469f0e5
2 changed files with 1383 additions and 1360 deletions

View file

@ -1,3 +1,4 @@
---
ancestor: 7.0.0 ancestor: 7.0.0
releases: releases:
8.0.0: 8.0.0:
@ -6,37 +7,37 @@ releases:
- collection_version lookup plugin - remove compatibility code for ansible-base - collection_version lookup plugin - remove compatibility code for ansible-base
2.10 and ansible-core 2.11 (https://github.com/ansible-collections/community.general/pull/7269). 2.10 and ansible-core 2.11 (https://github.com/ansible-collections/community.general/pull/7269).
- gitlab_project - add ``default_branch`` support for project update. If you - gitlab_project - add ``default_branch`` support for project update. If you
used the module so far with ``default_branch`` to update a project, the value used the module so far with ``default_branch`` to update a project, the
of ``default_branch`` was ignored. Make sure that you either do not pass a value of ``default_branch`` was ignored. Make sure that you either do not
value if you are not sure whether it is the one you want to have to avoid pass a value if you are not sure whether it is the one you want to have
unexpected breaking changes (https://github.com/ansible-collections/community.general/pull/7158). to avoid unexpected breaking changes (https://github.com/ansible-collections/community.general/pull/7158).
- selective callback plugin - remove compatibility code for Ansible 2.9 and - selective callback plugin - remove compatibility code for Ansible 2.9 and
ansible-core 2.10 (https://github.com/ansible-collections/community.general/pull/7269). ansible-core 2.10 (https://github.com/ansible-collections/community.general/pull/7269).
- vardict module utils - ``VarDict`` will no longer accept variables named ``_var``, - vardict module utils - ``VarDict`` will no longer accept variables named
``get_meta``, and ``as_dict`` (https://github.com/ansible-collections/community.general/pull/6647). ``_var``, ``get_meta``, and ``as_dict`` (https://github.com/ansible-collections/community.general/pull/6647).
- version module util - remove fallback for ansible-core 2.11. All modules and - version module util - remove fallback for ansible-core 2.11. All modules
plugins that do version collections no longer work with ansible-core 2.11 and plugins that do version collections no longer work with ansible-core
(https://github.com/ansible-collections/community.general/pull/7269). 2.11 (https://github.com/ansible-collections/community.general/pull/7269).
bugfixes: bugfixes:
- CmdRunner module utils - does not attempt to resolve path if executable is - CmdRunner module utils - does not attempt to resolve path if executable
a relative or absolute path (https://github.com/ansible-collections/community.general/pull/7200). is a relative or absolute path (https://github.com/ansible-collections/community.general/pull/7200).
- MH DependencyMixin module utils - deprecation notice was popping up for modules - MH DependencyMixin module utils - deprecation notice was popping up for
not using dependencies (https://github.com/ansible-collections/community.general/pull/6644, modules not using dependencies (https://github.com/ansible-collections/community.general/pull/6644,
https://github.com/ansible-collections/community.general/issues/6639). https://github.com/ansible-collections/community.general/issues/6639).
- bitwarden lookup plugin - the plugin made assumptions about the structure - bitwarden lookup plugin - the plugin made assumptions about the structure
of a Bitwarden JSON object which may have been broken by an update in the of a Bitwarden JSON object which may have been broken by an update in the
Bitwarden API. Remove assumptions, and allow queries for general fields such Bitwarden API. Remove assumptions, and allow queries for general fields
as ``notes`` (https://github.com/ansible-collections/community.general/pull/7061). such as ``notes`` (https://github.com/ansible-collections/community.general/pull/7061).
- cmd_runner module utils - when a parameter in ``argument_spec`` has no type, - cmd_runner module utils - when a parameter in ``argument_spec`` has no type,
meaning it is implicitly a ``str``, ``CmdRunner`` would fail trying to find meaning it is implicitly a ``str``, ``CmdRunner`` would fail trying to find
the ``type`` key in that dictionary (https://github.com/ansible-collections/community.general/pull/6968). the ``type`` key in that dictionary (https://github.com/ansible-collections/community.general/pull/6968).
- cobbler inventory plugin - fix calculation of cobbler_ipv4/6_address (https://github.com/ansible-collections/community.general/pull/6925). - cobbler inventory plugin - fix calculation of cobbler_ipv4/6_address (https://github.com/ansible-collections/community.general/pull/6925).
- composer - fix impossible to run ``working_dir`` dependent commands. The module - composer - fix impossible to run ``working_dir`` dependent commands. The
was throwing an error when trying to run a ``working_dir`` dependent command, module was throwing an error when trying to run a ``working_dir`` dependent
because it tried to get the command help without passing the ``working_dir`` command, because it tried to get the command help without passing the ``working_dir``
(https://github.com/ansible-collections/community.general/issues/3787). (https://github.com/ansible-collections/community.general/issues/3787).
- csv module utils - detects and remove unicode BOM markers from incoming CSV - csv module utils - detects and remove unicode BOM markers from incoming
content (https://github.com/ansible-collections/community.general/pull/6662). CSV content (https://github.com/ansible-collections/community.general/pull/6662).
- datadog_downtime - presence of ``rrule`` param lead to the Datadog API returning - datadog_downtime - presence of ``rrule`` param lead to the Datadog API returning
Bad Request due to a missing recurrence type (https://github.com/ansible-collections/community.general/pull/6811). Bad Request due to a missing recurrence type (https://github.com/ansible-collections/community.general/pull/6811).
- ejabberd_user - module was failing to detect whether user was already created - ejabberd_user - module was failing to detect whether user was already created
@ -44,8 +45,8 @@ releases:
- ejabberd_user - provide meaningful error message when the ``ejabberdctl`` - ejabberd_user - provide meaningful error message when the ``ejabberdctl``
command is not found (https://github.com/ansible-collections/community.general/pull/7028, command is not found (https://github.com/ansible-collections/community.general/pull/7028,
https://github.com/ansible-collections/community.general/issues/6949). https://github.com/ansible-collections/community.general/issues/6949).
- github_deploy_key - fix pagination behaviour causing a crash when only a single - github_deploy_key - fix pagination behaviour causing a crash when only a
page of deploy keys exist (https://github.com/ansible-collections/community.general/pull/7375). single page of deploy keys exist (https://github.com/ansible-collections/community.general/pull/7375).
- gitlab_group - the module passed parameters to the API call even when not - gitlab_group - the module passed parameters to the API call even when not
set. The module is now filtering out ``None`` values to remediate this (https://github.com/ansible-collections/community.general/pull/6712). set. The module is now filtering out ``None`` values to remediate this (https://github.com/ansible-collections/community.general/pull/6712).
- gitlab_group_variable - deleted all variables when used with ``purge=true`` - gitlab_group_variable - deleted all variables when used with ``purge=true``
@ -53,8 +54,8 @@ releases:
- gitlab_project_variable - deleted all variables when used with ``purge=true`` - gitlab_project_variable - deleted all variables when used with ``purge=true``
due to missing ``raw`` property in KNOWN attributes (https://github.com/ansible-collections/community.general/issues/7250). due to missing ``raw`` property in KNOWN attributes (https://github.com/ansible-collections/community.general/issues/7250).
- icinga2_host - fix a key error when updating an existing host (https://github.com/ansible-collections/community.general/pull/6748). - icinga2_host - fix a key error when updating an existing host (https://github.com/ansible-collections/community.general/pull/6748).
- ini_file - add the ``follow`` paramter to follow the symlinks instead of replacing - ini_file - add the ``follow`` paramter to follow the symlinks instead of
them (https://github.com/ansible-collections/community.general/pull/6546). replacing them (https://github.com/ansible-collections/community.general/pull/6546).
- ini_file - fix a bug where the inactive options were not used when possible - ini_file - fix a bug where the inactive options were not used when possible
(https://github.com/ansible-collections/community.general/pull/6575). (https://github.com/ansible-collections/community.general/pull/6575).
- ipa_dnszone - fix 'idnsallowsyncptr' key error for reverse zone (https://github.com/ansible-collections/community.general/pull/6906, - ipa_dnszone - fix 'idnsallowsyncptr' key error for reverse zone (https://github.com/ansible-collections/community.general/pull/6906,
@ -64,18 +65,18 @@ releases:
https://github.com/ansible-collections/community.general/issues/7362). https://github.com/ansible-collections/community.general/issues/7362).
- keycloak module util - fix missing ``http_agent``, ``timeout``, and ``validate_certs`` - keycloak module util - fix missing ``http_agent``, ``timeout``, and ``validate_certs``
``open_url()`` parameters (https://github.com/ansible-collections/community.general/pull/7067). ``open_url()`` parameters (https://github.com/ansible-collections/community.general/pull/7067).
- keycloak module utils - fix ``is_struct_included`` handling of lists of lists/dictionaries - keycloak module utils - fix ``is_struct_included`` handling of lists of
(https://github.com/ansible-collections/community.general/pull/6688). lists/dictionaries (https://github.com/ansible-collections/community.general/pull/6688).
- keycloak module utils - the function ``get_user_by_username`` now return the - keycloak module utils - the function ``get_user_by_username`` now return
user representation or ``None`` as stated in the documentation (https://github.com/ansible-collections/community.general/pull/6758). the user representation or ``None`` as stated in the documentation (https://github.com/ansible-collections/community.general/pull/6758).
- keycloak_authentication - fix Keycloak authentication flow (step or sub-flow) - keycloak_authentication - fix Keycloak authentication flow (step or sub-flow)
indexing during update, if not specified by the user (https://github.com/ansible-collections/community.general/pull/6734). indexing during update, if not specified by the user (https://github.com/ansible-collections/community.general/pull/6734).
- keycloak_client inventory plugin - fix missing client secret (https://github.com/ansible-collections/community.general/pull/6931). - keycloak_client inventory plugin - fix missing client secret (https://github.com/ansible-collections/community.general/pull/6931).
- ldap_search - fix string normalization and the ``base64_attributes`` option - ldap_search - fix string normalization and the ``base64_attributes`` option
on Python 3 (https://github.com/ansible-collections/community.general/issues/5704, on Python 3 (https://github.com/ansible-collections/community.general/issues/5704,
https://github.com/ansible-collections/community.general/pull/7264). https://github.com/ansible-collections/community.general/pull/7264).
- locale_gen - now works for locales without the underscore character such as - locale_gen - now works for locales without the underscore character such
``C.UTF-8`` (https://github.com/ansible-collections/community.general/pull/6774, as ``C.UTF-8`` (https://github.com/ansible-collections/community.general/pull/6774,
https://github.com/ansible-collections/community.general/issues/5142, https://github.com/ansible-collections/community.general/issues/4305). https://github.com/ansible-collections/community.general/issues/5142, https://github.com/ansible-collections/community.general/issues/4305).
- lvol - add support for percentage of origin size specification when creating - lvol - add support for percentage of origin size specification when creating
snapshot volumes (https://github.com/ansible-collections/community.general/issues/1630, snapshot volumes (https://github.com/ansible-collections/community.general/issues/1630,
@ -90,18 +91,18 @@ releases:
on header key/value parsing (https://github.com/ansible-collections/community.general/pull/7303). on header key/value parsing (https://github.com/ansible-collections/community.general/pull/7303).
- memset module utils - make compatible with ansible-core 2.17 (https://github.com/ansible-collections/community.general/pull/7379). - memset module utils - make compatible with ansible-core 2.17 (https://github.com/ansible-collections/community.general/pull/7379).
- nmap inventory plugin - fix ``get_option`` calls (https://github.com/ansible-collections/community.general/pull/7323). - nmap inventory plugin - fix ``get_option`` calls (https://github.com/ansible-collections/community.general/pull/7323).
- nmap inventory plugin - now uses ``get_option`` in all cases to get its configuration - nmap inventory plugin - now uses ``get_option`` in all cases to get its
information (https://github.com/ansible-collections/community.general/pull/7119). configuration information (https://github.com/ansible-collections/community.general/pull/7119).
- nmcli - fix bond option ``xmit_hash_policy`` (https://github.com/ansible-collections/community.general/pull/6527). - nmcli - fix bond option ``xmit_hash_policy`` (https://github.com/ansible-collections/community.general/pull/6527).
- nmcli - fix support for empty list (in compare and scrape) (https://github.com/ansible-collections/community.general/pull/6769). - nmcli - fix support for empty list (in compare and scrape) (https://github.com/ansible-collections/community.general/pull/6769).
- nsupdate - fix a possible ``list index out of range`` exception (https://github.com/ansible-collections/community.general/issues/836). - nsupdate - fix a possible ``list index out of range`` exception (https://github.com/ansible-collections/community.general/issues/836).
- oci_utils module util - fix inappropriate logical comparison expressions and - oci_utils module util - fix inappropriate logical comparison expressions
makes them simpler. The previous checks had logical short circuits (https://github.com/ansible-collections/community.general/pull/7125). and makes them simpler. The previous checks had logical short circuits (https://github.com/ansible-collections/community.general/pull/7125).
- oci_utils module utils - avoid direct type comparisons (https://github.com/ansible-collections/community.general/pull/7085). - oci_utils module utils - avoid direct type comparisons (https://github.com/ansible-collections/community.general/pull/7085).
- onepassword - fix KeyError exception when trying to access value of a field - onepassword - fix KeyError exception when trying to access value of a field
that is not filled out in OnePassword item (https://github.com/ansible-collections/community.general/pull/7241). that is not filled out in OnePassword item (https://github.com/ansible-collections/community.general/pull/7241).
- openbsd_pkg - the pkg_info(1) behavior has changed in OpenBSD >7.3. The error - openbsd_pkg - the pkg_info(1) behavior has changed in OpenBSD >7.3. The
message ``Can't find`` should not lead to an error case (https://github.com/ansible-collections/community.general/pull/6785). error message ``Can't find`` should not lead to an error case (https://github.com/ansible-collections/community.general/pull/6785).
- pacman - module recognizes the output of ``yay`` running as ``root`` (https://github.com/ansible-collections/community.general/pull/6713). - pacman - module recognizes the output of ``yay`` running as ``root`` (https://github.com/ansible-collections/community.general/pull/6713).
- portage - fix ``changed_use`` and ``newuse`` not triggering rebuilds (https://github.com/ansible-collections/community.general/issues/6008, - portage - fix ``changed_use`` and ``newuse`` not triggering rebuilds (https://github.com/ansible-collections/community.general/issues/6008,
https://github.com/ansible-collections/community.general/pull/6548). https://github.com/ansible-collections/community.general/pull/6548).
@ -119,24 +120,25 @@ releases:
being appended (https://github.com/ansible-collections/community.general/pull/6770). being appended (https://github.com/ansible-collections/community.general/pull/6770).
- proxmox_kvm - ``absent`` state with ``force`` specified failed to stop the - proxmox_kvm - ``absent`` state with ``force`` specified failed to stop the
VM due to the ``timeout`` value not being passed to ``stop_vm`` (https://github.com/ansible-collections/community.general/pull/6827). VM due to the ``timeout`` value not being passed to ``stop_vm`` (https://github.com/ansible-collections/community.general/pull/6827).
- proxmox_kvm - ``restarted`` state did not actually restart a VM in some VM - proxmox_kvm - ``restarted`` state did not actually restart a VM in some
configurations. The state now uses the Proxmox reboot endpoint instead of VM configurations. The state now uses the Proxmox reboot endpoint instead
calling the ``stop_vm`` and ``start_vm`` functions (https://github.com/ansible-collections/community.general/pull/6773). of calling the ``stop_vm`` and ``start_vm`` functions (https://github.com/ansible-collections/community.general/pull/6773).
- proxmox_kvm - allow creation of VM with existing name but new vmid (https://github.com/ansible-collections/community.general/issues/6155, - proxmox_kvm - allow creation of VM with existing name but new vmid (https://github.com/ansible-collections/community.general/issues/6155,
https://github.com/ansible-collections/community.general/pull/6709). https://github.com/ansible-collections/community.general/pull/6709).
- proxmox_kvm - when ``name`` option is provided without ``vmid`` and VM with - proxmox_kvm - when ``name`` option is provided without ``vmid`` and VM with
that name already exists then no new VM will be created (https://github.com/ansible-collections/community.general/issues/6911, that name already exists then no new VM will be created (https://github.com/ansible-collections/community.general/issues/6911,
https://github.com/ansible-collections/community.general/pull/6981). https://github.com/ansible-collections/community.general/pull/6981).
- proxmox_tasks_info - remove ``api_user`` + ``api_password`` constraint from - proxmox_tasks_info - remove ``api_user`` + ``api_password`` constraint from
``required_together`` as it causes to require ``api_password`` even when API ``required_together`` as it causes to require ``api_password`` even when
token param is used (https://github.com/ansible-collections/community.general/issues/6201). API token param is used (https://github.com/ansible-collections/community.general/issues/6201).
- proxmox_template - require ``requests_toolbelt`` module to fix issue with - proxmox_template - require ``requests_toolbelt`` module to fix issue with
uploading large templates (https://github.com/ansible-collections/community.general/issues/5579, uploading large templates (https://github.com/ansible-collections/community.general/issues/5579,
https://github.com/ansible-collections/community.general/pull/6757). https://github.com/ansible-collections/community.general/pull/6757).
- proxmox_user_info - avoid direct type comparisons (https://github.com/ansible-collections/community.general/pull/7085). - proxmox_user_info - avoid direct type comparisons (https://github.com/ansible-collections/community.general/pull/7085).
- redfish_info - fix ``ListUsers`` to not show empty account slots (https://github.com/ansible-collections/community.general/issues/6771, - redfish_info - fix ``ListUsers`` to not show empty account slots (https://github.com/ansible-collections/community.general/issues/6771,
https://github.com/ansible-collections/community.general/pull/6772). https://github.com/ansible-collections/community.general/pull/6772).
- 'redhat_subscription - use the right D-Bus options for the consumer type when - 'redhat_subscription - use the right D-Bus options for the consumer type
when
registering a RHEL system older than 9 or a RHEL 9 system older than 9.2 registering a RHEL system older than 9 or a RHEL 9 system older than 9.2
@ -161,15 +163,16 @@ releases:
being 3 characters longer than desired (https://github.com/ansible-collections/community.general/pull/7374). being 3 characters longer than desired (https://github.com/ansible-collections/community.general/pull/7374).
- snap - an exception was being raised when snap list was empty (https://github.com/ansible-collections/community.general/pull/7124, - snap - an exception was being raised when snap list was empty (https://github.com/ansible-collections/community.general/pull/7124,
https://github.com/ansible-collections/community.general/issues/7120). https://github.com/ansible-collections/community.general/issues/7120).
- snap - assume default track ``latest`` in parameter ``channel`` when not specified - snap - assume default track ``latest`` in parameter ``channel`` when not
(https://github.com/ansible-collections/community.general/pull/6835, https://github.com/ansible-collections/community.general/issues/6821). specified (https://github.com/ansible-collections/community.general/pull/6835,
- snap - change the change detection mechanism from "parsing installation" to https://github.com/ansible-collections/community.general/issues/6821).
"comparing end state with initial state" (https://github.com/ansible-collections/community.general/pull/7340, - snap - change the change detection mechanism from "parsing installation"
to "comparing end state with initial state" (https://github.com/ansible-collections/community.general/pull/7340,
https://github.com/ansible-collections/community.general/issues/7265). https://github.com/ansible-collections/community.general/issues/7265).
- snap - fix crash when multiple snaps are specified and one has ``---`` in - snap - fix crash when multiple snaps are specified and one has ``---`` in
its description (https://github.com/ansible-collections/community.general/pull/7046). its description (https://github.com/ansible-collections/community.general/pull/7046).
- snap - fix the processing of the commands' output, stripping spaces and newlines - snap - fix the processing of the commands' output, stripping spaces and
from it (https://github.com/ansible-collections/community.general/pull/6826, newlines from it (https://github.com/ansible-collections/community.general/pull/6826,
https://github.com/ansible-collections/community.general/issues/6803). https://github.com/ansible-collections/community.general/issues/6803).
- sorcery - fix interruption of the multi-stage process (https://github.com/ansible-collections/community.general/pull/7012). - sorcery - fix interruption of the multi-stage process (https://github.com/ansible-collections/community.general/pull/7012).
- sorcery - fix queue generation before the whole system rebuild (https://github.com/ansible-collections/community.general/pull/7012). - sorcery - fix queue generation before the whole system rebuild (https://github.com/ansible-collections/community.general/pull/7012).
@ -181,28 +184,29 @@ releases:
- zypper - added handling of zypper exitcode 102. Changed state is set correctly - zypper - added handling of zypper exitcode 102. Changed state is set correctly
now and rc 102 is still preserved to be evaluated by the playbook (https://github.com/ansible-collections/community.general/pull/6534). now and rc 102 is still preserved to be evaluated by the playbook (https://github.com/ansible-collections/community.general/pull/6534).
deprecated_features: deprecated_features:
- CmdRunner module utils - deprecate ``cmd_runner_fmt.as_default_type()`` formatter - CmdRunner module utils - deprecate ``cmd_runner_fmt.as_default_type()``
(https://github.com/ansible-collections/community.general/pull/6601). formatter (https://github.com/ansible-collections/community.general/pull/6601).
- MH VarsMixin module utils - deprecates ``VarsMixin`` and supporting classes - MH VarsMixin module utils - deprecates ``VarsMixin`` and supporting classes
in favor of plain ``vardict`` module util (https://github.com/ansible-collections/community.general/pull/6649). in favor of plain ``vardict`` module util (https://github.com/ansible-collections/community.general/pull/6649).
- ansible_galaxy_install - the ``ack_ansible29`` and ``ack_min_ansiblecore211`` - ansible_galaxy_install - the ``ack_ansible29`` and ``ack_min_ansiblecore211``
options have been deprecated and will be removed in community.general 9.0.0 options have been deprecated and will be removed in community.general 9.0.0
(https://github.com/ansible-collections/community.general/pull/7358). (https://github.com/ansible-collections/community.general/pull/7358).
- consul - the ``ack_params_state_absent`` option has been deprecated and will - consul - the ``ack_params_state_absent`` option has been deprecated and
be removed in community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/7358). will be removed in community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/7358).
- cpanm - value ``compatibility`` is deprecated as default for parameter ``mode`` - cpanm - value ``compatibility`` is deprecated as default for parameter ``mode``
(https://github.com/ansible-collections/community.general/pull/6512). (https://github.com/ansible-collections/community.general/pull/6512).
- ejabberd_user - deprecate the parameter ``logging`` in favour of producing - ejabberd_user - deprecate the parameter ``logging`` in favour of producing
more detailed information in the module output (https://github.com/ansible-collections/community.general/pull/7043). more detailed information in the module output (https://github.com/ansible-collections/community.general/pull/7043).
- flowdock - module relies entirely on no longer responsive API endpoints, and - flowdock - module relies entirely on no longer responsive API endpoints,
it will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6930). and it will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6930).
- proxmox - old feature flag ``proxmox_default_behavior`` will be removed in - proxmox - old feature flag ``proxmox_default_behavior`` will be removed
community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/6836). in community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/6836).
- proxmox_kvm - deprecate the option ``proxmox_default_behavior`` (https://github.com/ansible-collections/community.general/pull/7377). - proxmox_kvm - deprecate the option ``proxmox_default_behavior`` (https://github.com/ansible-collections/community.general/pull/7377).
- redfish_info, redfish_config, redfish_command - the default value ``10`` for - redfish_info, redfish_config, redfish_command - the default value ``10``
the ``timeout`` option is deprecated and will change to ``60`` in community.general for the ``timeout`` option is deprecated and will change to ``60`` in community.general
9.0.0 (https://github.com/ansible-collections/community.general/pull/7295). 9.0.0 (https://github.com/ansible-collections/community.general/pull/7295).
- 'redhat module utils - the ``module_utils.redhat`` module is deprecated, as - 'redhat module utils - the ``module_utils.redhat`` module is deprecated,
as
effectively unused: the ``Rhsm``, ``RhsmPool``, and ``RhsmPools`` classes effectively unused: the ``Rhsm``, ``RhsmPool``, and ``RhsmPools`` classes
@ -214,7 +218,8 @@ releases:
that the whole ``module_utils.redhat`` module will be dropped in that the whole ``module_utils.redhat`` module will be dropped in
community.general 10.0.0, so importing it without even using anything of it community.general 10.0.0, so importing it without even using anything of
it
will fail will fail
@ -242,14 +247,14 @@ releases:
- 'rhsm_repository - ``state=present`` has not been working as expected for - 'rhsm_repository - ``state=present`` has not been working as expected for
many years, many years,
and it seems it was not noticed so far; also, "presence" is not really a valid and it seems it was not noticed so far; also, "presence" is not really a
concept valid concept
for subscription repositories, which can only be enabled or disabled. Hence, for subscription repositories, which can only be enabled or disabled. Hence,
mark the mark the
``present`` and ``absent`` values of the ``state`` option as deprecated, slating ``present`` and ``absent`` values of the ``state`` option as deprecated,
them slating them
for removal in community.general 10.0.0 for removal in community.general 10.0.0
@ -271,12 +276,13 @@ releases:
known_issues: known_issues:
- Ansible markup will show up in raw form on ansible-doc text output for ansible-core - Ansible markup will show up in raw form on ansible-doc text output for ansible-core
before 2.15. If you have trouble deciphering the documentation markup, please before 2.15. If you have trouble deciphering the documentation markup, please
upgrade to ansible-core 2.15 (or newer), or read the HTML documentation on upgrade to ansible-core 2.15 (or newer), or read the HTML documentation
https://docs.ansible.com/ansible/devel/collections/community/general/ (https://github.com/ansible-collections/community.general/pull/6539). on https://docs.ansible.com/ansible/devel/collections/community/general/
(https://github.com/ansible-collections/community.general/pull/6539).
minor_changes: minor_changes:
- The collection will start using semantic markup (https://github.com/ansible-collections/community.general/pull/6539). - The collection will start using semantic markup (https://github.com/ansible-collections/community.general/pull/6539).
- VarDict module utils - add method ``VarDict.as_dict()`` to convert to a plain - VarDict module utils - add method ``VarDict.as_dict()`` to convert to a
``dict`` object (https://github.com/ansible-collections/community.general/pull/6602). plain ``dict`` object (https://github.com/ansible-collections/community.general/pull/6602).
- 'apt_rpm - extract package name from local ``.rpm`` path when verifying - 'apt_rpm - extract package name from local ``.rpm`` path when verifying
installation success. Allows installing packages from local ``.rpm`` files installation success. Allows installing packages from local ``.rpm`` files
@ -284,8 +290,8 @@ releases:
(https://github.com/ansible-collections/community.general/pull/7396). (https://github.com/ansible-collections/community.general/pull/7396).
' '
- cargo - add option ``executable``, which allows user to specify path to the - cargo - add option ``executable``, which allows user to specify path to
cargo binary (https://github.com/ansible-collections/community.general/pull/7352). the cargo binary (https://github.com/ansible-collections/community.general/pull/7352).
- cargo - add option ``locked`` which allows user to specify install the locked - cargo - add option ``locked`` which allows user to specify install the locked
version of dependency instead of latest compatible version (https://github.com/ansible-collections/community.general/pull/6134). version of dependency instead of latest compatible version (https://github.com/ansible-collections/community.general/pull/6134).
- chroot connection plugin - add ``disable_root_check`` option (https://github.com/ansible-collections/community.general/pull/7099). - chroot connection plugin - add ``disable_root_check`` option (https://github.com/ansible-collections/community.general/pull/7099).
@ -301,9 +307,9 @@ releases:
- cobbler inventory plugin - add warning for systems with empty profiles (https://github.com/ansible-collections/community.general/pull/6502). - cobbler inventory plugin - add warning for systems with empty profiles (https://github.com/ansible-collections/community.general/pull/6502).
- cobbler inventory plugin - convert Ansible unicode strings to native Python - cobbler inventory plugin - convert Ansible unicode strings to native Python
unicode strings before passing user/password to XMLRPC client (https://github.com/ansible-collections/community.general/pull/6923). unicode strings before passing user/password to XMLRPC client (https://github.com/ansible-collections/community.general/pull/6923).
- consul_session - drops requirement for the ``python-consul`` library to communicate - consul_session - drops requirement for the ``python-consul`` library to
with the Consul API, instead relying on the existing ``requests`` library communicate with the Consul API, instead relying on the existing ``requests``
requirement (https://github.com/ansible-collections/community.general/pull/6755). library requirement (https://github.com/ansible-collections/community.general/pull/6755).
- copr - respawn module to use the system python interpreter when the ``dnf`` - copr - respawn module to use the system python interpreter when the ``dnf``
python module is not available in ``ansible_python_interpreter`` (https://github.com/ansible-collections/community.general/pull/6522). python module is not available in ``ansible_python_interpreter`` (https://github.com/ansible-collections/community.general/pull/6522).
- cpanm - minor refactor when creating the ``CmdRunner`` object (https://github.com/ansible-collections/community.general/pull/7231). - cpanm - minor refactor when creating the ``CmdRunner`` object (https://github.com/ansible-collections/community.general/pull/7231).
@ -335,12 +341,12 @@ releases:
- jenkins_build - add new ``detach`` option, which allows the module to exit - jenkins_build - add new ``detach`` option, which allows the module to exit
successfully as long as the build is created (default functionality is still successfully as long as the build is created (default functionality is still
waiting for the build to end before exiting) (https://github.com/ansible-collections/community.general/pull/7204). waiting for the build to end before exiting) (https://github.com/ansible-collections/community.general/pull/7204).
- jenkins_build - add new ``time_between_checks`` option, which allows to configure - jenkins_build - add new ``time_between_checks`` option, which allows to
the wait time between requests to the Jenkins server (https://github.com/ansible-collections/community.general/pull/7204). configure the wait time between requests to the Jenkins server (https://github.com/ansible-collections/community.general/pull/7204).
- keycloak_authentication - added provider ID choices, since Keycloak supports - keycloak_authentication - added provider ID choices, since Keycloak supports
only those two specific ones (https://github.com/ansible-collections/community.general/pull/6763). only those two specific ones (https://github.com/ansible-collections/community.general/pull/6763).
- keycloak_client_rolemapping - adds support for subgroups with additional parameter - keycloak_client_rolemapping - adds support for subgroups with additional
``parents`` (https://github.com/ansible-collections/community.general/pull/6687). parameter ``parents`` (https://github.com/ansible-collections/community.general/pull/6687).
- keycloak_role - add composite roles support for realm and client roles (https://github.com/ansible-collections/community.general/pull/6469). - keycloak_role - add composite roles support for realm and client roles (https://github.com/ansible-collections/community.general/pull/6469).
- keyring - minor refactor removing unnecessary code statements (https://github.com/ansible-collections/community.general/pull/6927). - keyring - minor refactor removing unnecessary code statements (https://github.com/ansible-collections/community.general/pull/6927).
- ldap_* - add new arguments ``client_cert`` and ``client_key`` to the LDAP - ldap_* - add new arguments ``client_cert`` and ``client_key`` to the LDAP
@ -348,17 +354,18 @@ releases:
- ldap_search - add a new ``page_size`` option to enable paged searches (https://github.com/ansible-collections/community.general/pull/6648). - ldap_search - add a new ``page_size`` option to enable paged searches (https://github.com/ansible-collections/community.general/pull/6648).
- locale_gen - module has been refactored to use ``ModuleHelper`` and ``CmdRunner`` - locale_gen - module has been refactored to use ``ModuleHelper`` and ``CmdRunner``
(https://github.com/ansible-collections/community.general/pull/6903). (https://github.com/ansible-collections/community.general/pull/6903).
- locale_gen - module now using ``CmdRunner`` to execute external commands (https://github.com/ansible-collections/community.general/pull/6820). - locale_gen - module now using ``CmdRunner`` to execute external commands
- lvg - add ``active`` and ``inactive`` values to the ``state`` option for active (https://github.com/ansible-collections/community.general/pull/6820).
state management feature (https://github.com/ansible-collections/community.general/pull/6682). - lvg - add ``active`` and ``inactive`` values to the ``state`` option for
active state management feature (https://github.com/ansible-collections/community.general/pull/6682).
- lvg - add ``reset_vg_uuid``, ``reset_pv_uuid`` options for UUID reset feature - lvg - add ``reset_vg_uuid``, ``reset_pv_uuid`` options for UUID reset feature
(https://github.com/ansible-collections/community.general/pull/6682). (https://github.com/ansible-collections/community.general/pull/6682).
- lxc connection plugin - properly handle a change of the ``remote_addr`` option - lxc connection plugin - properly handle a change of the ``remote_addr``
(https://github.com/ansible-collections/community.general/pull/7373). option (https://github.com/ansible-collections/community.general/pull/7373).
- lxd connection plugin - automatically translate ``remote_addr`` from FQDN - lxd connection plugin - automatically translate ``remote_addr`` from FQDN
to (short) hostname (https://github.com/ansible-collections/community.general/pull/7360). to (short) hostname (https://github.com/ansible-collections/community.general/pull/7360).
- lxd connection plugin - update error parsing to work with newer messages mentioning - lxd connection plugin - update error parsing to work with newer messages
instances (https://github.com/ansible-collections/community.general/pull/7360). mentioning instances (https://github.com/ansible-collections/community.general/pull/7360).
- lxd inventory plugin - add ``server_cert`` option for trust anchor to use - lxd inventory plugin - add ``server_cert`` option for trust anchor to use
for TLS verification of server certificates (https://github.com/ansible-collections/community.general/pull/7392). for TLS verification of server certificates (https://github.com/ansible-collections/community.general/pull/7392).
- lxd inventory plugin - add ``server_check_hostname`` option to disable hostname - lxd inventory plugin - add ``server_check_hostname`` option to disable hostname
@ -369,8 +376,8 @@ releases:
- make - allows ``params`` to be used without value (https://github.com/ansible-collections/community.general/pull/7180). - make - allows ``params`` to be used without value (https://github.com/ansible-collections/community.general/pull/7180).
- mas - disable sign-in check for macOS 12+ as ``mas account`` is non-functional - mas - disable sign-in check for macOS 12+ as ``mas account`` is non-functional
(https://github.com/ansible-collections/community.general/pull/6520). (https://github.com/ansible-collections/community.general/pull/6520).
- newrelic_deployment - add option ``app_name_exact_match``, which filters results - newrelic_deployment - add option ``app_name_exact_match``, which filters
for the exact app_name provided (https://github.com/ansible-collections/community.general/pull/7355). results for the exact app_name provided (https://github.com/ansible-collections/community.general/pull/7355).
- nmap inventory plugin - now has a ``use_arp_ping`` option to allow the user - nmap inventory plugin - now has a ``use_arp_ping`` option to allow the user
to disable the default ARP ping query for a more reliable form (https://github.com/ansible-collections/community.general/pull/7119). to disable the default ARP ping query for a more reliable form (https://github.com/ansible-collections/community.general/pull/7119).
- nmcli - add support for ``ipv4.dns-options`` and ``ipv6.dns-options`` (https://github.com/ansible-collections/community.general/pull/6902). - nmcli - add support for ``ipv4.dns-options`` and ``ipv6.dns-options`` (https://github.com/ansible-collections/community.general/pull/6902).
@ -379,17 +386,17 @@ releases:
- npm - module now using ``CmdRunner`` to execute external commands (https://github.com/ansible-collections/community.general/pull/6989). - npm - module now using ``CmdRunner`` to execute external commands (https://github.com/ansible-collections/community.general/pull/6989).
- onepassword lookup plugin - add service account support (https://github.com/ansible-collections/community.general/issues/6635, - onepassword lookup plugin - add service account support (https://github.com/ansible-collections/community.general/issues/6635,
https://github.com/ansible-collections/community.general/pull/6660). https://github.com/ansible-collections/community.general/pull/6660).
- onepassword lookup plugin - introduce ``account_id`` option which allows specifying - onepassword lookup plugin - introduce ``account_id`` option which allows
which account to use (https://github.com/ansible-collections/community.general/pull/7308). specifying which account to use (https://github.com/ansible-collections/community.general/pull/7308).
- onepassword_raw lookup plugin - add service account support (https://github.com/ansible-collections/community.general/issues/6635, - onepassword_raw lookup plugin - add service account support (https://github.com/ansible-collections/community.general/issues/6635,
https://github.com/ansible-collections/community.general/pull/6660). https://github.com/ansible-collections/community.general/pull/6660).
- onepassword_raw lookup plugin - introduce ``account_id`` option which allows - onepassword_raw lookup plugin - introduce ``account_id`` option which allows
specifying which account to use (https://github.com/ansible-collections/community.general/pull/7308). specifying which account to use (https://github.com/ansible-collections/community.general/pull/7308).
- opentelemetry callback plugin - add span attributes in the span event (https://github.com/ansible-collections/community.general/pull/6531). - opentelemetry callback plugin - add span attributes in the span event (https://github.com/ansible-collections/community.general/pull/6531).
- opkg - add ``executable`` parameter allowing to specify the path of the ``opkg`` - opkg - add ``executable`` parameter allowing to specify the path of the
command (https://github.com/ansible-collections/community.general/pull/6862). ``opkg`` command (https://github.com/ansible-collections/community.general/pull/6862).
- opkg - remove default value ``""`` for parameter ``force`` as it causes the - opkg - remove default value ``""`` for parameter ``force`` as it causes
same behaviour of not having that parameter (https://github.com/ansible-collections/community.general/pull/6513). the same behaviour of not having that parameter (https://github.com/ansible-collections/community.general/pull/6513).
- pagerduty - adds in option to use v2 API for creating pagerduty incidents - pagerduty - adds in option to use v2 API for creating pagerduty incidents
(https://github.com/ansible-collections/community.general/issues/6151) (https://github.com/ansible-collections/community.general/issues/6151)
- parted - on resize, use ``--fix`` option if available (https://github.com/ansible-collections/community.general/pull/7304). - parted - on resize, use ``--fix`` option if available (https://github.com/ansible-collections/community.general/pull/7304).
@ -401,20 +408,21 @@ releases:
- proxmox - support ``timezone`` parameter at container creation (https://github.com/ansible-collections/community.general/pull/6510). - proxmox - support ``timezone`` parameter at container creation (https://github.com/ansible-collections/community.general/pull/6510).
- proxmox inventory plugin - add composite variables support for Proxmox nodes - proxmox inventory plugin - add composite variables support for Proxmox nodes
(https://github.com/ansible-collections/community.general/issues/6640). (https://github.com/ansible-collections/community.general/issues/6640).
- proxmox_kvm - added support for ``tpmstate0`` parameter to configure TPM (Trusted - proxmox_kvm - added support for ``tpmstate0`` parameter to configure TPM
Platform Module) disk. TPM is required for Windows 11 installations (https://github.com/ansible-collections/community.general/pull/6533). (Trusted Platform Module) disk. TPM is required for Windows 11 installations
(https://github.com/ansible-collections/community.general/pull/6533).
- proxmox_kvm - enabled force restart of VM, bringing the ``force`` parameter - proxmox_kvm - enabled force restart of VM, bringing the ``force`` parameter
functionality in line with what is described in the docs (https://github.com/ansible-collections/community.general/pull/6914). functionality in line with what is described in the docs (https://github.com/ansible-collections/community.general/pull/6914).
- proxmox_kvm - re-use ``timeout`` module param to forcefully shutdown a virtual - proxmox_kvm - re-use ``timeout`` module param to forcefully shutdown a virtual
machine when ``state`` is ``stopped`` (https://github.com/ansible-collections/community.general/issues/6257). machine when ``state`` is ``stopped`` (https://github.com/ansible-collections/community.general/issues/6257).
- proxmox_snap - add ``retention`` parameter to delete old snapshots (https://github.com/ansible-collections/community.general/pull/6576). - proxmox_snap - add ``retention`` parameter to delete old snapshots (https://github.com/ansible-collections/community.general/pull/6576).
- proxmox_vm_info - ``node`` parameter is no longer required. Information can - proxmox_vm_info - ``node`` parameter is no longer required. Information
be obtained for the whole cluster (https://github.com/ansible-collections/community.general/pull/6976). can be obtained for the whole cluster (https://github.com/ansible-collections/community.general/pull/6976).
- proxmox_vm_info - non-existing provided by name/vmid VM would return empty - proxmox_vm_info - non-existing provided by name/vmid VM would return empty
results instead of failing (https://github.com/ansible-collections/community.general/pull/7049). results instead of failing (https://github.com/ansible-collections/community.general/pull/7049).
- pubnub_blocks - minor refactor removing unnecessary code statements (https://github.com/ansible-collections/community.general/pull/6928). - pubnub_blocks - minor refactor removing unnecessary code statements (https://github.com/ansible-collections/community.general/pull/6928).
- random_string - added new ``ignore_similar_chars`` and ``similar_chars`` option - random_string - added new ``ignore_similar_chars`` and ``similar_chars``
to ignore certain chars (https://github.com/ansible-collections/community.general/pull/7242). option to ignore certain chars (https://github.com/ansible-collections/community.general/pull/7242).
- redfish_command - add ``MultipartHTTPPushUpdate`` command (https://github.com/ansible-collections/community.general/issues/6471, - redfish_command - add ``MultipartHTTPPushUpdate`` command (https://github.com/ansible-collections/community.general/issues/6471,
https://github.com/ansible-collections/community.general/pull/6612). https://github.com/ansible-collections/community.general/pull/6612).
- redfish_command - add ``account_types`` and ``oem_account_types`` as optional - redfish_command - add ``account_types`` and ``oem_account_types`` as optional
@ -434,7 +442,8 @@ releases:
- redfish_info - adds ``LinkStatus`` to NIC inventory (https://github.com/ansible-collections/community.general/pull/7318). - redfish_info - adds ``LinkStatus`` to NIC inventory (https://github.com/ansible-collections/community.general/pull/7318).
- redfish_info - adds ``ProcessorArchitecture`` to CPU inventory (https://github.com/ansible-collections/community.general/pull/6864). - redfish_info - adds ``ProcessorArchitecture`` to CPU inventory (https://github.com/ansible-collections/community.general/pull/6864).
- redfish_info - fix for ``GetVolumeInventory``, Controller name was getting - redfish_info - fix for ``GetVolumeInventory``, Controller name was getting
populated incorrectly and duplicates were seen in the volumes retrieved (https://github.com/ansible-collections/community.general/pull/6719). populated incorrectly and duplicates were seen in the volumes retrieved
(https://github.com/ansible-collections/community.general/pull/6719).
- redfish_info - report ``Id`` in the output of ``GetManagerInventory`` (https://github.com/ansible-collections/community.general/pull/7140). - redfish_info - report ``Id`` in the output of ``GetManagerInventory`` (https://github.com/ansible-collections/community.general/pull/7140).
- redfish_utils - use ``Controllers`` key in redfish data to obtain Storage - redfish_utils - use ``Controllers`` key in redfish data to obtain Storage
controllers properties (https://github.com/ansible-collections/community.general/pull/7081). controllers properties (https://github.com/ansible-collections/community.general/pull/7081).
@ -475,8 +484,8 @@ releases:
https://github.com/ansible-collections/community.general/pull/6837). https://github.com/ansible-collections/community.general/pull/6837).
' '
- scaleway_security_group_rule - minor refactor removing unnecessary code statements - scaleway_security_group_rule - minor refactor removing unnecessary code
(https://github.com/ansible-collections/community.general/pull/6928). statements (https://github.com/ansible-collections/community.general/pull/6928).
- shutdown - use ``shutdown -p ...`` with FreeBSD to halt and power off machine - shutdown - use ``shutdown -p ...`` with FreeBSD to halt and power off machine
(https://github.com/ansible-collections/community.general/pull/7102). (https://github.com/ansible-collections/community.general/pull/7102).
- snap - add option ``dangerous`` to the module, that will map into the command - snap - add option ``dangerous`` to the module, that will map into the command
@ -487,15 +496,15 @@ releases:
https://github.com/ansible-collections/community.general/issues/1606). https://github.com/ansible-collections/community.general/issues/1606).
- sorcery - add grimoire (repository) management support (https://github.com/ansible-collections/community.general/pull/7012). - sorcery - add grimoire (repository) management support (https://github.com/ansible-collections/community.general/pull/7012).
- sorcery - minor refactor (https://github.com/ansible-collections/community.general/pull/6525). - sorcery - minor refactor (https://github.com/ansible-collections/community.general/pull/6525).
- supervisorctl - allow to stop matching running processes before removing them - supervisorctl - allow to stop matching running processes before removing
with ``stop_before_removing=true`` (https://github.com/ansible-collections/community.general/pull/7284). them with ``stop_before_removing=true`` (https://github.com/ansible-collections/community.general/pull/7284).
- tss lookup plugin - allow to fetch secret IDs which are in a folder based - tss lookup plugin - allow to fetch secret IDs which are in a folder based
on folder ID. Previously, we could not fetch secrets based on folder ID but on folder ID. Previously, we could not fetch secrets based on folder ID
now use ``fetch_secret_ids_from_folder`` option to indicate to fetch secret but now use ``fetch_secret_ids_from_folder`` option to indicate to fetch
IDs based on folder ID (https://github.com/ansible-collections/community.general/issues/6223). secret IDs based on folder ID (https://github.com/ansible-collections/community.general/issues/6223).
- tss lookup plugin - allow to fetch secret by path. Previously, we could not - tss lookup plugin - allow to fetch secret by path. Previously, we could
fetch secret by path but now use ``secret_path`` option to indicate to fetch not fetch secret by path but now use ``secret_path`` option to indicate
secret by secret path (https://github.com/ansible-collections/community.general/pull/6881). to fetch secret by secret path (https://github.com/ansible-collections/community.general/pull/6881).
- unixy callback plugin - add support for ``check_mode_markers`` option (https://github.com/ansible-collections/community.general/pull/7179). - unixy callback plugin - add support for ``check_mode_markers`` option (https://github.com/ansible-collections/community.general/pull/7179).
- vardict module utils - added convenience methods to ``VarDict`` (https://github.com/ansible-collections/community.general/pull/6647). - vardict module utils - added convenience methods to ``VarDict`` (https://github.com/ansible-collections/community.general/pull/6647).
- xenserver_guest_info - minor refactor removing unnecessary code statements - xenserver_guest_info - minor refactor removing unnecessary code statements
@ -509,8 +518,8 @@ releases:
2023-11-01. 2023-11-01.
removed_features: removed_features:
- The collection no longer supports ansible-core 2.11 and ansible-core 2.12. - The collection no longer supports ansible-core 2.11 and ansible-core 2.12.
Parts of the collection might still work on these ansible-core versions, but Parts of the collection might still work on these ansible-core versions,
others might not (https://github.com/ansible-collections/community.general/pull/7269). but others might not (https://github.com/ansible-collections/community.general/pull/7269).
- ansible_galaxy_install - support for Ansible 2.9 and ansible-base 2.10 has - ansible_galaxy_install - support for Ansible 2.9 and ansible-base 2.10 has
been removed (https://github.com/ansible-collections/community.general/pull/7358). been removed (https://github.com/ansible-collections/community.general/pull/7358).
- consul - when ``state=absent``, the options ``script``, ``ttl``, ``tcp``, - consul - when ``state=absent``, the options ``script``, ``ttl``, ``tcp``,
@ -518,7 +527,8 @@ releases:
- gconftool2 - ``state=get`` has been removed. Use the module ``community.general.gconftool2_info`` - gconftool2 - ``state=get`` has been removed. Use the module ``community.general.gconftool2_info``
instead (https://github.com/ansible-collections/community.general/pull/7358). instead (https://github.com/ansible-collections/community.general/pull/7358).
- gitlab_runner - remove the default value for the ``access_level`` option. - gitlab_runner - remove the default value for the ``access_level`` option.
To restore the previous behavior, explicitly set it to ``ref_protected`` (https://github.com/ansible-collections/community.general/pull/7358). To restore the previous behavior, explicitly set it to ``ref_protected``
(https://github.com/ansible-collections/community.general/pull/7358).
- htpasswd - removed code for passlib <1.6 (https://github.com/ansible-collections/community.general/pull/6901). - htpasswd - removed code for passlib <1.6 (https://github.com/ansible-collections/community.general/pull/6901).
- manageiq_polices - ``state=list`` has been removed. Use the module ``community.general.manageiq_policies_info`` - manageiq_polices - ``state=list`` has been removed. Use the module ``community.general.manageiq_policies_info``
instead (https://github.com/ansible-collections/community.general/pull/7358). instead (https://github.com/ansible-collections/community.general/pull/7358).
@ -526,7 +536,8 @@ releases:
instead (https://github.com/ansible-collections/community.general/pull/7358). instead (https://github.com/ansible-collections/community.general/pull/7358).
- mh.mixins.cmd module utils - the ``ArgFormat`` class has been removed (https://github.com/ansible-collections/community.general/pull/7358). - mh.mixins.cmd module utils - the ``ArgFormat`` class has been removed (https://github.com/ansible-collections/community.general/pull/7358).
- mh.mixins.cmd module utils - the ``CmdMixin`` mixin has been removed. Use - mh.mixins.cmd module utils - the ``CmdMixin`` mixin has been removed. Use
``community.general.plugins.module_utils.cmd_runner.CmdRunner`` instead (https://github.com/ansible-collections/community.general/pull/7358). ``community.general.plugins.module_utils.cmd_runner.CmdRunner`` instead
(https://github.com/ansible-collections/community.general/pull/7358).
- mh.mixins.cmd module utils - the mh.mixins.cmd module utils has been removed - mh.mixins.cmd module utils - the mh.mixins.cmd module utils has been removed
after all its contents were removed (https://github.com/ansible-collections/community.general/pull/7358). after all its contents were removed (https://github.com/ansible-collections/community.general/pull/7358).
- mh.module_helper module utils - the ``CmdModuleHelper`` and ``CmdStateModuleHelper`` - mh.module_helper module utils - the ``CmdModuleHelper`` and ``CmdStateModuleHelper``
@ -726,8 +737,8 @@ releases:
- description: Manipulate Consul roles - description: Manipulate Consul roles
name: consul_role name: consul_role
namespace: '' namespace: ''
- description: Runs the discovery program C(facter) on the remote system and return - description: Runs the discovery program C(facter) on the remote system and
Ansible facts return Ansible facts
name: facter_facts name: facter_facts
namespace: '' namespace: ''
- description: Set default handler for MIME type, for applications using Gnome - description: Set default handler for MIME type, for applications using Gnome
@ -812,8 +823,8 @@ releases:
8.0.2: 8.0.2:
changes: changes:
bugfixes: bugfixes:
- ocapi_utils, oci_utils, redfish_utils module utils - replace ``type()`` calls - ocapi_utils, oci_utils, redfish_utils module utils - replace ``type()``
with ``isinstance()`` calls (https://github.com/ansible-collections/community.general/pull/7501). calls with ``isinstance()`` calls (https://github.com/ansible-collections/community.general/pull/7501).
- pipx module utils - change the CLI argument formatter for the ``pip_args`` - pipx module utils - change the CLI argument formatter for the ``pip_args``
parameter (https://github.com/ansible-collections/community.general/issues/7497, parameter (https://github.com/ansible-collections/community.general/issues/7497,
https://github.com/ansible-collections/community.general/pull/7506). https://github.com/ansible-collections/community.general/pull/7506).
@ -826,14 +837,14 @@ releases:
8.1.0: 8.1.0:
changes: changes:
bugfixes: bugfixes:
- apt-rpm - the module did not upgrade packages if a newer version exists. Now - apt-rpm - the module did not upgrade packages if a newer version exists.
the package will be reinstalled if the candidate is newer than the installed Now the package will be reinstalled if the candidate is newer than the installed
version (https://github.com/ansible-collections/community.general/issues/7414). version (https://github.com/ansible-collections/community.general/issues/7414).
- cloudflare_dns - fix Cloudflare lookup of SHFP records (https://github.com/ansible-collections/community.general/issues/7652). - cloudflare_dns - fix Cloudflare lookup of SHFP records (https://github.com/ansible-collections/community.general/issues/7652).
- interface_files - also consider ``address_family`` when changing ``option=method`` - interface_files - also consider ``address_family`` when changing ``option=method``
(https://github.com/ansible-collections/community.general/issues/7610, https://github.com/ansible-collections/community.general/pull/7612). (https://github.com/ansible-collections/community.general/issues/7610, https://github.com/ansible-collections/community.general/pull/7612).
- irc - replace ``ssl.wrap_socket`` that was removed from Python 3.12 with code - irc - replace ``ssl.wrap_socket`` that was removed from Python 3.12 with
for creating a proper SSL context (https://github.com/ansible-collections/community.general/pull/7542). code for creating a proper SSL context (https://github.com/ansible-collections/community.general/pull/7542).
- keycloak_* - fix Keycloak API client to quote ``/`` properly (https://github.com/ansible-collections/community.general/pull/7641). - keycloak_* - fix Keycloak API client to quote ``/`` properly (https://github.com/ansible-collections/community.general/pull/7641).
- keycloak_authz_permission - resource payload variable for scope-based permission - keycloak_authz_permission - resource payload variable for scope-based permission
was constructed as a string, when it needs to be a list, even for a single was constructed as a string, when it needs to be a list, even for a single
@ -845,7 +856,8 @@ releases:
- onepassword lookup plugin - field and section titles are now case insensitive - onepassword lookup plugin - field and section titles are now case insensitive
when using op CLI version two or later. This matches the behavior of version when using op CLI version two or later. This matches the behavior of version
one (https://github.com/ansible-collections/community.general/pull/7564). one (https://github.com/ansible-collections/community.general/pull/7564).
- 'redhat_subscription - use the D-Bus registration on RHEL 7 only on 7.4 and - 'redhat_subscription - use the D-Bus registration on RHEL 7 only on 7.4
and
greater; older versions of RHEL 7 do not have it greater; older versions of RHEL 7 do not have it
@ -862,51 +874,53 @@ releases:
- elastic callback plugin - close elastic client to not leak resources (https://github.com/ansible-collections/community.general/pull/7517). - elastic callback plugin - close elastic client to not leak resources (https://github.com/ansible-collections/community.general/pull/7517).
- git_config - allow multiple git configs for the same name with the new ``add_mode`` - git_config - allow multiple git configs for the same name with the new ``add_mode``
option (https://github.com/ansible-collections/community.general/pull/7260). option (https://github.com/ansible-collections/community.general/pull/7260).
- git_config - the ``after`` and ``before`` fields in the ``diff`` of the return - git_config - the ``after`` and ``before`` fields in the ``diff`` of the
value can be a list instead of a string in case more configs with the same return value can be a list instead of a string in case more configs with
key are affected (https://github.com/ansible-collections/community.general/pull/7260). the same key are affected (https://github.com/ansible-collections/community.general/pull/7260).
- git_config - when a value is unset, all configs with the same key are unset - git_config - when a value is unset, all configs with the same key are unset
(https://github.com/ansible-collections/community.general/pull/7260). (https://github.com/ansible-collections/community.general/pull/7260).
- gitlab modules - add ``ca_path`` option (https://github.com/ansible-collections/community.general/pull/7472). - gitlab modules - add ``ca_path`` option (https://github.com/ansible-collections/community.general/pull/7472).
- gitlab modules - remove duplicate ``gitlab`` package check (https://github.com/ansible-collections/community.general/pull/7486). - gitlab modules - remove duplicate ``gitlab`` package check (https://github.com/ansible-collections/community.general/pull/7486).
- gitlab_runner - add support for new runner creation workflow (https://github.com/ansible-collections/community.general/pull/7199). - gitlab_runner - add support for new runner creation workflow (https://github.com/ansible-collections/community.general/pull/7199).
- ipa_config - adds ``passkey`` choice to ``ipauserauthtype`` parameter's choices - ipa_config - adds ``passkey`` choice to ``ipauserauthtype`` parameter's
(https://github.com/ansible-collections/community.general/pull/7588). choices (https://github.com/ansible-collections/community.general/pull/7588).
- ipa_sudorule - adds options to include denied commands or command groups (https://github.com/ansible-collections/community.general/pull/7415). - ipa_sudorule - adds options to include denied commands or command groups
(https://github.com/ansible-collections/community.general/pull/7415).
- ipa_user - adds ``idp`` and ``passkey`` choice to ``ipauserauthtype`` parameter's - ipa_user - adds ``idp`` and ``passkey`` choice to ``ipauserauthtype`` parameter's
choices (https://github.com/ansible-collections/community.general/pull/7589). choices (https://github.com/ansible-collections/community.general/pull/7589).
- irc - add ``validate_certs`` option, and rename ``use_ssl`` to ``use_tls``, - irc - add ``validate_certs`` option, and rename ``use_ssl`` to ``use_tls``,
while keeping ``use_ssl`` as an alias. The default value for ``validate_certs`` while keeping ``use_ssl`` as an alias. The default value for ``validate_certs``
is ``false`` for backwards compatibility. We recommend to every user of this is ``false`` for backwards compatibility. We recommend to every user of
module to explicitly set ``use_tls=true`` and `validate_certs=true`` whenever this module to explicitly set ``use_tls=true`` and `validate_certs=true``
possible, especially when communicating to IRC servers over the internet (https://github.com/ansible-collections/community.general/pull/7550). whenever possible, especially when communicating to IRC servers over the
internet (https://github.com/ansible-collections/community.general/pull/7550).
- keycloak module utils - expose error message from Keycloak server for HTTP - keycloak module utils - expose error message from Keycloak server for HTTP
errors in some specific situations (https://github.com/ansible-collections/community.general/pull/7645). errors in some specific situations (https://github.com/ansible-collections/community.general/pull/7645).
- keycloak_user_federation - add option for ``krbPrincipalAttribute`` (https://github.com/ansible-collections/community.general/pull/7538). - keycloak_user_federation - add option for ``krbPrincipalAttribute`` (https://github.com/ansible-collections/community.general/pull/7538).
- lvol - change ``pvs`` argument type to list of strings (https://github.com/ansible-collections/community.general/pull/7676, - lvol - change ``pvs`` argument type to list of strings (https://github.com/ansible-collections/community.general/pull/7676,
https://github.com/ansible-collections/community.general/issues/7504). https://github.com/ansible-collections/community.general/issues/7504).
- 'lxd connection plugin - tighten the detection logic for lxd ``Instance not - 'lxd connection plugin - tighten the detection logic for lxd ``Instance
found`` errors, to avoid false detection on unrelated errors such as ``/usr/bin/python3: not found`` errors, to avoid false detection on unrelated errors such as
not found`` (https://github.com/ansible-collections/community.general/pull/7521).' ``/usr/bin/python3: not found`` (https://github.com/ansible-collections/community.general/pull/7521).'
- netcup_dns - adds support for record types ``OPENPGPKEY``, ``SMIMEA``, and - netcup_dns - adds support for record types ``OPENPGPKEY``, ``SMIMEA``, and
``SSHFP`` (https://github.com/ansible-collections/community.general/pull/7489). ``SSHFP`` (https://github.com/ansible-collections/community.general/pull/7489).
- nmcli - add support for new connection type ``loopback`` (https://github.com/ansible-collections/community.general/issues/6572). - nmcli - add support for new connection type ``loopback`` (https://github.com/ansible-collections/community.general/issues/6572).
- nmcli - allow for ``infiniband`` slaves of ``bond`` interface types (https://github.com/ansible-collections/community.general/pull/7569). - nmcli - allow for ``infiniband`` slaves of ``bond`` interface types (https://github.com/ansible-collections/community.general/pull/7569).
- nmcli - allow for the setting of ``MTU`` for ``infiniband`` and ``bond`` interface - nmcli - allow for the setting of ``MTU`` for ``infiniband`` and ``bond``
types (https://github.com/ansible-collections/community.general/pull/7499). interface types (https://github.com/ansible-collections/community.general/pull/7499).
- onepassword lookup plugin - support 1Password Connect with the opv2 client - onepassword lookup plugin - support 1Password Connect with the opv2 client
by setting the connect_host and connect_token parameters (https://github.com/ansible-collections/community.general/pull/7116). by setting the connect_host and connect_token parameters (https://github.com/ansible-collections/community.general/pull/7116).
- onepassword_raw lookup plugin - support 1Password Connect with the opv2 client - onepassword_raw lookup plugin - support 1Password Connect with the opv2
by setting the connect_host and connect_token parameters (https://github.com/ansible-collections/community.general/pull/7116) client by setting the connect_host and connect_token parameters (https://github.com/ansible-collections/community.general/pull/7116)
- passwordstore - adds ``timestamp`` and ``preserve`` parameters to modify the - passwordstore - adds ``timestamp`` and ``preserve`` parameters to modify
stored password format (https://github.com/ansible-collections/community.general/pull/7426). the stored password format (https://github.com/ansible-collections/community.general/pull/7426).
- proxmox - adds ``template`` value to the ``state`` parameter, allowing conversion - proxmox - adds ``template`` value to the ``state`` parameter, allowing conversion
of container to a template (https://github.com/ansible-collections/community.general/pull/7143). of container to a template (https://github.com/ansible-collections/community.general/pull/7143).
- proxmox - adds ``update`` parameter, allowing update of an already existing - proxmox - adds ``update`` parameter, allowing update of an already existing
containers configuration (https://github.com/ansible-collections/community.general/pull/7540). containers configuration (https://github.com/ansible-collections/community.general/pull/7540).
- proxmox inventory plugin - adds an option to exclude nodes from the dynamic - proxmox inventory plugin - adds an option to exclude nodes from the dynamic
inventory generation. The new setting is optional, not using this option will inventory generation. The new setting is optional, not using this option
behave as usual (https://github.com/ansible-collections/community.general/issues/6714, will behave as usual (https://github.com/ansible-collections/community.general/issues/6714,
https://github.com/ansible-collections/community.general/pull/7461). https://github.com/ansible-collections/community.general/pull/7461).
- proxmox_disk - add ability to manipulate CD-ROM drive (https://github.com/ansible-collections/community.general/pull/7495). - proxmox_disk - add ability to manipulate CD-ROM drive (https://github.com/ansible-collections/community.general/pull/7495).
- proxmox_kvm - adds ``template`` value to the ``state`` parameter, allowing - proxmox_kvm - adds ``template`` value to the ``state`` parameter, allowing
@ -985,41 +999,43 @@ releases:
changes: changes:
bugfixes: bugfixes:
- keycloak_identity_provider - ``mappers`` processing was not idempotent if - keycloak_identity_provider - ``mappers`` processing was not idempotent if
the mappers configuration list had not been sorted by name (in ascending order). the mappers configuration list had not been sorted by name (in ascending
Fix resolves the issue by sorting mappers in the desired state using the same order). Fix resolves the issue by sorting mappers in the desired state using
key which is used for obtaining existing state (https://github.com/ansible-collections/community.general/pull/7418). the same key which is used for obtaining existing state (https://github.com/ansible-collections/community.general/pull/7418).
- keycloak_identity_provider - it was not possible to reconfigure (add, remove) - keycloak_identity_provider - it was not possible to reconfigure (add, remove)
``mappers`` once they were created initially. Removal was ignored, adding ``mappers`` once they were created initially. Removal was ignored, adding
new ones resulted in dropping the pre-existing unmodified mappers. Fix resolves new ones resulted in dropping the pre-existing unmodified mappers. Fix resolves
the issue by supplying correct input to the internal update call (https://github.com/ansible-collections/community.general/pull/7418). the issue by supplying correct input to the internal update call (https://github.com/ansible-collections/community.general/pull/7418).
- keycloak_user - when ``force`` is set, but user does not exist, do not try - keycloak_user - when ``force`` is set, but user does not exist, do not try
to delete it (https://github.com/ansible-collections/community.general/pull/7696). to delete it (https://github.com/ansible-collections/community.general/pull/7696).
- proxmox_kvm - running ``state=template`` will first check whether VM is already - proxmox_kvm - running ``state=template`` will first check whether VM is
a template (https://github.com/ansible-collections/community.general/pull/7792). already a template (https://github.com/ansible-collections/community.general/pull/7792).
- statusio_maintenance - fix error caused by incorrectly formed API data payload. - statusio_maintenance - fix error caused by incorrectly formed API data payload.
Was raising "Failed to create maintenance HTTP Error 400 Bad Request" caused Was raising "Failed to create maintenance HTTP Error 400 Bad Request" caused
by bad data type for date/time and deprecated dict keys (https://github.com/ansible-collections/community.general/pull/7754). by bad data type for date/time and deprecated dict keys (https://github.com/ansible-collections/community.general/pull/7754).
minor_changes: minor_changes:
- ipa_dnsrecord - adds ability to manage NS record types (https://github.com/ansible-collections/community.general/pull/7737). - ipa_dnsrecord - adds ability to manage NS record types (https://github.com/ansible-collections/community.general/pull/7737).
- ipa_pwpolicy - refactor module and exchange a sequence ``if`` statements with - ipa_pwpolicy - refactor module and exchange a sequence ``if`` statements
a ``for`` loop (https://github.com/ansible-collections/community.general/pull/7723). with a ``for`` loop (https://github.com/ansible-collections/community.general/pull/7723).
- ipa_pwpolicy - update module to support ``maxrepeat``, ``maxsequence``, ``dictcheck``, - ipa_pwpolicy - update module to support ``maxrepeat``, ``maxsequence``,
``usercheck``, ``gracelimit`` parameters in FreeIPA password policies (https://github.com/ansible-collections/community.general/pull/7723). ``dictcheck``, ``usercheck``, ``gracelimit`` parameters in FreeIPA password
policies (https://github.com/ansible-collections/community.general/pull/7723).
- keycloak_realm_key - the ``config.algorithm`` option now supports 8 additional - keycloak_realm_key - the ``config.algorithm`` option now supports 8 additional
key algorithms (https://github.com/ansible-collections/community.general/pull/7698). key algorithms (https://github.com/ansible-collections/community.general/pull/7698).
- keycloak_realm_key - the ``config.certificate`` option value is no longer - keycloak_realm_key - the ``config.certificate`` option value is no longer
defined with ``no_log=True`` (https://github.com/ansible-collections/community.general/pull/7698). defined with ``no_log=True`` (https://github.com/ansible-collections/community.general/pull/7698).
- keycloak_realm_key - the ``provider_id`` option now supports RSA encryption - keycloak_realm_key - the ``provider_id`` option now supports RSA encryption
key usage (value ``rsa-enc``) (https://github.com/ansible-collections/community.general/pull/7698). key usage (value ``rsa-enc``) (https://github.com/ansible-collections/community.general/pull/7698).
- keycloak_user_federation - allow custom user storage providers to be set through - keycloak_user_federation - allow custom user storage providers to be set
``provider_id`` (https://github.com/ansible-collections/community.general/pull/7789). through ``provider_id`` (https://github.com/ansible-collections/community.general/pull/7789).
- mail - add ``Message-ID`` header; which is required by some mail servers (https://github.com/ansible-collections/community.general/pull/7740). - mail - add ``Message-ID`` header; which is required by some mail servers
(https://github.com/ansible-collections/community.general/pull/7740).
- mail module, mail callback plugin - allow to configure the domain name of - mail module, mail callback plugin - allow to configure the domain name of
the Message-ID header with a new ``message_id_domain`` option (https://github.com/ansible-collections/community.general/pull/7765). the Message-ID header with a new ``message_id_domain`` option (https://github.com/ansible-collections/community.general/pull/7765).
- ssh_config - new feature to set ``AddKeysToAgent`` option to ``yes`` or ``no`` - ssh_config - new feature to set ``AddKeysToAgent`` option to ``yes`` or
(https://github.com/ansible-collections/community.general/pull/7703). ``no`` (https://github.com/ansible-collections/community.general/pull/7703).
- ssh_config - new feature to set ``IdentitiesOnly`` option to ``yes`` or ``no`` - ssh_config - new feature to set ``IdentitiesOnly`` option to ``yes`` or
(https://github.com/ansible-collections/community.general/pull/7704). ``no`` (https://github.com/ansible-collections/community.general/pull/7704).
- xcc_redfish_command - added support for raw POSTs (``command=PostResource`` - xcc_redfish_command - added support for raw POSTs (``command=PostResource``
in ``category=Raw``) without a specific action info (https://github.com/ansible-collections/community.general/pull/7746). in ``category=Raw``) without a specific action info (https://github.com/ansible-collections/community.general/pull/7746).
release_summary: Regular bugfix and feature release. release_summary: Regular bugfix and feature release.
@ -1075,12 +1091,12 @@ releases:
8.3.0: 8.3.0:
changes: changes:
bugfixes: bugfixes:
- homebrew - detect already installed formulae and casks using JSON output from - homebrew - detect already installed formulae and casks using JSON output
``brew info`` (https://github.com/ansible-collections/community.general/issues/864). from ``brew info`` (https://github.com/ansible-collections/community.general/issues/864).
- incus connection plugin - treats ``inventory_hostname`` as a variable instead - incus connection plugin - treats ``inventory_hostname`` as a variable instead
of a literal in remote connections (https://github.com/ansible-collections/community.general/issues/7874). of a literal in remote connections (https://github.com/ansible-collections/community.general/issues/7874).
- ipa_otptoken - the module expect ``ipatokendisabled`` as string but the ``ipatokendisabled`` - ipa_otptoken - the module expect ``ipatokendisabled`` as string but the
value is returned as a boolean (https://github.com/ansible-collections/community.general/pull/7795). ``ipatokendisabled`` value is returned as a boolean (https://github.com/ansible-collections/community.general/pull/7795).
- ldap - previously the order number (if present) was expected to follow an - ldap - previously the order number (if present) was expected to follow an
equals sign in the DN. This makes it so the order number string is identified equals sign in the DN. This makes it so the order number string is identified
correctly anywhere within the DN (https://github.com/ansible-collections/community.general/issues/7646). correctly anywhere within the DN (https://github.com/ansible-collections/community.general/issues/7646).
@ -1100,15 +1116,16 @@ releases:
- consul_policy, consul_role, consul_session - removed dependency on ``requests`` - consul_policy, consul_role, consul_session - removed dependency on ``requests``
and factored out common parts (https://github.com/ansible-collections/community.general/pull/7826, and factored out common parts (https://github.com/ansible-collections/community.general/pull/7826,
https://github.com/ansible-collections/community.general/pull/7878). https://github.com/ansible-collections/community.general/pull/7878).
- consul_role - ``node_identities`` now expects a ``node_name`` option to match - consul_role - ``node_identities`` now expects a ``node_name`` option to
the Consul API, the old ``name`` is still supported as alias (https://github.com/ansible-collections/community.general/pull/7878). match the Consul API, the old ``name`` is still supported as alias (https://github.com/ansible-collections/community.general/pull/7878).
- consul_role - ``service_identities`` now expects a ``service_name`` option - consul_role - ``service_identities`` now expects a ``service_name`` option
to match the Consul API, the old ``name`` is still supported as alias (https://github.com/ansible-collections/community.general/pull/7878). to match the Consul API, the old ``name`` is still supported as alias (https://github.com/ansible-collections/community.general/pull/7878).
- consul_role - added support for diff mode (https://github.com/ansible-collections/community.general/pull/7878). - consul_role - added support for diff mode (https://github.com/ansible-collections/community.general/pull/7878).
- consul_role - added support for templated policies (https://github.com/ansible-collections/community.general/pull/7878). - consul_role - added support for templated policies (https://github.com/ansible-collections/community.general/pull/7878).
- redfish_info - add command ``GetServiceIdentification`` to get service identification - redfish_info - add command ``GetServiceIdentification`` to get service identification
(https://github.com/ansible-collections/community.general/issues/7882). (https://github.com/ansible-collections/community.general/issues/7882).
- terraform - add support for ``diff_mode`` for terraform resource_changes (https://github.com/ansible-collections/community.general/pull/7896). - terraform - add support for ``diff_mode`` for terraform resource_changes
(https://github.com/ansible-collections/community.general/pull/7896).
release_summary: Regular bugfix and feature release. release_summary: Regular bugfix and feature release.
fragments: fragments:
- 7389-nmcli-issue-with-creating-a-wifi-bridge-slave.yml - 7389-nmcli-issue-with-creating-a-wifi-bridge-slave.yml
@ -1137,7 +1154,8 @@ releases:
- description: Manipulate Consul tokens - description: Manipulate Consul tokens
name: consul_token name: consul_token
namespace: '' namespace: ''
- description: Creates/updates/deletes GitLab Labels belonging to project or group. - description: Creates/updates/deletes GitLab Labels belonging to project or
group.
name: gitlab_label name: gitlab_label
namespace: '' namespace: ''
- description: Creates/updates/deletes GitLab Milestones belonging to project - description: Creates/updates/deletes GitLab Milestones belonging to project
@ -1149,50 +1167,50 @@ releases:
changes: changes:
bugfixes: bugfixes:
- 'cargo - fix idempotency issues when using a custom installation path for - 'cargo - fix idempotency issues when using a custom installation path for
packages (using the ``--path`` parameter). The initial installation runs fine, packages (using the ``--path`` parameter). The initial installation runs
but subsequent runs use the ``get_installed()`` function which did not check fine, but subsequent runs use the ``get_installed()`` function which did
the given installation location, before running ``cargo install``. This resulted not check the given installation location, before running ``cargo install``.
in a false ``changed`` state. Also the removal of packeges using ``state: This resulted in a false ``changed`` state. Also the removal of packeges
absent`` failed, as the installation check did not use the given parameter using ``state: absent`` failed, as the installation check did not use the
(https://github.com/ansible-collections/community.general/pull/7970).' given parameter (https://github.com/ansible-collections/community.general/pull/7970).'
- gitlab_issue - fix behavior to search GitLab issue, using ``search`` keyword - gitlab_issue - fix behavior to search GitLab issue, using ``search`` keyword
instead of ``title`` (https://github.com/ansible-collections/community.general/issues/7846). instead of ``title`` (https://github.com/ansible-collections/community.general/issues/7846).
- gitlab_runner - fix pagination when checking for existing runners (https://github.com/ansible-collections/community.general/pull/7790). - gitlab_runner - fix pagination when checking for existing runners (https://github.com/ansible-collections/community.general/pull/7790).
- keycloak_client - fixes issue when metadata is provided in desired state when - keycloak_client - fixes issue when metadata is provided in desired state
task is in check mode (https://github.com/ansible-collections/community.general/issues/1226, when task is in check mode (https://github.com/ansible-collections/community.general/issues/1226,
https://github.com/ansible-collections/community.general/pull/7881). https://github.com/ansible-collections/community.general/pull/7881).
- modprobe - listing modules files or modprobe files could trigger a FileNotFoundError - modprobe - listing modules files or modprobe files could trigger a FileNotFoundError
if ``/etc/modprobe.d`` or ``/etc/modules-load.d`` did not exist. Relevant if ``/etc/modprobe.d`` or ``/etc/modules-load.d`` did not exist. Relevant
functions now return empty lists if the directories do not exist to avoid functions now return empty lists if the directories do not exist to avoid
crashing the module (https://github.com/ansible-collections/community.general/issues/7717). crashing the module (https://github.com/ansible-collections/community.general/issues/7717).
- onepassword lookup plugin - failed for fields that were in sections and had - onepassword lookup plugin - failed for fields that were in sections and
uppercase letters in the label/ID. Field lookups are now case insensitive had uppercase letters in the label/ID. Field lookups are now case insensitive
in all cases (https://github.com/ansible-collections/community.general/pull/7919). in all cases (https://github.com/ansible-collections/community.general/pull/7919).
- pkgin - pkgin (pkgsrc package manager used by SmartOS) raises erratic exceptions - pkgin - pkgin (pkgsrc package manager used by SmartOS) raises erratic exceptions
and spurious ``changed=true`` (https://github.com/ansible-collections/community.general/pull/7971). and spurious ``changed=true`` (https://github.com/ansible-collections/community.general/pull/7971).
- redfish_info - allow for a GET operation invoked by ``GetUpdateStatus`` to - redfish_info - allow for a GET operation invoked by ``GetUpdateStatus``
allow for an empty response body for cases where a service returns 204 No to allow for an empty response body for cases where a service returns 204
Content (https://github.com/ansible-collections/community.general/issues/8003). No Content (https://github.com/ansible-collections/community.general/issues/8003).
- redfish_info - correct uncaught exception when attempting to retrieve ``Chassis`` - redfish_info - correct uncaught exception when attempting to retrieve ``Chassis``
information (https://github.com/ansible-collections/community.general/pull/7952). information (https://github.com/ansible-collections/community.general/pull/7952).
minor_changes: minor_changes:
- bitwarden lookup plugin - add ``bw_session`` option, to pass session key instead - bitwarden lookup plugin - add ``bw_session`` option, to pass session key
of reading from env (https://github.com/ansible-collections/community.general/pull/7994). instead of reading from env (https://github.com/ansible-collections/community.general/pull/7994).
- gitlab_deploy_key, gitlab_group_members, gitlab_group_variable, gitlab_hook, - gitlab_deploy_key, gitlab_group_members, gitlab_group_variable, gitlab_hook,
gitlab_instance_variable, gitlab_project_badge, gitlab_project_variable, gitlab_user gitlab_instance_variable, gitlab_project_badge, gitlab_project_variable,
- improve API pagination and compatibility with different versions of ``python-gitlab`` gitlab_user - improve API pagination and compatibility with different versions
(https://github.com/ansible-collections/community.general/pull/7790). of ``python-gitlab`` (https://github.com/ansible-collections/community.general/pull/7790).
- gitlab_hook - adds ``releases_events`` parameter for supporting Releases events - gitlab_hook - adds ``releases_events`` parameter for supporting Releases
triggers on GitLab hooks (https://github.com/ansible-collections/community.general/pull/7956). events triggers on GitLab hooks (https://github.com/ansible-collections/community.general/pull/7956).
- icinga2 inventory plugin - add Jinja2 templating support to ``url``, ``user``, - icinga2 inventory plugin - add Jinja2 templating support to ``url``, ``user``,
and ``password`` paramenters (https://github.com/ansible-collections/community.general/issues/7074, and ``password`` paramenters (https://github.com/ansible-collections/community.general/issues/7074,
https://github.com/ansible-collections/community.general/pull/7996). https://github.com/ansible-collections/community.general/pull/7996).
- mssql_script - adds transactional (rollback/commit) support via optional boolean - mssql_script - adds transactional (rollback/commit) support via optional
param ``transaction`` (https://github.com/ansible-collections/community.general/pull/7976). boolean param ``transaction`` (https://github.com/ansible-collections/community.general/pull/7976).
- proxmox_kvm - add parameter ``update_unsafe`` to avoid limitations when updating - proxmox_kvm - add parameter ``update_unsafe`` to avoid limitations when
dangerous values (https://github.com/ansible-collections/community.general/pull/7843). updating dangerous values (https://github.com/ansible-collections/community.general/pull/7843).
- redfish_config - add command ``SetServiceIdentification`` to set service identification - redfish_config - add command ``SetServiceIdentification`` to set service
(https://github.com/ansible-collections/community.general/issues/7916). identification (https://github.com/ansible-collections/community.general/issues/7916).
- sudoers - add support for the ``NOEXEC`` tag in sudoers rules (https://github.com/ansible-collections/community.general/pull/7983). - sudoers - add support for the ``NOEXEC`` tag in sudoers rules (https://github.com/ansible-collections/community.general/pull/7983).
- terraform - fix ``diff_mode`` in state ``absent`` and when terraform ``resource_changes`` - terraform - fix ``diff_mode`` in state ``absent`` and when terraform ``resource_changes``
does not exist (https://github.com/ansible-collections/community.general/pull/7963). does not exist (https://github.com/ansible-collections/community.general/pull/7963).
@ -1264,35 +1282,37 @@ releases:
mode (https://github.com/ansible-collections/community.general/pull/8081). mode (https://github.com/ansible-collections/community.general/pull/8081).
- pam_limits - when the file does not exist, do not create it in check mode - pam_limits - when the file does not exist, do not create it in check mode
(https://github.com/ansible-collections/community.general/issues/8050, https://github.com/ansible-collections/community.general/pull/8057). (https://github.com/ansible-collections/community.general/issues/8050, https://github.com/ansible-collections/community.general/pull/8057).
- proxmox_kvm - fixed status check getting from node-specific API endpoint (https://github.com/ansible-collections/community.general/issues/7817). - proxmox_kvm - fixed status check getting from node-specific API endpoint
(https://github.com/ansible-collections/community.general/issues/7817).
minor_changes: minor_changes:
- bitwarden lookup plugin - allows to fetch all records of a given collection - bitwarden lookup plugin - allows to fetch all records of a given collection
ID, by allowing to pass an empty value for ``search_value`` when ``collection_id`` ID, by allowing to pass an empty value for ``search_value`` when ``collection_id``
is provided (https://github.com/ansible-collections/community.general/pull/8013). is provided (https://github.com/ansible-collections/community.general/pull/8013).
- icinga2 inventory plugin - adds new parameter ``group_by_hostgroups`` in order - icinga2 inventory plugin - adds new parameter ``group_by_hostgroups`` in
to make grouping by Icinga2 hostgroups optional (https://github.com/ansible-collections/community.general/pull/7998). order to make grouping by Icinga2 hostgroups optional (https://github.com/ansible-collections/community.general/pull/7998).
- ini_file - support optional spaces between section names and their surrounding - ini_file - support optional spaces between section names and their surrounding
brackets (https://github.com/ansible-collections/community.general/pull/8075). brackets (https://github.com/ansible-collections/community.general/pull/8075).
- java_cert - enable ``owner``, ``group``, ``mode``, and other generic file - java_cert - enable ``owner``, ``group``, ``mode``, and other generic file
arguments (https://github.com/ansible-collections/community.general/pull/8116). arguments (https://github.com/ansible-collections/community.general/pull/8116).
- ldap_attrs - module now supports diff mode, showing which attributes are changed - ldap_attrs - module now supports diff mode, showing which attributes are
within an operation (https://github.com/ansible-collections/community.general/pull/8073). changed within an operation (https://github.com/ansible-collections/community.general/pull/8073).
- lxd_container - uses ``/1.0/instances`` API endpoint, if available. Falls - lxd_container - uses ``/1.0/instances`` API endpoint, if available. Falls
back to ``/1.0/containers`` or ``/1.0/virtual-machines``. Fixes issue when back to ``/1.0/containers`` or ``/1.0/virtual-machines``. Fixes issue when
using Incus or LXD 5.19 due to migrating to ``/1.0/instances`` endpoint (https://github.com/ansible-collections/community.general/pull/7980). using Incus or LXD 5.19 due to migrating to ``/1.0/instances`` endpoint
(https://github.com/ansible-collections/community.general/pull/7980).
- nmcli - allow setting ``MTU`` for ``bond-slave`` interface types (https://github.com/ansible-collections/community.general/pull/8118). - nmcli - allow setting ``MTU`` for ``bond-slave`` interface types (https://github.com/ansible-collections/community.general/pull/8118).
- proxmox - adds ``startup`` parameters to configure startup order, startup - proxmox - adds ``startup`` parameters to configure startup order, startup
delay and shutdown delay (https://github.com/ansible-collections/community.general/pull/8038). delay and shutdown delay (https://github.com/ansible-collections/community.general/pull/8038).
- revbitspss lookup plugin - removed a redundant unicode prefix. The prefix - revbitspss lookup plugin - removed a redundant unicode prefix. The prefix
was not necessary for Python 3 and has been cleaned up to streamline the code was not necessary for Python 3 and has been cleaned up to streamline the
(https://github.com/ansible-collections/community.general/pull/8087). code (https://github.com/ansible-collections/community.general/pull/8087).
release_summary: Regular feature and bugfix release with security fixes. release_summary: Regular feature and bugfix release with security fixes.
security_fixes: security_fixes:
- cobbler, gitlab_runners, icinga2, linode, lxd, nmap, online, opennebula, proxmox, - cobbler, gitlab_runners, icinga2, linode, lxd, nmap, online, opennebula,
scaleway, stackpath_compute, virtualbox, and xen_orchestra inventory plugin proxmox, scaleway, stackpath_compute, virtualbox, and xen_orchestra inventory
- make sure all data received from the remote servers is marked as unsafe, plugin - make sure all data received from the remote servers is marked as
so remote code execution by obtaining texts that can be evaluated as templates unsafe, so remote code execution by obtaining texts that can be evaluated
is not possible (https://www.die-welt.net/2024/03/remote-code-execution-in-ansible-dynamic-inventory-plugins/, as templates is not possible (https://www.die-welt.net/2024/03/remote-code-execution-in-ansible-dynamic-inventory-plugins/,
https://github.com/ansible-collections/community.general/pull/8098). https://github.com/ansible-collections/community.general/pull/8098).
fragments: fragments:
- 7880-ipa-fix-sudo-and-hbcalrule-idempotence.yml - 7880-ipa-fix-sudo-and-hbcalrule-idempotence.yml
@ -1330,24 +1350,24 @@ releases:
- bitwarden_secrets_manager lookup plugin - implements retry with exponential - bitwarden_secrets_manager lookup plugin - implements retry with exponential
backoff to avoid lookup errors when Bitwardn's API rate limiting is encountered backoff to avoid lookup errors when Bitwardn's API rate limiting is encountered
(https://github.com/ansible-collections/community.general/issues/8230, https://github.com/ansible-collections/community.general/pull/8238). (https://github.com/ansible-collections/community.general/issues/8230, https://github.com/ansible-collections/community.general/pull/8238).
- from_ini filter plugin - disabling interpolation of ``ConfigParser`` to allow - from_ini filter plugin - disabling interpolation of ``ConfigParser`` to
converting values with a ``%`` sign (https://github.com/ansible-collections/community.general/issues/8183, allow converting values with a ``%`` sign (https://github.com/ansible-collections/community.general/issues/8183,
https://github.com/ansible-collections/community.general/pull/8185). https://github.com/ansible-collections/community.general/pull/8185).
- gitlab_issue, gitlab_label, gitlab_milestone - avoid crash during version - gitlab_issue, gitlab_label, gitlab_milestone - avoid crash during version
comparison when the python-gitlab Python module is not installed (https://github.com/ansible-collections/community.general/pull/8158). comparison when the python-gitlab Python module is not installed (https://github.com/ansible-collections/community.general/pull/8158).
- haproxy - fix an issue where HAProxy could get stuck in DRAIN mode when the - haproxy - fix an issue where HAProxy could get stuck in DRAIN mode when
backend was unreachable (https://github.com/ansible-collections/community.general/issues/8092). the backend was unreachable (https://github.com/ansible-collections/community.general/issues/8092).
- inventory plugins - add unsafe wrapper to avoid marking strings that do not - inventory plugins - add unsafe wrapper to avoid marking strings that do
contain ``{`` or ``}`` as unsafe, to work around a bug in AWX ((https://github.com/ansible-collections/community.general/issues/8212, not contain ``{`` or ``}`` as unsafe, to work around a bug in AWX ((https://github.com/ansible-collections/community.general/issues/8212,
https://github.com/ansible-collections/community.general/pull/8225). https://github.com/ansible-collections/community.general/pull/8225).
- ipa - fix get version regex in IPA module_utils (https://github.com/ansible-collections/community.general/pull/8175). - ipa - fix get version regex in IPA module_utils (https://github.com/ansible-collections/community.general/pull/8175).
- keycloak_client - add sorted ``defaultClientScopes`` and ``optionalClientScopes`` - keycloak_client - add sorted ``defaultClientScopes`` and ``optionalClientScopes``
to normalizations (https://github.com/ansible-collections/community.general/pull/8223). to normalizations (https://github.com/ansible-collections/community.general/pull/8223).
- keycloak_realm - add normalizations for ``enabledEventTypes`` and ``supportedLocales`` - keycloak_realm - add normalizations for ``enabledEventTypes`` and ``supportedLocales``
(https://github.com/ansible-collections/community.general/pull/8224). (https://github.com/ansible-collections/community.general/pull/8224).
- puppet - add option ``environment_lang`` to set the environment language encoding. - puppet - add option ``environment_lang`` to set the environment language
Defaults to lang ``C``. It is recommended to set it to ``C.UTF-8`` or ``en_US.UTF-8`` encoding. Defaults to lang ``C``. It is recommended to set it to ``C.UTF-8``
depending on what is available on your system. (https://github.com/ansible-collections/community.general/issues/8000) or ``en_US.UTF-8`` depending on what is available on your system. (https://github.com/ansible-collections/community.general/issues/8000)
- riak - support ``riak admin`` sub-command in newer Riak KV versions beside - riak - support ``riak admin`` sub-command in newer Riak KV versions beside
the legacy ``riak-admin`` main command (https://github.com/ansible-collections/community.general/pull/8211). the legacy ``riak-admin`` main command (https://github.com/ansible-collections/community.general/pull/8211).
- to_ini filter plugin - disabling interpolation of ``ConfigParser`` to allow - to_ini filter plugin - disabling interpolation of ``ConfigParser`` to allow
@ -1356,34 +1376,35 @@ releases:
- xml - make module work with lxml 5.1.1, which removed some internals that - xml - make module work with lxml 5.1.1, which removed some internals that
the module was relying on (https://github.com/ansible-collections/community.general/pull/8169). the module was relying on (https://github.com/ansible-collections/community.general/pull/8169).
deprecated_features: deprecated_features:
- hipchat callback plugin - the hipchat service has been discontinued and the - hipchat callback plugin - the hipchat service has been discontinued and
self-hosted variant has been End of Life since 2020. The callback plugin is the self-hosted variant has been End of Life since 2020. The callback plugin
therefore deprecated and will be removed from community.general 10.0.0 if is therefore deprecated and will be removed from community.general 10.0.0
nobody provides compelling reasons to still keep it (https://github.com/ansible-collections/community.general/issues/8184, if nobody provides compelling reasons to still keep it (https://github.com/ansible-collections/community.general/issues/8184,
https://github.com/ansible-collections/community.general/pull/8189). https://github.com/ansible-collections/community.general/pull/8189).
minor_changes: minor_changes:
- Use offset-aware ``datetime.datetime`` objects (with timezone UTC) instead - Use offset-aware ``datetime.datetime`` objects (with timezone UTC) instead
of offset-naive UTC timestamps, which are deprecated in Python 3.12 (https://github.com/ansible-collections/community.general/pull/8222). of offset-naive UTC timestamps, which are deprecated in Python 3.12 (https://github.com/ansible-collections/community.general/pull/8222).
- 'apt_rpm - add new states ``latest`` and ``present_not_latest``. The value - 'apt_rpm - add new states ``latest`` and ``present_not_latest``. The value
``latest`` is equivalent to the current behavior of ``present``, which will ``latest`` is equivalent to the current behavior of ``present``, which will
upgrade a package if a newer version exists. ``present_not_latest`` does what upgrade a package if a newer version exists. ``present_not_latest`` does
most users would expect ``present`` to do: it does not upgrade if the package what most users would expect ``present`` to do: it does not upgrade if the
is already installed. The current behavior of ``present`` will be deprecated package is already installed. The current behavior of ``present`` will be
in a later version, and eventually changed to that of ``present_not_latest`` deprecated in a later version, and eventually changed to that of ``present_not_latest``
(https://github.com/ansible-collections/community.general/issues/8217, https://github.com/ansible-collections/community.general/pull/8247).' (https://github.com/ansible-collections/community.general/issues/8217, https://github.com/ansible-collections/community.general/pull/8247).'
- bitwarden lookup plugin - add support to filter by organization ID (https://github.com/ansible-collections/community.general/pull/8188). - bitwarden lookup plugin - add support to filter by organization ID (https://github.com/ansible-collections/community.general/pull/8188).
- filesystem - add bcachefs support (https://github.com/ansible-collections/community.general/pull/8126). - filesystem - add bcachefs support (https://github.com/ansible-collections/community.general/pull/8126).
- ini_file - add an optional parameter ``section_has_values``. If the target - ini_file - add an optional parameter ``section_has_values``. If the target
ini file contains more than one ``section``, use ``section_has_values`` to ini file contains more than one ``section``, use ``section_has_values``
specify which one should be updated (https://github.com/ansible-collections/community.general/pull/7505). to specify which one should be updated (https://github.com/ansible-collections/community.general/pull/7505).
- java_cert - add ``cert_content`` argument (https://github.com/ansible-collections/community.general/pull/8153). - java_cert - add ``cert_content`` argument (https://github.com/ansible-collections/community.general/pull/8153).
- keycloak_client, keycloak_clientscope, keycloak_clienttemplate - added ``docker-v2`` - keycloak_client, keycloak_clientscope, keycloak_clienttemplate - added ``docker-v2``
protocol support, enhancing alignment with Keycloak's protocol options (https://github.com/ansible-collections/community.general/issues/8215, protocol support, enhancing alignment with Keycloak's protocol options (https://github.com/ansible-collections/community.general/issues/8215,
https://github.com/ansible-collections/community.general/pull/8216). https://github.com/ansible-collections/community.general/pull/8216).
- nmcli - adds OpenvSwitch support with new ``type`` values ``ovs-port``, ``ovs-interface``, - nmcli - adds OpenvSwitch support with new ``type`` values ``ovs-port``,
and ``ovs-bridge``, and new ``slave_type`` value ``ovs-port`` (https://github.com/ansible-collections/community.general/pull/8154). ``ovs-interface``, and ``ovs-bridge``, and new ``slave_type`` value ``ovs-port``
- osx_defaults - add option ``check_types`` to enable changing the type of existing (https://github.com/ansible-collections/community.general/pull/8154).
defaults on the fly (https://github.com/ansible-collections/community.general/pull/8173). - osx_defaults - add option ``check_types`` to enable changing the type of
existing defaults on the fly (https://github.com/ansible-collections/community.general/pull/8173).
- passwordstore lookup - add ``missing_subkey`` parameter defining the behavior - passwordstore lookup - add ``missing_subkey`` parameter defining the behavior
of the lookup when a passwordstore subkey is missing (https://github.com/ansible-collections/community.general/pull/8166). of the lookup when a passwordstore subkey is missing (https://github.com/ansible-collections/community.general/pull/8166).
- portage - adds the possibility to explicitely tell portage to write packages - portage - adds the possibility to explicitely tell portage to write packages
@ -1468,20 +1489,20 @@ releases:
- keycloak_realm - add normalizations for ``attributes`` and ``protocol_mappers`` - keycloak_realm - add normalizations for ``attributes`` and ``protocol_mappers``
(https://github.com/ansible-collections/community.general/pull/8496). (https://github.com/ansible-collections/community.general/pull/8496).
- launched - correctly report changed status in check mode (https://github.com/ansible-collections/community.general/pull/8406). - launched - correctly report changed status in check mode (https://github.com/ansible-collections/community.general/pull/8406).
- opennebula inventory plugin - fix invalid reference to IP when inventory runs - opennebula inventory plugin - fix invalid reference to IP when inventory
against NICs with no IPv4 address (https://github.com/ansible-collections/community.general/pull/8489). runs against NICs with no IPv4 address (https://github.com/ansible-collections/community.general/pull/8489).
- opentelemetry callback - do not save the JSON response when using the ``ansible.builtin.uri`` - opentelemetry callback - do not save the JSON response when using the ``ansible.builtin.uri``
module (https://github.com/ansible-collections/community.general/pull/8430). module (https://github.com/ansible-collections/community.general/pull/8430).
- opentelemetry callback - do not save the content response when using the ``ansible.builtin.slurp`` - opentelemetry callback - do not save the content response when using the
module (https://github.com/ansible-collections/community.general/pull/8430). ``ansible.builtin.slurp`` module (https://github.com/ansible-collections/community.general/pull/8430).
- paman - do not fail if an empty list of packages has been provided and there - paman - do not fail if an empty list of packages has been provided and there
is nothing to do (https://github.com/ansible-collections/community.general/pull/8514). is nothing to do (https://github.com/ansible-collections/community.general/pull/8514).
known_issues: known_issues:
- homectl - the module does not work under Python 3.13 or newer, since it relies - homectl - the module does not work under Python 3.13 or newer, since it
on the removed ``crypt`` standard library module (https://github.com/ansible-collections/community.general/issues/4691, relies on the removed ``crypt`` standard library module (https://github.com/ansible-collections/community.general/issues/4691,
https://github.com/ansible-collections/community.general/pull/8497). https://github.com/ansible-collections/community.general/pull/8497).
- udm_user - the module does not work under Python 3.13 or newer, since it relies - udm_user - the module does not work under Python 3.13 or newer, since it
on the removed ``crypt`` standard library module (https://github.com/ansible-collections/community.general/issues/4690, relies on the removed ``crypt`` standard library module (https://github.com/ansible-collections/community.general/issues/4690,
https://github.com/ansible-collections/community.general/pull/8497). https://github.com/ansible-collections/community.general/pull/8497).
release_summary: Regular bugfix release. release_summary: Regular bugfix release.
fragments: fragments:

View file

@ -38,3 +38,5 @@ title: Community General
trivial_section_name: trivial trivial_section_name: trivial
use_fqcn: true use_fqcn: true
add_plugin_period: true add_plugin_period: true
changelog_nice_yaml: true
changelog_sort: version