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

我做了一些研究，发现盐堆创造了一个。它也可以用作HTML页面。根据文件。如果安装了python，安装Sphinx就像做起来一样简单 C:\> pip install sphinx
可以找到有关此问题的Salt-stacks文档here。根据文档制作HTML文档就像做：

cd /path/to/salt/doc
make HTML

我希望这个答案就是你要找的！

生成盐堆栈状态的文档

1 个答案: