CHANGELOG.rst

Community Sops Release Notes

Topics

• v1.6.7
  • Release Summary
  • Bugfixes
• v1.6.6
  • Release Summary
  • Bugfixes
• v1.6.5
  • Release Summary
  • Bugfixes
• v1.6.4
  • Release Summary
  • Bugfixes
• v1.6.3
  • Release Summary
  • Known Issues
• v1.6.2
  • Release Summary
  • Bugfixes
• v1.6.1
  • Release Summary
  • Bugfixes
• v1.6.0
  • Release Summary
  • Minor Changes
• v1.5.0
  • Release Summary
  • Minor Changes
  • New Playbooks
  • New Roles
• v1.4.1
  • Release Summary
  • Bugfixes
• v1.4.0
  • Release Summary
  • Minor Changes
• v1.3.0
  • Release Summary
  • Minor Changes
• v1.2.3
  • Release Summary
• v1.2.2
  • Release Summary
  • Bugfixes
• v1.2.1
  • Release Summary
• v1.2.0
  • Release Summary
  • Minor Changes
  • Bugfixes
• v1.1.0
  • Release Summary
  • Minor Changes
  • New Plugins
    • Filter
• v1.0.6
  • Release Summary
  • Bugfixes
• v1.0.5
  • Release Summary
  • Bugfixes
• v1.0.4
  • Release Summary
  • Security Fixes
• v1.0.3
  • Release Summary
  • Bugfixes
• v1.0.2
  • Release Summary
• v1.0.1
  • Release Summary
• v1.0.0
  • Release Summary
  • Minor Changes
• v0.2.0
  • Release Summary
  • Minor Changes
• v0.1.0
  • Release Summary
  • New Plugins
    • Lookup
    • Vars
  • New Modules

v1.6.7

Release Summary

Bugfix release.

Bugfixes

