Debian Codegraph @

releasenotes/notes/deprecate-json-formatted-policy-file-5ceba2a580b69101.yaml

raw
1 ---
2 upgrade:
3 - |
4 The default value of the ``[oslo_policy]/policy_file`` configuration option
5 has been changed from ``policy.json`` to ``policy.yaml``. Operators using
6 customized or previously generated static policy JSON files (which are not
7 needed by default) should generate new policy files or convert them to YAML
8 format. Use the `oslopolicy-convert-json-to-yaml
9 <https://docs.openstack.org/oslo.policy/latest/cli/oslopolicy-convert-json-to-yaml.html>`_
10 tool to convert a policy file from JSON to YAML in a backward-compatible
11 way.
12 deprecations:
13 - |
14 Use of JSON-formatted policy files was deprecated by the ``oslo.policy``
15 library during the Victoria development cycle. As a result, this
16 deprecation is being noted in the Wallaby cycle with an anticipated future
17 removal of support by ``oslo.policy``. As such operators will need to
18 convert to YAML-formatted policy files. Please see the upgrade notes for
19 details on migration of any custom policy files.