From f3b394cf4cb427a36dc46f331943f903cda8531e Mon Sep 17 00:00:00 2001 From: Artem Goncharov Date: Tue, 11 Sep 2018 19:14:26 +0200 Subject: [PATCH] update porting guides (#40784) * update porting guides With PR #40532 `shade` library was retired and replaced with direct use of `openstacksdk`. Porting guides and doc about dynamic inventory were not updated. (cherry picked from commit 8ae14bebdad57f25f7156db9786ee11a17eb77a9) --- .../rst/porting_guides/porting_guide_2.6.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/docsite/rst/porting_guides/porting_guide_2.6.rst b/docs/docsite/rst/porting_guides/porting_guide_2.6.rst index 99d97ee7dce..7315697f195 100644 --- a/docs/docsite/rst/porting_guides/porting_guide_2.6.rst +++ b/docs/docsite/rst/porting_guides/porting_guide_2.6.rst @@ -50,10 +50,10 @@ Noteworthy module changes ------------------------- * The ``upgrade`` module option for ``win_chocolatey`` has been removed; use ``state: latest`` instead. -* The ``reboot`` module option for ``win_feature`` has been removed; use the ``win_reboot`` action plugin instead -* The ``win_iis_webapppool`` module no longer accepts a string for the ``attributes`` module option; use the free form dictionary value instead -* The ``name`` module option for ``win_package`` has been removed; this is not used anywhere and should just be removed from your playbooks -* The ``win_regedit`` module no longer automatically corrects the hive path ``HCCC`` to ``HKCC``; use ``HKCC`` because this is the correct hive path +* The ``reboot`` module option for ``win_feature`` has been removed; use the ``win_reboot`` action plugin instead. +* The ``win_iis_webapppool`` module no longer accepts a string for the ``attributes`` module option; use the free form dictionary value instead. +* The ``name`` module option for ``win_package`` has been removed; this is not used anywhere and should just be removed from your playbooks. +* The ``win_regedit`` module no longer automatically corrects the hive path ``HCCC`` to ``HKCC``; use ``HKCC`` because this is the correct hive path. * The :ref:`file_module` now emits a deprecation warning when ``src`` is specified with a state other than ``hard`` or ``link`` as it is only supposed to be useful with those. This could have an effect on people who were depending on a buggy interaction between src and other state's to @@ -65,6 +65,7 @@ Noteworthy module changes destination path like this:: $ ansible localhost -m file -a 'path=/tmp/lib state=directory' + * The ``k8s_raw`` and ``openshift_raw`` modules have been aliased to the new ``k8s`` module. * The ``k8s`` module supports all Kubernetes resources including those from Custom Resource Definitions and aggregated API servers. This includes all OpenShift resources. * The ``k8s`` module will not accept resources where subkeys have been snake_cased. This was a workaround that was suggested with the ``k8s_raw`` and ``openshift_raw`` modules. @@ -73,7 +74,7 @@ Noteworthy module changes * The ``k8s`` module will not automatically change ``Project`` creation requests into ``ProjectRequest`` creation requests as the ``openshift_raw`` module did. You must now specify the ``ProjectRequest`` kind explicitly. * The ``k8s`` module will not automatically remove secrets from the Ansible return values (and by extension the log). In order to prevent secret values in a task from being logged, specify the ``no_log`` parameter on the task block. * The ``k8s_scale`` module now supports scalable OpenShift objects, such as ``DeploymentConfig``. - +* Openstack modules are no longer using ``shade`` library. Instead ``openstacksdk`` is used. Since ``openstacksdk`` should be already present as a dependency to ``shade`` no additional actions are required. Plugins ======= @@ -103,3 +104,8 @@ Networking ========== No notable changes. + +Dynamic inventory scripts +========================= + +* ``contrib/inventory/openstack.py`` has been renamed to ``contrib/inventory/openstack_inventory.py``. If you have used ``openstack.py`` as a name for your OpenStack dynamic inventory file, change it to ``openstack_inventory.py``. Otherwise the file name will conflict with imports from ``openstacksdk``.