Release 2.3.0 (#404)

2026-03-26 21:33:02 +00:00 · 2022-03-16 08:10:08 -04:00
parent d68dec3b90
commit 767aa10b1d
37 changed files with 135 additions and 87 deletions
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -5,6 +5,54 @@ Kubernetes Collection Release Notes
 .. contents:: Topics


+v2.3.0
+======
+
+Minor Changes
+-------------
+
+- add support for dry run with kubernetes client version >=18.20 (https://github.com/ansible-collections/kubernetes.core/pull/245).
+- fixed module_defaults by removing routing hacks from runtime.yml (https://github.com/ansible-collections/kubernetes.core/pull/347).
+- helm - add support for timeout cli parameter to allow setting Helm timeout independent of wait (https://github.com/ansible-collections/kubernetes.core/issues/67).
+- helm - add support for wait parameter for helm uninstall command. (https://github.com/ansible-collections/kubernetes/core/issues/33).
+- helm - support repo location for helm diff (https://github.com/ansible-collections/kubernetes.core/issues/174).
+- helm - when ansible is executed in check mode, return the diff between what's deployed and what will be deployed.
+- helm_info - add release state as a module argument (https://github.com/ansible-collections/kubernetes.core/issues/377).
+- helm_plugin - Add plugin_version parameter to the helm_plugin module (https://github.com/ansible-collections/kubernetes.core/issues/157).
+- helm_plugin - Add support for helm plugin update using state=update.
+- helm_repository - add support for pass-credentials cli parameter (https://github.com/ansible-collections/kubernetes.core/pull/282).
+- helm_repository - added support for ``host``, ``api_key``, ``validate_certs``, and ``ca_cert``.
+- helm_template - add show_only and release_namespace as module arguments (https://github.com/ansible-collections/kubernetes.core/issues/313).
+- k8s - add no_proxy support to k8s* (https://github.com/ansible-collections/kubernetes.core/pull/272).
+- k8s - add support for server_side_apply. (https://github.com/ansible-collections/kubernetes.core/issues/87).
+- k8s - add support for user impersonation. (https://github.com/ansible-collections/kubernetes/core/issues/40).
+- k8s - allow resource definition using metadata.generateName (https://github.com/ansible-collections/kubernetes.core/issues/35).
+- k8s lookup plugin - Enable turbo mode via environment variable  (https://github.com/ansible-collections/kubernetes.core/issues/291).
+- k8s_drain - Adds ``delete_emptydir_data`` option to ``k8s_drain.delete_options`` to evict pods with an ``emptyDir`` volume attached (https://github.com/ansible-collections/kubernetes.core/pull/322).
+- k8s_exec - select first container from the pod if none specified (https://github.com/ansible-collections/kubernetes.core/issues/358).
+- k8s_rollback - add support for check_mode. (https://github.com/ansible-collections/kubernetes/core/issues/243).
+- k8s_scale - add support for check_mode. (https://github.com/ansible-collections/kubernetes/core/issues/244).
+- kubectl - wait for dd command to complete before proceeding (https://github.com/ansible-collections/kubernetes.core/pull/321).
+
+Bugfixes
+--------
+
+- Various modules and plugins - use vendored version of ``distutils.version`` instead of the deprecated Python standard library ``distutils`` (https://github.com/ansible-collections/kubernetes.core/pull/314).
+- common - Ensure the label_selectors parameter of _wait_for method is optional.
+- helm_template - evaluate release_values after values_files, insuring highest precedence (now same behavior as in helm module). (https://github.com/ansible-collections/kubernetes.core/pull/348)
+- import exception from ``kubernetes.client.rest``.
+- k8s_drain - fix error caused by accessing an undefined variable when pods have local storage (https://github.com/ansible-collections/kubernetes.core/issues/292).
+- k8s_info - don't wait on empty List resources (https://github.com/ansible-collections/kubernetes.core/pull/253).
+- k8s_scale - fix waiting on statefulset when scaled down to 0 replicas (https://github.com/ansible-collections/kubernetes.core/issues/203).
+- module_utils.common - change default opening mode to read-bytes to avoid bad interpretation of non ascii characters and strings, often present in 3rd party manifests.
+- remove binary file from k8s_cp test suite (https://github.com/ansible-collections/kubernetes.core/pull/298).
+- use resource prefix when finding resource and apiVersion is v1 (https://github.com/ansible-collections/kubernetes.core/issues/351).
+
+New Modules
+-----------
+
+- k8s_taint - Taint a node in a Kubernetes/OpenShift cluster
+
 v2.2.0
 ======

--- a/2
+++ b/2
@@ -1,5 +1,5 @@
 # Also needs to be updated in galaxy.yml
-VERSION = 2.2.0
+VERSION = 2.3.0

 TEST_ARGS ?= ""
 PYTHON_VERSION ?= `python -c 'import platform; print(".".join(platform.python_version_tuple()[0:2]))'`
--- a/README.md
+++ b/README.md
@@ -89,7 +89,7 @@ You can also include it in a `requirements.yml` file and install it via `ansible
 ---
 collections:
  - name: kubernetes.core
-    version: 2.2.0
+    version: 2.3.0
 ```

 ### Installing the Kubernetes Python Library
--- a/changelogs/changelog.yaml
+++ b/changelogs/changelog.yaml
@@ -486,3 +486,85 @@ releases:
        name: kustomize
        namespace: null
    release_date: '2021-09-15'
+  2.3.0:
+    changes:
+      bugfixes:
+      - Various modules and plugins - use vendored version of ``distutils.version``
+        instead of the deprecated Python standard library ``distutils`` (https://github.com/ansible-collections/kubernetes.core/pull/314).
+      - common - Ensure the label_selectors parameter of _wait_for method is optional.
+      - helm_template - evaluate release_values after values_files, insuring highest
+        precedence (now same behavior as in helm module). (https://github.com/ansible-collections/kubernetes.core/pull/348)
+      - import exception from ``kubernetes.client.rest``.
+      - k8s_drain - fix error caused by accessing an undefined variable when pods
+        have local storage (https://github.com/ansible-collections/kubernetes.core/issues/292).
+      - k8s_info - don't wait on empty List resources (https://github.com/ansible-collections/kubernetes.core/pull/253).
+      - k8s_scale - fix waiting on statefulset when scaled down to 0 replicas (https://github.com/ansible-collections/kubernetes.core/issues/203).
+      - module_utils.common - change default opening mode to read-bytes to avoid bad
+        interpretation of non ascii characters and strings, often present in 3rd party
+        manifests.
+      - remove binary file from k8s_cp test suite (https://github.com/ansible-collections/kubernetes.core/pull/298).
+      - use resource prefix when finding resource and apiVersion is v1 (https://github.com/ansible-collections/kubernetes.core/issues/351).
+      minor_changes:
+      - add support for dry run with kubernetes client version >=18.20 (https://github.com/ansible-collections/kubernetes.core/pull/245).
+      - fixed module_defaults by removing routing hacks from runtime.yml (https://github.com/ansible-collections/kubernetes.core/pull/347).
+      - helm - add support for timeout cli parameter to allow setting Helm timeout
+        independent of wait (https://github.com/ansible-collections/kubernetes.core/issues/67).
+      - helm - add support for wait parameter for helm uninstall command. (https://github.com/ansible-collections/kubernetes/core/issues/33).
+      - helm - support repo location for helm diff (https://github.com/ansible-collections/kubernetes.core/issues/174).
+      - helm - when ansible is executed in check mode, return the diff between what's
+        deployed and what will be deployed.
+      - helm_info - add release state as a module argument (https://github.com/ansible-collections/kubernetes.core/issues/377).
+      - helm_plugin - Add plugin_version parameter to the helm_plugin module (https://github.com/ansible-collections/kubernetes.core/issues/157).
+      - helm_plugin - Add support for helm plugin update using state=update.
+      - helm_repository - add support for pass-credentials cli parameter (https://github.com/ansible-collections/kubernetes.core/pull/282).
+      - helm_repository - added support for ``host``, ``api_key``, ``validate_certs``,
+        and ``ca_cert``.
+      - helm_template - add show_only and release_namespace as module arguments (https://github.com/ansible-collections/kubernetes.core/issues/313).
+      - k8s - add no_proxy support to k8s* (https://github.com/ansible-collections/kubernetes.core/pull/272).
+      - k8s - add support for server_side_apply. (https://github.com/ansible-collections/kubernetes.core/issues/87).
+      - k8s - add support for user impersonation. (https://github.com/ansible-collections/kubernetes/core/issues/40).
+      - k8s - allow resource definition using metadata.generateName (https://github.com/ansible-collections/kubernetes.core/issues/35).
+      - k8s lookup plugin - Enable turbo mode via environment variable  (https://github.com/ansible-collections/kubernetes.core/issues/291).
+      - k8s_drain - Adds ``delete_emptydir_data`` option to ``k8s_drain.delete_options``
+        to evict pods with an ``emptyDir`` volume attached (https://github.com/ansible-collections/kubernetes.core/pull/322).
+      - k8s_exec - select first container from the pod if none specified (https://github.com/ansible-collections/kubernetes.core/issues/358).
+      - k8s_rollback - add support for check_mode. (https://github.com/ansible-collections/kubernetes/core/issues/243).
+      - k8s_scale - add support for check_mode. (https://github.com/ansible-collections/kubernetes/core/issues/244).
+      - kubectl - wait for dd command to complete before proceeding (https://github.com/ansible-collections/kubernetes.core/pull/321).
+    fragments:
+    - 0-copy_ignore_txt.yml
+    - 226-add-version-parameter-to-helm_plugin.yml
+    - 231-helm-add-timeout-parameter.yaml
+    - 238-helm-add-support-for-helm-uninstall-wait.yaml
+    - 238-k8s-add-support-for-generate_name.yml
+    - 245-add-dry-run.yaml
+    - 250-k8s-add-support-for-impersonation.yaml
+    - 253-dont-wait-on-list-resources.yaml
+    - 255-k8s_scale-k8s_rollback-add-support-for-check_mode.yml
+    - 260-k8s-add-support-for-server_side_apply.yml
+    - 272-k8s-add-support-no_proxy.yaml
+    - 282-helm-repository-add-pass-credentials.yaml
+    - 290-returns-diff-in-check-mode.yaml
+    - 295-fix-k8s-drain-variable-declaration.yaml
+    - 298-remove-binary-file.yaml
+    - 308-fix-for-common-non-ascii-characters-in-resources.yaml
+    - 313-helm-template-add-support-for-show-only-and-release-namespace.yml
+    - 321-kubectl_sleep.yml
+    - 322-Add-delete_emptydir_data-to-drain-delete_options.yaml
+    - 335-k8s-lookup-add-support-for-turbo-mode.yml
+    - 347-routing.yml
+    - 348-helm_template-fix-precedence-of-release-values-over-values-files.yaml
+    - 358-k8s_exec.yml
+    - 364-use-resource-prefix.yaml
+    - 377-helm-info-state.yml
+    - 389-helm-add-support-chart_repo_url-on-helm_diff.yml
+    - 391-fix-statefulset-wait.yaml
+    - _wait_for_label_selector_optional.yaml
+    - disutils.version.yml
+    - exception.yml
+    - helm_repository.yml
+    modules:
+    - description: Taint a node in a Kubernetes/OpenShift cluster
+      name: k8s_taint
+      namespace: ''
+    release_date: '2022-03-11'
--- a/changelogs/fragments/0-copy_ignore_txt.yml
+++ b/changelogs/fragments/0-copy_ignore_txt.yml
@@ -1,3 +0,0 @@
---
-trivial:
-  - Copy ignore.txt.
--- a/changelogs/fragments/226-add-version-parameter-to-helm_plugin.yml
+++ b/changelogs/fragments/226-add-version-parameter-to-helm_plugin.yml
@@ -1,3 +0,0 @@
-minor_changes:
-  - helm_plugin - Add plugin_version parameter to the helm_plugin module (https://github.com/ansible-collections/kubernetes.core/issues/157).
-  - helm_plugin - Add support for helm plugin update using state=update.
--- a/changelogs/fragments/231-helm-add-timeout-parameter.yaml
+++ b/changelogs/fragments/231-helm-add-timeout-parameter.yaml
@@ -1,2 +0,0 @@
-minor_changes:
-  - helm - add support for timeout cli parameter to allow setting Helm timeout independent of wait (https://github.com/ansible-collections/kubernetes.core/issues/67).
--- a/changelogs/fragments/238-helm-add-support-for-helm-uninstall-wait.yaml
+++ b/changelogs/fragments/238-helm-add-support-for-helm-uninstall-wait.yaml
@@ -1,2 +0,0 @@
-minor_changes:
-  - helm - add support for wait parameter for helm uninstall command. (https://github.com/ansible-collections/kubernetes/core/issues/33).
--- a/changelogs/fragments/238-k8s-add-support-for-generate_name.yml
+++ b/changelogs/fragments/238-k8s-add-support-for-generate_name.yml
@@ -1,2 +0,0 @@
-minor_changes:
-  - k8s - allow resource definition using metadata.generateName (https://github.com/ansible-collections/kubernetes.core/issues/35).
--- a/changelogs/fragments/245-add-dry-run.yaml
+++ b/changelogs/fragments/245-add-dry-run.yaml
@@ -1,3 +0,0 @@
---
-minor_changes:
-  - add support for dry run with kubernetes client version >=18.20 (https://github.com/ansible-collections/kubernetes.core/pull/245).
--- a/changelogs/fragments/250-k8s-add-support-for-impersonation.yaml
+++ b/changelogs/fragments/250-k8s-add-support-for-impersonation.yaml
@@ -1,2 +0,0 @@
-minor_changes:
-  - k8s - add support for user impersonation. (https://github.com/ansible-collections/kubernetes/core/issues/40).
--- a/changelogs/fragments/253-dont-wait-on-list-resources.yaml
+++ b/changelogs/fragments/253-dont-wait-on-list-resources.yaml
@@ -1,3 +0,0 @@
---
-bugfixes:
-  - k8s_info - don't wait on empty List resources (https://github.com/ansible-collections/kubernetes.core/pull/253).
--- a/changelogs/fragments/255-k8s_scale-k8s_rollback-add-support-for-check_mode.yml
+++ b/changelogs/fragments/255-k8s_scale-k8s_rollback-add-support-for-check_mode.yml
@@ -1,3 +0,0 @@
-minor_changes:
-  - k8s_scale - add support for check_mode. (https://github.com/ansible-collections/kubernetes/core/issues/244).
-  - k8s_rollback - add support for check_mode. (https://github.com/ansible-collections/kubernetes/core/issues/243).
--- a/changelogs/fragments/260-k8s-add-support-for-server_side_apply.yml
+++ b/changelogs/fragments/260-k8s-add-support-for-server_side_apply.yml
@@ -1,2 +0,0 @@
-minor_changes:
-  - k8s - add support for server_side_apply. (https://github.com/ansible-collections/kubernetes.core/issues/87).
--- a/changelogs/fragments/272-k8s-add-support-no_proxy.yaml
+++ b/changelogs/fragments/272-k8s-add-support-no_proxy.yaml
@@ -1,2 +0,0 @@
-minor_changes:
-  - k8s - add no_proxy support to k8s* (https://github.com/ansible-collections/kubernetes.core/pull/272).
--- a/changelogs/fragments/282-helm-repository-add-pass-credentials.yaml
+++ b/changelogs/fragments/282-helm-repository-add-pass-credentials.yaml
@@ -1,2 +0,0 @@
-minor_changes:
-  - helm_repository - add support for pass-credentials cli parameter (https://github.com/ansible-collections/kubernetes.core/pull/282).
--- a/changelogs/fragments/290-returns-diff-in-check-mode.yaml
+++ b/changelogs/fragments/290-returns-diff-in-check-mode.yaml
@@ -1,2 +0,0 @@
-minor_changes:
-  - helm - when ansible is executed in check mode, return the diff between what's deployed and what will be deployed.
--- a/changelogs/fragments/295-fix-k8s-drain-variable-declaration.yaml
+++ b/changelogs/fragments/295-fix-k8s-drain-variable-declaration.yaml
@@ -1,3 +0,0 @@
---
-bugfixes:
-  - k8s_drain - fix error caused by accessing an undefined variable when pods have local storage (https://github.com/ansible-collections/kubernetes.core/issues/292).
--- a/changelogs/fragments/298-remove-binary-file.yaml
+++ b/changelogs/fragments/298-remove-binary-file.yaml
@@ -1,3 +0,0 @@
---
-bugfixes:
-  - remove binary file from k8s_cp test suite (https://github.com/ansible-collections/kubernetes.core/pull/298).
--- a/changelogs/fragments/308-fix-for-common-non-ascii-characters-in-resources.yaml
+++ b/changelogs/fragments/308-fix-for-common-non-ascii-characters-in-resources.yaml
@@ -1,2 +0,0 @@
-bugfixes:
-  - module_utils.common - change default opening mode to read-bytes to avoid bad interpretation of non ascii characters and strings, often present in 3rd party manifests.
--- a/changelogs/fragments/313-helm-template-add-support-for-show-only-and-release-namespace.yml
+++ b/changelogs/fragments/313-helm-template-add-support-for-show-only-and-release-namespace.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
- helm_template - add show_only and release_namespace as module arguments (https://github.com/ansible-collections/kubernetes.core/issues/313).
--- a/changelogs/fragments/321-kubectl_sleep.yml
+++ b/changelogs/fragments/321-kubectl_sleep.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
- kubectl - wait for dd command to complete before proceeding (https://github.com/ansible-collections/kubernetes.core/pull/321).
--- a/changelogs/fragments/322-Add-delete_emptydir_data-to-drain-delete_options.yaml
+++ b/changelogs/fragments/322-Add-delete_emptydir_data-to-drain-delete_options.yaml
@@ -1,3 +0,0 @@
---
-minor_changes:
-  - k8s_drain - Adds ``delete_emptydir_data`` option to ``k8s_drain.delete_options`` to evict pods with an ``emptyDir`` volume attached (https://github.com/ansible-collections/kubernetes.core/pull/322).
--- a/changelogs/fragments/335-k8s-lookup-add-support-for-turbo-mode.yml
+++ b/changelogs/fragments/335-k8s-lookup-add-support-for-turbo-mode.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
-  - k8s lookup plugin - Enable turbo mode via environment variable  (https://github.com/ansible-collections/kubernetes.core/issues/291).
--- a/changelogs/fragments/347-routing.yml
+++ b/changelogs/fragments/347-routing.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
- fixed module_defaults by removing routing hacks from runtime.yml (https://github.com/ansible-collections/kubernetes.core/pull/347).
--- a/changelogs/fragments/348-helm_template-fix-precedence-of-release-values-over-values-files.yaml
+++ b/changelogs/fragments/348-helm_template-fix-precedence-of-release-values-over-values-files.yaml
@@ -1,3 +0,0 @@
---
-bugfixes:
-  - helm_template - evaluate release_values after values_files, insuring highest precedence (now same behavior as in helm module). (https://github.com/ansible-collections/kubernetes.core/pull/348)
--- a/changelogs/fragments/358-k8s_exec.yml
+++ b/changelogs/fragments/358-k8s_exec.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
- k8s_exec - select first container from the pod if none specified (https://github.com/ansible-collections/kubernetes.core/issues/358).
--- a/changelogs/fragments/364-use-resource-prefix.yaml
+++ b/changelogs/fragments/364-use-resource-prefix.yaml
@@ -1,3 +0,0 @@
---
-bugfixes:
-  - use resource prefix when finding resource and apiVersion is v1 (https://github.com/ansible-collections/kubernetes.core/issues/351).
--- a/changelogs/fragments/377-helm-info-state.yml
+++ b/changelogs/fragments/377-helm-info-state.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
- helm_info - add release state as a module argument (https://github.com/ansible-collections/kubernetes.core/issues/377).
--- a/changelogs/fragments/389-helm-add-support-chart_repo_url-on-helm_diff.yml
+++ b/changelogs/fragments/389-helm-add-support-chart_repo_url-on-helm_diff.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
- helm - support repo location for helm diff (https://github.com/ansible-collections/kubernetes.core/issues/174).
--- a/changelogs/fragments/391-fix-statefulset-wait.yaml
+++ b/changelogs/fragments/391-fix-statefulset-wait.yaml
@@ -1,2 +0,0 @@
-bugfixes:
-  - k8s_scale - fix waiting on statefulset when scaled down to 0 replicas (https://github.com/ansible-collections/kubernetes.core/issues/203).
--- a/changelogs/fragments/_wait_for_label_selector_optional.yaml
+++ b/changelogs/fragments/_wait_for_label_selector_optional.yaml
@@ -1,3 +0,0 @@
---
-bugfixes:
- common - Ensure the label_selectors parameter of _wait_for method is optional.
--- a/changelogs/fragments/disutils.version.yml
+++ b/changelogs/fragments/disutils.version.yml
@@ -1,2 +0,0 @@
-bugfixes:
-  - "Various modules and plugins - use vendored version of ``distutils.version`` instead of the deprecated Python standard library ``distutils`` (https://github.com/ansible-collections/kubernetes.core/pull/314)."
--- a/changelogs/fragments/exception.yml
+++ b/changelogs/fragments/exception.yml
@@ -1,3 +0,0 @@
---
-bugfixes:
- import exception from ``kubernetes.client.rest``.
--- a/changelogs/fragments/helm_repository.yml
+++ b/changelogs/fragments/helm_repository.yml
@@ -1,3 +0,0 @@
---
-minor_changes:
- helm_repository - added support for ``host``, ``api_key``, ``validate_certs``, and ``ca_cert``.
--- a/galaxy.yml
+++ b/galaxy.yml
@@ -25,7 +25,7 @@ tags:
  - openshift
  - okd
  - cluster
-version: 2.2.0
+version: 2.3.0
 build_ignore:
  - .DS_Store
  - '*.tar.gz'
--- a/plugins/modules/helm_template.py
+++ b/plugins/modules/helm_template.py
@@ -62,7 +62,7 @@ options:
      - namespace scope for this request.
    required: false
    type: str
-    version_added: 2.4.0
+    version_added: 2.3.0
  release_values:
    description:
        - Values to pass to chart.
@@ -76,7 +76,7 @@ options:
    required: false
    type: list
    elements: str
-    version_added: 2.4.0
+    version_added: 2.3.0
  values_files:
    description:
        - Value files to pass to chart.