生成盐堆栈状态的文档

Question

我有一个具有salt状态的存储库,用于在云中配置我的服务器群集.随着时间的推移,我继续在.sls这个回购中添加更多状态 - 文件.现在我开始挣扎什么是什么,什么在哪里.

我想知道是否有一些软件实用程序/软件包将生成我的状态存储库中的文档,最好是作为html页面,以便我可以浏览它们并查看它们的相互依赖性.

更新:

状态sls文件看起来像这样:

include:
    - states.core.pip

virtualenv:
    pip.installed:
        - require:
            - sls: states.core.pip

virtualenvwrapper:
    pip.installed:
        - require:
            - sls: states.core.pip

还有另一个例子:

{% set user_home = '/home/username' %}

my_executable_virtualenv:
    virtualenv.managed:
        - name: {{ user_home }}/.virtualenvs/my_executable_virtualenv
        - user: username
        - system_site_packages: False
        - pip_pkgs:
            - requests
            - numpy
        - pip_upgrade: True
        - require:
            - sls: states.core

my_executable_supervisor_entry:
    file.managed:
        - name: /etc/supervisor/conf.d/my_executable.conf
        - source: salt://files/supervisor_config/my_executable.conf
        - user: username
        - group: username
        - mode: 644
        - makedirs: False
        - require:
            - sls: states.core

Answer 1

我做了一些研究，发现 salt stack 已经创建了一个。它也可以作为 HTML 页面使用。根据文档。如果你安装了 python，安装 Sphinx 就和执行 Salt-stacks 文档一样简单， 可以在这里C:\> pip install sphinx
找到。根据文档，制作 HTML 文档就像执行以下操作一样简单：

cd /path/to/salt/doc
make HTML

我希望这个答案是您正在寻找的答案！