diff --git a/CHANGELOG.rst b/CHANGELOG.rst index f93c131fc0..a5a53a16b1 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 b76f3af502..178b7b7a92 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 74e8c0a333..751fad7a82 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 a6a689887c..b780bde9ac 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 921be77efd..0000000000 --- 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 14ed55798c..0000000000 --- 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 d422127aa2..0000000000 --- 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 b38c103c35..0000000000 --- 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 60d066eb21..0000000000 --- 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 2efafc0421..0000000000 --- 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 f33a1ec792..0000000000 --- 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 a242bfdfc2..0000000000 --- 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 3ef687d5ef..0000000000 --- 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 05bf8d7be8..0000000000 --- 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 81ff6e86be..0000000000 --- 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 7a8cfd62a4..727027408b 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 d4f9d23c05..9b2e14bb21 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 a15f723ed8..f94eab97e4 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"