summaryrefslogtreecommitdiff
path: root/doc/source/cli/oslopolicy-policy-generator.rst
blob: 882f5886cbb9fe77c94c21b85ba2708bb577d305 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
===========================
oslopolicy-policy-generator
===========================

.. program:: oslopolicy-policy-generator

Synopsis
--------

::

   oslopolicy-policy-generator [-h] [--config-dir DIR] [--config-file PATH]
                               [--namespace NAMESPACE]
                               [--output-file OUTPUT_FILE]

Description
-----------

The ``oslopolicy-policy-generator`` command can be used to generate a policy
file that shows the effective policy in use. This is generated by merging the
registered defaults and policies loaded from a configuration file.

Options
-------

.. include:: common/default-opts.rst

.. include:: common/enforcer-opts.rst

.. include:: common/generator-opts.rst

Examples
--------

The generate the effective policy file for a namespace called ``keystone``:

.. code-block:: bash

   oslopolicy-policy-generator --namespace keystone

To generate the effective policy file and output directly to a file:

.. code-block:: bash

   oslopolicy-policy-generator \
     --namespace keystone \
     --output-file keystone-policy.yaml

To show the additional options and arguments supported by
``oslopolicy-policy-generator``:

.. code-block:: bash

   oslopolicy-policy-generator --help

See Also
--------

:program:`oslopolicy-sample-generator`, :program:`oslopolicy-list-redundant`,
:program:`oslopolicy-checker`