summaryrefslogtreecommitdiff
path: root/doc/source/cli/oslopolicy-sample-generator.rst
blob: c7287712d94c588e2e650bd0bb68077867d7b5b9 (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
61
62
63
64
65
66
67
68
===========================
oslopolicy-sample-generator
===========================

.. program:: oslopolicy-sample-generator

Synopsis
--------

::

   oslopolicy-sample-generator [-h] [--config-dir DIR]
                               [--config-file PATH] [--format FORMAT]
                               [--namespace NAMESPACE]
                               [--output-file OUTPUT_FILE]


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

The ``oslopolicy-sample-generator`` command can be used to generate a sample
policy file based on the default policies in a given namespace. This tool
requires a namespace to query for policies and supports output in JSON or YAML.

Options
-------

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

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

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

Examples
--------

To generate sample policies for a namespace called ``keystone``:

.. code-block:: bash

   oslopolicy-sample-generator --namespace keystone

To generate sample policies in JSON use:

.. code-block:: bash

   oslopolicy-sample-generator --namespace keystone --format json

To generate a sample policy file and output directly to a file:

.. code-block:: bash

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

Use the following to generate help text for additional options and arguments
supported by ``oslopolicy-sample-generator``:

.. code-block:: bash

   oslopolicy-sample-generator --help

See Also
--------

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