• sops_encrypt - ensure that output-type is set to yaml when the file extension .yml is used. Now both .yaml and .yml files use the SOPS --output-type=yaml formatting (ansible-collections#164).

v1.6.6

Release Summary

Make fully compatible with and test against sops 3.8.0.

Bugfixes

• Fix RPM URL for the 3.8.0 release (ansible-collections#161).

v1.6.5

Release Summary

Make compatible with and test against sops 3.8.0-rc.1.

Bugfixes

• Avoid pre-releases when picking the latest version when using the GitHub API method (ansible-collections#159).
• Fix changed DEB and RPM URLs for 3.8.0 and its prerelease(s) (ansible-collections#159).

v1.6.4

Release Summary

Maintenance/bugfix release for the move of sops to the new getsops GitHub organization.

Bugfixes

• install role - fix sops_github_latest_detection=latest-release, which broke due to sops moving to another GitHub organization (ansible-collections#151).

v1.6.3

Release Summary

Maintenance release with updated documentation.

From this version on, community.sops is using the new Ansible semantic markup in its documentation. If you look at documentation with the ansible-doc CLI tool from ansible-core before 2.15, please note that it does not render the markup correctly. You should be still able to read it in most cases, but you need ansible-core 2.15 or later to see it as it is intended. Alternatively you can look at the devel docsite for the rendered HTML version of the documentation of the latest release.

Known Issues

• 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 upgrade to ansible-core 2.15 (or newer), or read the HTML documentation on https://docs.ansible.com/ansible/devel/collections/community/sops/.

v1.6.2

Release Summary

Maintenance release.

Bugfixes

• install role - make sure that the pkg_mgr fact is definitely available when installing on localhost. This can improve error messages in some cases (ansible-collections#145, ansible-collections#146).

v1.6.1

Release Summary

Maintenance release.

Bugfixes

• action plugin helper - fix handling of deprecations for ansible-core 2.14.2 (ansible-collections#136).
• various plugins - remove unnecessary imports (ansible-collections#133).

v1.6.0

Release Summary

Feature release improving the installation role.

Minor Changes

• install role - add sops_github_latest_detection option that allows to configure which method to use for detecting the latest release on GitHub. By default (auto) first tries to retrieve a list of recent releases using the API, and if that fails due to rate limiting, tries to obtain the latest GitHub release from a semi-documented URL (ansible-collections#133).
• install role - add sops_github_token option to allow passing a GitHub token. This can for example be used to avoid rate limits when using the role in GitHub Actions (ansible-collections#132).
• install role - implement another method to determine the latest release on GitHub than using the GitHub API, which can make installation fail due to rate-limiting (ansible-collections#131).

v1.5.0

Release Summary

Feature release.

Minor Changes

• Automatically install GNU Privacy Guard (GPG) in execution environments. To install Mozilla sops a manual step needs to be added to the EE definition, see the collection's documentation for details (ansible-collections#98).

New Playbooks

• community.sops.install - Installs sops and GNU Privacy Guard on all remote hosts
• community.sops.install_localhost - Installs sops and GNU Privacy Guard on localhost

New Roles

• community.sops.install - Install Mozilla sops

v1.4.1

Release Summary

Maintenance release to improve compatibility with future ansible-core releases.

Bugfixes

• load_vars - ensure compatibility with newer versions of ansible-core (ansible-collections#121).

v1.4.0

Release Summary

Feature release.

Minor Changes

• Allow to specify age keys as age_key, or age keyfiles as age_keyfile (ansible-collections#116, ansible-collections#117).
• sops_encrypt - allow to specify age recipients (ansible-collections#116, ansible-collections#117).

v1.3.0

Release Summary

Feature release.

Minor Changes

• All software licenses are now in the LICENSES/ directory of the collection root, and the collection repository conforms to the REUSE specification except for the changelog fragments (https://github.com/ansible-collections/community.crypto/sops/108, ansible-collections#113).
• sops vars plugin - added a configuration option to temporarily disable the vars plugin (ansible-collections#114).

v1.2.3

Release Summary

Fix formatting bug in documentation. No code changes.

v1.2.2

Release Summary

Maintenance release.

Bugfixes

• Include simplified_bsd.txt license file for the sops module utils.

v1.2.1

Release Summary

Maintenance release with updated documentation.

v1.2.0

Release Summary

Collection release for inclusion in Ansible 4.9.0 and 5.1.0.

This release contains a change allowing to configure generic plugin options with ansible.cfg keys and env variables.

Minor Changes

• sops lookup and vars plugin - allow to configure almost all generic options by ansible.cfg entries and environment variables (ansible-collections#81).

Bugfixes

• Fix error handling in calls of the sops binary when negative errors are returned (ansible-collections#82, ansible-collections#83).

v1.1.0

Release Summary

A minor release for inclusion in Ansible 4.2.0.

Minor Changes

• Avoid internal ansible-core module_utils in favor of equivalent public API available since at least Ansible 2.9 (ansible-collections#73).

New Plugins

Filter

• community.sops.decrypt - Decrypt sops-encrypted data

v1.0.6

Release Summary

This release makes the collection compatible to the latest beta release of ansible-core 2.11.

Bugfixes

• action_module plugin helper - make compatible with latest changes in ansible-core 2.11.0b3 (ansible-collections#58).
• community.sops.load_vars - make compatible with latest changes in ansible-core 2.11.0b3 (ansible-collections#58).

v1.0.5

Release Summary

This release fixes a bug that prevented correct YAML file to be created when the output was ending in .yaml.

Bugfixes

• community.sops.sops_encrypt - use output type yaml when path ends with .yaml (ansible-collections#56).

v1.0.4

Release Summary

This is a security release, fixing a potential information leak in the community.sops.sops_encrypt module.

Security Fixes

• community.sops.sops_encrypt - mark the aws_secret_access_key and aws_session_token parameters as no_log to avoid leakage of secrets (ansible-collections#54).

v1.0.3

Release Summary

This release include some fixes to Ansible docs and required changes for inclusion in Ansible.

Bugfixes

• community.sops.sops lookup plugins - fix wrong format of Ansible variables so that these are actually used (ansible-collections#51).
• community.sops.sops vars plugins - remove non-working Ansible variables (ansible-collections#51).

v1.0.2

Release Summary

Fix of 1.0.1 release which had no changelog entry.

v1.0.1

Release Summary

Re-release of 1.0.0 to counteract error during release.

v1.0.0

Release Summary

First stable release. This release is expected to be included in Ansible 3.0.0.

Minor Changes

• All plugins and modules: allow to pass generic sops options with new options config_path, enable_local_keyservice, keyservice. Also allow to pass AWS parameters with options aws_profile, aws_access_key_id, aws_secret_access_key, and aws_session_token (ansible-collections#47).
• community.sops.sops_encrypt - allow to pass encryption-specific options kms, gcp_kms, azure_kv, hc_vault_transit, pgp, unencrypted_suffix, encrypted_suffix, unencrypted_regex, encrypted_regex, encryption_context, and shamir_secret_sharing_threshold to sops (ansible-collections#47).

v0.2.0

Release Summary

This release adds features for the lookup and vars plugins.

Minor Changes

• community.sops.sops lookup plugin - add empty_on_not_exist option which allows to return an empty string instead of an error when the file does not exist (ansible-collections#33).
• community.sops.sops vars plugin - add option to control caching (ansible-collections#32).
• community.sops.sops vars plugin - add option to determine when vars are loaded (ansible-collections#32).

v0.1.0

Release Summary

First release of the community.sops collection! This release includes multiple plugins: an action plugin, a lookup plugin and a vars plugin.

New Plugins

Lookup

• community.sops.sops - Read sops encrypted file contents

Vars

• community.sops.sops - Loading sops-encrypted vars files

New Modules

• community.sops.load_vars - Load sops-encrypted variables from files, dynamically within a task
• community.sops.sops_encrypt - Encrypt data with sops