CHANGELOG.rst

Kubernetes Collection Release Notes

Topics

• v2.1.1
  • Bugfixes
• v2.1.0
  • Minor Changes
• v2.0.2
  • Bugfixes
• v2.0.1
  • Bugfixes
• v2.0.0
  • Major Changes
  • Minor Changes
  • Breaking Changes / Porting Guide
  • Bugfixes
  • New Modules
• v1.2.0
  • Minor Changes
  • Bugfixes
• v1.1.1
  • Bugfixes
• v1.1.0
  • Major Changes
  • Minor Changes
  • Bugfixes
• v1.0.0
  • Major Changes
  • Minor Changes
  • Security Fixes
  • Bugfixes
  • New Modules
• v0.11.1
  • Major Changes
  • Minor Changes
  • Bugfixes
• v0.11.0
  • Major Changes
  • Minor Changes
  • Bugfixes
  • New Modules
• v0.10.0
  • Major Changes
  • Minor Changes
  • Security Fixes
  • Bugfixes
  • New Modules
• v0.9.0
  • Major Changes

v2.1.1

Bugfixes

• check auth params for existence, not whether they are true (ansible-collections#151).

v2.1.0

Minor Changes

• remove cloud.common as default dependency (ansible-collections#148).
• temporarily disable turbo mode (ansible-collections#149).

v2.0.2

Bugfixes

• Fix apply for k8s module when an array attribute from definition contains empty dict (ansible-collections#113).
• rename the apply function to fix broken imports in Ansible 2.9 (ansible-collections#135).

v2.0.1

Bugfixes

• inventory - add community.kubernetes to list of plugin choices in k8s inventory (ansible-collections#128).

v2.0.0

Major Changes

• k8s - deprecate merge_type=json. The JSON patch functionality has never worked (ansible-collections#99).
• k8s_json_patch - split JSON patch functionality out into a separate module (ansible-collections#99).
• replaces the openshift client with the official kubernetes client (ansible-collections#34).

Minor Changes

• Add cache_file when DynamicClient is created (ansible-collections#46).
• Add configmap and secret hash functionality (ansible-collections#48).
• Add logic for cache file name generation (ansible-collections#46).
• Replicate apply method in the DynamicClient (ansible-collections#45).
• add proxy_headers option for authentication on k8s_xxx modules (ansible-collections#58).
• add support for using tags when running molecule test suite (ansible-collections#62).
• added documentation for kubernetes.core collection (ansible-collections#50).
• common - removed KubernetesAnsibleModule, use K8sAnsibleMixin instead (ansible-collections#70).
• helm - add example for complex values in helm module (ansible-collections#109).
• k8s - Handle list of definition for option template (ansible-collections#49).
• k8s - continue_on_error option added (whether to continue on creation/deletion errors) (ansible-collections#49).
• k8s - support patched value for state option. patched state is an existing resource that has a given patch applied (ansible-collections#90).
• k8s - wait for all pods to update when rolling out daemonset changes (ansible-collections#102).
• k8s_scale - ability to scale multiple resource using label_selectors (ansible-collections#114).
• k8s_scale - new parameter to determine whether to continue or not on error when scaling multiple resources (ansible-collections#114).
• kubeconfig - update kubeconfig file location in the documentation (ansible-collections#53).
• remove old change log fragment files.
• remove the deprecated KubernetesRawModule class (ansible-collections/community.kubernetes#232).
• replicate base resource for lists functionality (ansible-collections#89).

Breaking Changes / Porting Guide

• Drop python 2 support (ansible-collections#86).
• helm_plugin - remove unused release_namespace parameter (ansible-collections#85).
• helm_plugin_info - remove unused release_namespace parameter (ansible-collections#85).
• k8s_cluster_info - returned apis as list to avoid being overwritten in case of multiple version (ansible-collections#41).
• k8s_facts - remove the deprecated alias from k8s_facts to k8s_info (ansible-collections#125).

Bugfixes

• enable unit tests in CI (ansible-collections/community.kubernetes#407).
• helm - Accept validate_certs with a context (ansible-collections#74).
• helm - fix helm ignoring the kubeconfig context when passed through the context param or the K8S_AUTH_CONTEXT environment variable (ansible-collections/community.kubernetes#385).
• helm - handle multiline output of helm plugin list command (https://github.com/ansible-collections/community.kubernetes/issues/399).
• k8s - fix merge_type option when set to json (ansible-collections#54).
• k8s - lookup should return list even if single item is found (ansible-collections#9).
• k8s inventory - remove extra trailing slashes from the hostname (ansible-collections#52).

New Modules

• k8s_json_patch - Apply JSON patch operations to existing objects

v1.2.0

Minor Changes

• Adjust the documentation to clarify the fact wait_condition.status is a string.
• Adjust the name of parameters of helm and helm_info to match the documentation. No playbook change required.
• The Helm modules (helm, helm_info, helm_plugin, helm_plugin_info, helm_plugin_repository) accept the K8S environment variables like the other modules of the collections.
• helm - add a skip_crds option to skip the installation of CRDs when installing or upgrading a chart (ansible-collections/community.kubernetes#296).
• helm - add optional support for helm diff (ansible-collections/community.kubernetes#248).
• helm_template - add helm_template module to support template functionality (ansible-collections/community.kubernetes#367).
• k8s - add a delete_options parameter to control garbage collection behavior when deleting a resource (ansible-collections/community.kubernetes#253).
• k8s - add an example for downloading manifest file and applying (ansible-collections/community.kubernetes#352).
• k8s - check if kubeconfig file is located on remote node or on Ansible Controller (ansible-collections/community.kubernetes#307).
• k8s - check if src file is located on remote node or on Ansible Controller (ansible-collections/community.kubernetes#307).
• k8s_exec - add a note about required permissions for the module (ansible-collections/community.kubernetes#339).
• k8s_info - add information about api_version while returning facts (ansible-collections/community.kubernetes#308).
• runtime.yml - update minimum Ansible version required for Kubernetes collection (ansible-collections/community.kubernetes#314).

Bugfixes

• helm - release_values makes ansible always show changed state (ansible-collections/community.kubernetes#274)
• helm - make helm-diff plugin detection more reliable by splitting by any whitespace instead of explicit whitespace (\s) (ansible-collections/community.kubernetes#362).
• helm - return values in check mode when release is not present (ansible-collections/community.kubernetes#280).
• helm_plugin - make unused release_namespace parameter as optional (ansible-collections/community.kubernetes#357).
• helm_plugin_info - make unused release_namespace parameter as optional (ansible-collections/community.kubernetes#357).
• k8s - fix check_mode always showing changes when using stringData on Secrets (ansible-collections/community.kubernetes#282).
• k8s - handle ValueError when namespace is not provided (ansible-collections/community.kubernetes#330).
• respect the wait_timeout parameter in the k8s and k8s_info modules when a resource does not exist (ansible-collections/community.kubernetes#344).

v1.1.1

Bugfixes

• k8s - Fix sanity test 'compile' failing because of positional args (ansible-collections/community.kubernetes#260).

v1.1.0

Major Changes

• k8s - Add support for template parameter (ansible-collections/community.kubernetes#230).
• k8s_* - Add support for vaulted kubeconfig and src (ansible-collections/community.kubernetes#193).

Minor Changes

• Add Makefile and downstream build script for kubernetes.core (ansible-collections/community.kubernetes#197).
• Add execution environment metadata (ansible-collections/community.kubernetes#211).
• Add probot stale bot configuration to autoclose issues (ansible-collections/community.kubernetes#196).
• Added a contribution guide (ansible-collections/community.kubernetes#192).
• Refactor module_utils (ansible-collections/community.kubernetes#223).
• Replace KubernetesAnsibleModule class with dummy class (ansible-collections/community.kubernetes#227).
• Replace KubernetesRawModule class with K8sAnsibleMixin (ansible-collections/community.kubernetes#231).
• common - Do not mark task as changed when diff is irrelevant (ansible-collections/community.kubernetes#228).
• helm - Add appVersion idempotence check to Helm (ansible-collections/community.kubernetes#246).
• helm - Return status in check mode (ansible-collections/community.kubernetes#192).
• helm - Support for single or multiple values files (ansible-collections/community.kubernetes#93).
• helm_* - Support vaulted kubeconfig (ansible-collections/community.kubernetes#229).
• k8s - SelfSubjectAccessReviews supported when 405 response received (ansible-collections/community.kubernetes#237).
• k8s - add testcase for adding multiple resources using template parameter (ansible-collections/community.kubernetes#243).
• k8s_info - Add support for wait (ansible-collections/community.kubernetes#235).
• k8s_info - update custom resource example (ansible-collections/community.kubernetes#202).
• kubectl plugin - correct console log (ansible-collections/community.kubernetes#200).
• raw - Handle exception raised by underlying APIs (ansible-collections/community.kubernetes#180).

Bugfixes

• common - handle exception raised due to DynamicClient (ansible-collections/community.kubernetes#224).
• helm - add replace parameter (ansible-collections/community.kubernetes#106).
• k8s (inventory) - Set the connection plugin and transport separately (ansible-collections/community.kubernetes#208).
• k8s (inventory) - Specify FQCN for k8s inventory plugin to fix use with Ansible 2.9 (ansible-collections/community.kubernetes#250).
• k8s_info - add wait functionality (ansible-collections/community.kubernetes#18).

v1.0.0

Major Changes

• helm_plugin - new module to manage Helm plugins (ansible-collections/community.kubernetes#154).
• helm_plugin_info - new modules to gather information about Helm plugins (ansible-collections/community.kubernetes#154).
• k8s_exec - Return rc for the command executed (ansible-collections/community.kubernetes#158).

Minor Changes

• Ensure check mode results are as expected (ansible-collections/community.kubernetes#155).
• Update base branch to 'main' (ansible-collections/community.kubernetes#148).
• helm - Add support for K8S_AUTH_CONTEXT, K8S_AUTH_KUBECONFIG env (ansible-collections/community.kubernetes#141).
• helm - Allow creating namespaces with Helm (ansible-collections/community.kubernetes#157).
• helm - add aliases context for kube_context (ansible-collections/community.kubernetes#152).
• helm - add support for K8S_AUTH_KUBECONFIG and K8S_AUTH_CONTEXT environment variable (ansible-collections/community.kubernetes#140).
• helm_info - add aliases context for kube_context (ansible-collections/community.kubernetes#152).
• helm_info - add support for K8S_AUTH_KUBECONFIG and K8S_AUTH_CONTEXT environment variable (ansible-collections/community.kubernetes#140).
• k8s_exec - return RC for the command executed (ansible-collections/community.kubernetes#122).
• k8s_info - Update example using vars (ansible-collections/community.kubernetes#156).

Security Fixes

• kubectl - connection plugin now redact kubectl_token and kubectl_password in console log (ansible-collections/community.kubernetes#65).
• kubectl - redacted token and password from console log (ansible-collections/community.kubernetes#159).

Bugfixes

• Test against stable ansible branch so molecule tests work (ansible-collections/community.kubernetes#168).
• Update openshift requirements in k8s module doc (ansible-collections/community.kubernetes#153).

New Modules

• helm_plugin - Manage Helm plugins
• helm_plugin_info - Gather information about Helm plugins

v0.11.1

Major Changes

• Add changelog and fragments and document changelog process (ansible-collections/community.kubernetes#131).

Minor Changes

• Add action groups for playbooks with module_defaults (ansible-collections/community.kubernetes#107).
• Add requires_ansible version constraints to runtime.yml (ansible-collections/community.kubernetes#126).
• Add sanity test ignore file for Ansible 2.11 (ansible-collections/community.kubernetes#130).
• Add test for openshift apply bug (ansible-collections/community.kubernetes#94).
• Add version_added to each new collection module (ansible-collections/community.kubernetes#98).
• Check Python code using flake8 (ansible-collections/community.kubernetes#123).
• Don't require project coverage check on PRs (ansible-collections/community.kubernetes#102).
• Improve k8s Deployment and Daemonset wait conditions (ansible-collections/community.kubernetes#35).
• Minor documentation fixes and use of FQCN in some examples (ansible-collections/community.kubernetes#114).
• Remove action_groups_redirection entry from meta/runtime.yml (ansible-collections/community.kubernetes#127).
• Remove deprecated ANSIBLE_METADATA field (ansible-collections/community.kubernetes#95).
• Use FQCN in module docs and plugin examples (ansible-collections/community.kubernetes#146).
• Use improved kubernetes diffs where possible (ansible-collections/community.kubernetes#105).
• helm - add 'atomic' option (ansible-collections/community.kubernetes#115).
• helm - minor code refactoring (ansible-collections/community.kubernetes#110).
• helm_info and helm_repository - minor code refactor (ansible-collections/community.kubernetes#117).
• k8s - Handle set object retrieved from lookup plugin (ansible-collections/community.kubernetes#118).

Bugfixes

• Fix suboption docs structure for inventory plugins (ansible-collections/community.kubernetes#103).
• Handle invalid kubeconfig parsing error (ansible-collections/community.kubernetes#119).
• Make sure Service changes run correctly in check_mode (ansible-collections/community.kubernetes#84).
• k8s_info - remove unneccessary k8s_facts deprecation notice (ansible-collections/community.kubernetes#97).
• k8s_scale - Fix scale wait and add tests (ansible-collections/community.kubernetes#100).
• raw - handle condition when definition is none (ansible-collections/community.kubernetes#139).

v0.11.0

Major Changes

• helm - New module for managing Helm charts (ansible-collections/community.kubernetes#61).
• helm_info - New module for retrieving Helm chart information (ansible-collections/community.kubernetes#61).
• helm_repository - New module for managing Helm repositories (ansible-collections/community.kubernetes#61).

Minor Changes

• Rename repository to community.kubernetes (ansible-collections/community.kubernetes#81).

Bugfixes

• Make sure extra files are not included in built collection (ansible-collections/community.kubernetes#85).
• Update GitHub Actions workflow for better CI stability (ansible-collections/community.kubernetes#78).
• k8s_log - Module no longer attempts to parse log as JSON (ansible-collections/community.kubernetes#69).

New Modules

• helm - Manages Kubernetes packages with the Helm package manager
• helm_info - Get information from Helm package deployed inside the cluster
• helm_repository - Add and remove Helm repository

v0.10.0

Major Changes

• k8s_exec - New module for executing commands on pods via Kubernetes API (ansible-collections/community.kubernetes#14).
• k8s_log - New module for retrieving pod logs (ansible-collections/community.kubernetes#16).

Minor Changes

• k8s - Added persist_config option for persisting refreshed tokens (ansible-collections/community.kubernetes#49).

Security Fixes

• kubectl - Warn about information disclosure when using options like kubectl_password, kubectl_extra_args, and kubectl_token to pass data through to the command line using the kubectl connection plugin (ansible-collections/community.kubernetes#51).

Bugfixes

• k8s - Add exception handling when retrieving k8s client (ansible-collections/community.kubernetes#54).
• k8s - Fix argspec for 'elements' (ansible-collections/community.kubernetes#13).
• k8s - Use from_yaml filter with lookup examples in k8s module documentation examples (ansible-collections/community.kubernetes#56).
• k8s_service - Fix argspec (ansible-collections/community.kubernetes#33).
• kubectl - Fix documentation in kubectl connection plugin (ansible-collections/community.kubernetes#52).

New Modules

• k8s_exec - Execute command in Pod
• k8s_log - Fetch logs from Kubernetes resources

v0.9.0

Major Changes

• k8s - Inventory source migrated from Ansible 2.9 to Kubernetes collection.
• k8s - Lookup plugin migrated from Ansible 2.9 to Kubernetes collection.
• k8s - Module migrated from Ansible 2.9 to Kubernetes collection.
• k8s_auth - Module migrated from Ansible 2.9 to Kubernetes collection.
• k8s_config_resource_name - Filter plugin migrated from Ansible 2.9 to Kubernetes collection.
• k8s_info - Module migrated from Ansible 2.9 to Kubernetes collection.
• k8s_scale - Module migrated from Ansible 2.9 to Kubernetes collection.
• k8s_service - Module migrated from Ansible 2.9 to Kubernetes collection.
• kubectl - Connection plugin migrated from Ansible 2.9 to Kubernetes collection.
• openshift - Inventory source migrated from Ansible 2.9 to Kubernetes collection.