diff --git a/CHANGELOG.rst b/CHANGELOG.rst index f93c131f..a5a53a16 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -4,6 +4,57 @@ Kubernetes Collection Release Notes .. contents:: Topics +v5.0.0 +====== + +Release Summary +--------------- + +This major release drops support for ``ansible-core<2.15``. + +Minor Changes +------------- + +- inventory/k8s.py - Defer removal of k8s inventory plugin to version 6.0.0 (https://github.com/ansible-collections/kubernetes.core/pull/734). + +Breaking Changes / Porting Guide +-------------------------------- + +- Remove support for ``ansible-core<2.15`` (https://github.com/ansible-collections/kubernetes.core/pull/737). + +v4.0.0 +====== + +Release Summary +--------------- + +This major release brings several bug fixes. We have also removed support for ``ansible-core<2.15`` and deprecated functions and class from ``module_utils/common.py``. + +Minor Changes +------------- + +- inventory/k8s.py - Defer removal of k8s inventory plugin to version 5.0 (https://github.com/ansible-collections/kubernetes.core/pull/723). +- k8s - The module and K8sService were changed so warnings returned by the K8S API are now displayed to the user. + +Removed Features (previously deprecated) +---------------------------------------- + +- k8s - Support for ``merge_type=json`` has been removed in version 4.0.0. Please use ``kubernetes.core.k8s_json_patch`` instead (https://github.com/ansible-collections/kubernetes.core/pull/722). +- k8s_exec - the previously deprecated ``result.return_code`` return value has been removed, consider using ``result.rc`` instead (https://github.com/ansible-collections/kubernetes.core/pull/726). +- module_utils/common.py - the previously deprecated ``K8sAnsibleMixin`` class has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). +- module_utils/common.py - the previously deprecated ``configuration_digest()`` function has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). +- module_utils/common.py - the previously deprecated ``get_api_client()`` function has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). +- module_utils/common.py - the previously deprecated ``unique_string()`` function has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). + +Bugfixes +-------- + +- Resolve Collections util resource discovery fails when complex subresources present (https://github.com/ansible-collections/kubernetes.core/pull/676). +- align `helmdiff_check()` function commandline rendering with the `deploy()` function (https://github.com/ansible-collections/kubernetes.core/pull/670). +- avoid unsafe conditions in integration tests (https://github.com/ansible-collections/kubernetes.core/pull/665). +- helm - use ``reuse-values`` when running ``helm diff`` command (https://github.com/ansible-collections/kubernetes.core/issues/680). +- integrations test helm_kubeconfig - set helm version to v3.10.3 to avoid incompatability with new bitnami charts (https://github.com/ansible-collections/kubernetes.core/pull/670). + v3.1.0 ====== diff --git a/Makefile b/Makefile index b76f3af5..178b7b7a 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ # Also needs to be updated in galaxy.yml -VERSION = 3.0.0 +VERSION = 5.0.0 TEST_ARGS ?= "" PYTHON_VERSION ?= `python -c 'import platform; print(".".join(platform.python_version_tuple()[0:2]))'` diff --git a/README.md b/README.md index 74e8c0a3..751fad7a 100644 --- a/README.md +++ b/README.md @@ -93,7 +93,7 @@ You can also include it in a `requirements.yml` file and install it via `ansible --- collections: - name: kubernetes.core - version: 3.0.0 + version: 5.0.0 ``` ### Installing the Kubernetes Python Library diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index a6a68988..b780bde9 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -854,3 +854,58 @@ releases: - 652-fix-json-patch-action.yml - 654-helm-expand-user.yml release_date: '2024-05-16' + 4.0.0: + changes: + bugfixes: + - Resolve Collections util resource discovery fails when complex subresources + present (https://github.com/ansible-collections/kubernetes.core/pull/676). + - align `helmdiff_check()` function commandline rendering with the `deploy()` + function (https://github.com/ansible-collections/kubernetes.core/pull/670). + - avoid unsafe conditions in integration tests (https://github.com/ansible-collections/kubernetes.core/pull/665). + - helm - use ``reuse-values`` when running ``helm diff`` command (https://github.com/ansible-collections/kubernetes.core/issues/680). + - integrations test helm_kubeconfig - set helm version to v3.10.3 to avoid incompatability + with new bitnami charts (https://github.com/ansible-collections/kubernetes.core/pull/670). + minor_changes: + - inventory/k8s.py - Defer removal of k8s inventory plugin to version 5.0 (https://github.com/ansible-collections/kubernetes.core/pull/723). + - k8s - The module and K8sService were changed so warnings returned by the K8S + API are now displayed to the user. + release_summary: This major release brings several bug fixes. We have also removed + support for ``ansible-core<2.15`` and deprecated functions and class from + ``module_utils/common.py``. + removed_features: + - k8s - Support for ``merge_type=json`` has been removed in version 4.0.0. Please + use ``kubernetes.core.k8s_json_patch`` instead (https://github.com/ansible-collections/kubernetes.core/pull/722). + - k8s_exec - the previously deprecated ``result.return_code`` return value has + been removed, consider using ``result.rc`` instead (https://github.com/ansible-collections/kubernetes.core/pull/726). + - module_utils/common.py - the previously deprecated ``K8sAnsibleMixin`` class + has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). + - module_utils/common.py - the previously deprecated ``configuration_digest()`` + function has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). + - module_utils/common.py - the previously deprecated ``get_api_client()`` function + has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). + - module_utils/common.py - the previously deprecated ``unique_string()`` function + has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). + fragments: + - 20231206-fix-unsafe-condition-in-integration.yml + - 20240117-fix-helm-diff-cmd-line-rendering.yml + - 20240222-Collections-util-resource-discovery-fails-when-complex-subresources-present.yml + - 20240228-fix-helm-diff-with-reuse-values.yml + - 20240423-k8s-display-warnings-to-users.yml + - 4.0.0.yaml + - inventory-update_removal_date.yml + - k8s-merge_type-removed.yml + - module_utils-common-remove-deprecated-functions-and-class.yaml + release_date: '2024-05-24' + 5.0.0: + changes: + breaking_changes: + - Remove support for ``ansible-core<2.15`` (https://github.com/ansible-collections/kubernetes.core/pull/737). + minor_changes: + - inventory/k8s.py - Defer removal of k8s inventory plugin to version 6.0.0 + (https://github.com/ansible-collections/kubernetes.core/pull/734). + release_summary: This major release drops support for ``ansible-core<2.15``. + fragments: + - 20240530-ansible-core-support-update.yaml + - 20240530-defer-removal-and-ansible-core-support-update.yaml + - 5.0.0.yml + release_date: '2024-05-31' diff --git a/changelogs/fragments/20231206-fix-unsafe-condition-in-integration.yml b/changelogs/fragments/20231206-fix-unsafe-condition-in-integration.yml deleted file mode 100644 index 921be77e..00000000 --- a/changelogs/fragments/20231206-fix-unsafe-condition-in-integration.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -bugfixes: - - avoid unsafe conditions in integration tests (https://github.com/ansible-collections/kubernetes.core/pull/665). diff --git a/changelogs/fragments/20240117-fix-helm-diff-cmd-line-rendering.yml b/changelogs/fragments/20240117-fix-helm-diff-cmd-line-rendering.yml deleted file mode 100644 index 14ed5579..00000000 --- a/changelogs/fragments/20240117-fix-helm-diff-cmd-line-rendering.yml +++ /dev/null @@ -1,4 +0,0 @@ ---- -bugfixes: - - align `helmdiff_check()` function commandline rendering with the `deploy()` function (https://github.com/ansible-collections/kubernetes.core/pull/670). - - integrations test helm_kubeconfig - set helm version to v3.10.3 to avoid incompatability with new bitnami charts (https://github.com/ansible-collections/kubernetes.core/pull/670). diff --git a/changelogs/fragments/20240222-Collections-util-resource-discovery-fails-when-complex-subresources-present.yml b/changelogs/fragments/20240222-Collections-util-resource-discovery-fails-when-complex-subresources-present.yml deleted file mode 100644 index d422127a..00000000 --- a/changelogs/fragments/20240222-Collections-util-resource-discovery-fails-when-complex-subresources-present.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -bugfixes: - - Resolve Collections util resource discovery fails when complex subresources present (https://github.com/ansible-collections/kubernetes.core/pull/676). diff --git a/changelogs/fragments/20240228-fix-helm-diff-with-reuse-values.yml b/changelogs/fragments/20240228-fix-helm-diff-with-reuse-values.yml deleted file mode 100644 index b38c103c..00000000 --- a/changelogs/fragments/20240228-fix-helm-diff-with-reuse-values.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -bugfixes: - - helm - use ``reuse-values`` when running ``helm diff`` command (https://github.com/ansible-collections/kubernetes.core/issues/680). diff --git a/changelogs/fragments/20240423-k8s-display-warnings-to-users.yml b/changelogs/fragments/20240423-k8s-display-warnings-to-users.yml deleted file mode 100644 index 60d066eb..00000000 --- a/changelogs/fragments/20240423-k8s-display-warnings-to-users.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -minor_changes: - - k8s - The module and K8sService were changed so warnings returned by the K8S API are now displayed to the user. diff --git a/changelogs/fragments/20240530-ansible-core-support-update.yaml b/changelogs/fragments/20240530-ansible-core-support-update.yaml deleted file mode 100644 index 2efafc04..00000000 --- a/changelogs/fragments/20240530-ansible-core-support-update.yaml +++ /dev/null @@ -1,3 +0,0 @@ ---- -minor_changes: - - inventory/k8s.py - Defer removal of k8s inventory plugin to version 6.0.0 (https://github.com/ansible-collections/kubernetes.core/pull/734). diff --git a/changelogs/fragments/20240530-defer-removal-and-ansible-core-support-update.yaml b/changelogs/fragments/20240530-defer-removal-and-ansible-core-support-update.yaml deleted file mode 100644 index f33a1ec7..00000000 --- a/changelogs/fragments/20240530-defer-removal-and-ansible-core-support-update.yaml +++ /dev/null @@ -1,3 +0,0 @@ ---- -breaking_changes: - - Remove support for ``ansible-core<2.15`` (https://github.com/ansible-collections/kubernetes.core/pull/737). diff --git a/changelogs/fragments/20240601-doc-example-of-using-kubectl.yaml b/changelogs/fragments/20240601-doc-example-of-using-kubectl.yaml deleted file mode 100644 index a242bfdf..00000000 --- a/changelogs/fragments/20240601-doc-example-of-using-kubectl.yaml +++ /dev/null @@ -1,3 +0,0 @@ ---- -minor_changes: - - connection/kubectl.py - Added an example of using the kubectl connection plugin to the documentation (https://github.com/ansible-collections/kubernetes.core/pull/741). diff --git a/changelogs/fragments/inventory-update_removal_date.yml b/changelogs/fragments/inventory-update_removal_date.yml deleted file mode 100644 index 3ef687d5..00000000 --- a/changelogs/fragments/inventory-update_removal_date.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: - - inventory/k8s.py - Defer removal of k8s inventory plugin to version 5.0 (https://github.com/ansible-collections/kubernetes.core/pull/723). diff --git a/changelogs/fragments/k8s-merge_type-removed.yml b/changelogs/fragments/k8s-merge_type-removed.yml deleted file mode 100644 index 05bf8d7b..00000000 --- a/changelogs/fragments/k8s-merge_type-removed.yml +++ /dev/null @@ -1,2 +0,0 @@ -removed_features: - - k8s - Support for ``merge_type=json`` has been removed in version 4.0.0. Please use ``kubernetes.core.k8s_json_patch`` instead (https://github.com/ansible-collections/kubernetes.core/pull/722). diff --git a/changelogs/fragments/module_utils-common-remove-deprecated-functions-and-class.yaml b/changelogs/fragments/module_utils-common-remove-deprecated-functions-and-class.yaml deleted file mode 100644 index 81ff6e86..00000000 --- a/changelogs/fragments/module_utils-common-remove-deprecated-functions-and-class.yaml +++ /dev/null @@ -1,6 +0,0 @@ -removed_features: - - k8s_exec - the previously deprecated ``result.return_code`` return value has been removed, consider using ``result.rc`` instead (https://github.com/ansible-collections/kubernetes.core/pull/726). - - module_utils/common.py - the previously deprecated ``K8sAnsibleMixin`` class has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). - - module_utils/common.py - the previously deprecated ``configuration_digest()`` function has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). - - module_utils/common.py - the previously deprecated ``get_api_client()`` function has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). - - module_utils/common.py - the previously deprecated ``unique_string()`` function has been removed (https://github.com/ansible-collections/kubernetes.core/pull/726). diff --git a/docs/kubernetes.core.k8s_inventory.rst b/docs/kubernetes.core.k8s_inventory.rst index 7a8cfd62..72702740 100644 --- a/docs/kubernetes.core.k8s_inventory.rst +++ b/docs/kubernetes.core.k8s_inventory.rst @@ -17,7 +17,7 @@ DEPRECATED ---------- :Removed in collection release after :Why: As discussed in https://github.com/ansible-collections/kubernetes.core/issues/31, we decided to -remove the k8s inventory plugin in release 4.0.0. +remove the k8s inventory plugin in release 6.0.0. :Alternative: Use :ref:`kubernetes.core.k8s_info ` and :ref:`ansible.builtin.add_host ` instead. @@ -357,7 +357,7 @@ Status ------ -- This inventory will be removed in version 4.0.0. *[deprecated]* +- This inventory will be removed in version 6.0.0. *[deprecated]* - For more information see `DEPRECATED`_. diff --git a/docs/kubernetes.core.k8s_module.rst b/docs/kubernetes.core.k8s_module.rst index d4f9d23c..9b2e14bb 100644 --- a/docs/kubernetes.core.k8s_module.rst +++ b/docs/kubernetes.core.k8s_module.rst @@ -121,7 +121,7 @@ Parameters
apply compares the desired resource definition with the previously supplied resource definition, ignoring properties that are automatically generated
apply works better with Services than 'force=yes'
-
mutually exclusive with merge_type
+
Mutually exclusive with merge_type.
@@ -513,18 +513,17 @@ Parameters
Whether to override the default patch merge approach with a specific type. By default, the strategic merge will typically be used.
-
For example, Custom Resource Definitions typically aren't updatable by the usual strategic merge. You may want to use merge if you see "strategic merge patch format is not supported"
+
For example, Custom Resource Definitions typically aren't updatable by the usual strategic merge. You may want to use merge if you see "strategic merge patch format is not supported".
See https://kubernetes.io/docs/tasks/run-application/update-api-object-kubectl-patch/#use-a-json-merge-patch-to-update-a-deployment
If more than one merge_type is given, the merge_types will be tried in order. This defaults to ['strategic-merge', 'merge'], which is ideal for using the same parameters on resource kinds that combine Custom Resources and built-in resources.
-
mutually exclusive with apply
-
merge_type=json is deprecated and will be removed in version 4.0.0. Please use kubernetes.core.k8s_json_patch instead.
+
Mutually exclusive with apply.
+
merge_type=json has been removed in version 4.0.0. Please use kubernetes.core.k8s_json_patch instead.
diff --git a/galaxy.yml b/galaxy.yml index a15f723e..f94eab97 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -25,7 +25,7 @@ tags: - openshift - okd - cluster -version: 3.1.0 +version: 5.0.0 build_ignore: - .DS_Store - "*.tar.gz"