Introduction
community.general is one of the largest collections shipped as part of the Ansible community package. It bundles modules, lookup plugins, callback plugins, and inventory plugins that do not have a dedicated collection of their own, covering areas such as GitLab/GitHub automation, LDAP, Consul, LVM, logrotate, and various callback plugins used for logging and observability. Version 13.5.0 has just been published on Galaxy, updating from 13.4.0.
This is a regular bugfix and feature release, not a major version bump, so no breaking changes are expected. The changelog lists a long set of minor changes across lookup plugins, callback plugins, and modules.
Whats New
Callback plugins - secrets redaction on ansible-core 2.22+
Several callback plugins have been updated to redact sensitive output when running on ansible-core 2.22 and newer, taking advantage of the new secrets API:
elasticcallback plugin - redact sensitive output on ansible-core 2.22+ (also received an internal refactor with no visible behavior changes).jabbercallback plugin - redact sensitive output on ansible-core 2.22+.log_playscallback plugin - redact sensitive output on ansible-core 2.22+.loganalyticscallback plugin - redact sensitive output on ansible-core 2.22+.loganalytics_ingestioncallback plugin - refactored to use ansible-core 2.22's new secrets API to properly mark and mask secrets.logstashcallback plugin - redact sensitive output on ansible-core 2.22+.
Lookup plugins
consul_kvlookup plugin - no longer requires thepy-consulPython library; it now usesansible.module_utils.urls.open_urldirectly.etcd3lookup plugin - changed the type of theca_cert,cert_cert, andcert_keyoptions from string to path, since they specify paths to certificates/keys.github_app_access_tokenlookup plugin - addedclient_idas an alias forapp_idso the GitHub App's client ID can be specified without using a confusing option name.
Modules and module updates
cloudflare_dns- added diff mode support.composer- composer's own warning about running as root/super user is now relayed as an Ansible warning.github_secrets- added support for managing repository environment secrets.github_secrets_info- added support for listing repository environment secrets.gitlab_group- added a newunchangedvalue for thevisibilityparameter.gitlab_issue- addedallas a valid value for thestate_filterparameter.gitlab_project- addedarchivedandunarchivedvalues forstate.ldap_*modules - added support for specifying a SASL authorization identity (equivalent to the-X 'dn:...'flag).logrotate- added diff mode support, showing before/after content of the configuration file when running with--diff; also refactored internally without changing functionality.lvm_pv- addedzero,metadatasize,dataalignment, and related options (see the upstream changelog for the full parameter list, as the entry was still being expanded at release time).
Summary table
| Area | Plugin/Module | Change |
|---|---|---|
| Callback | elastic | Secrets redaction on ansible-core 2.22+ |
| Callback | jabber | Secrets redaction on ansible-core 2.22+ |
| Callback | log_plays | Secrets redaction on ansible-core 2.22+ |
| Callback | loganalytics | Secrets redaction on ansible-core 2.22+ |
| Callback | loganalytics_ingestion | Refactor to new secrets API |
| Callback | logstash | Secrets redaction on ansible-core 2.22+ |
| Lookup | consul_kv | Drops py-consul dependency |
| Lookup | etcd3 | Cert options changed to path type |
| Lookup | github_app_access_token | client_id alias added |
| Module | cloudflare_dns | Diff mode support |
| Module | composer | Root-user warning relayed to Ansible |
| Module | github_secrets / github_secrets_info | Environment secrets support |
| Module | gitlab_group | New unchanged visibility value |
| Module | gitlab_issue | state_filter=all supported |
| Module | gitlab_project | archived/unarchived state values |
| Module | ldap_* | SASL authorization identity support |
| Module | logrotate | Diff mode support, internal refactor |
| Module | lvm_pv | New size/alignment options |
How to Install and Verify
The collection can be installed or upgraded through ansible-galaxy:
# Install or upgrade community.general to the latest version
ansible-galaxy collection install community.general --upgrade
# Install the exact version 13.5.0
ansible-galaxy collection install community.general:==13.5.0
# Verify the installed version
ansible-galaxy collection list community.general
If the collection is managed through a requirements.yml file, update the pinned version accordingly:
collections:
- name: community.general
version: "13.5.0"
Then reinstall with:
ansible-galaxy collection install -r requirements.yml --force
Conclusion
community.general 13.5.0 is a routine bugfix and feature release that touches callback plugins, lookup plugins, and several GitLab/GitHub, LDAP, and system modules. There are no reported breaking changes, so upgrading from 13.4.0 should be safe for most playbooks. Users relying on the affected callback plugins on ansible-core 2.22+ will benefit from improved secrets redaction, while users of cloudflare_dns and logrotate gain diff mode support.