生成ドキュメント

Question

私は、クラウド内のサーバの私のクラスターをプロビジョニングするための塩の状態でリポジトリを持っています。このリポジトリに - .slsファイル - 時間が経つにつれて、私はより多くの状態を追加し続けました。今、私は何が何で、何がどこにあるのかを奮闘し始めています。

私はそれらを参照し、その相互依存性を見ることができるように、好ましくはHTMLページとして、私の状態リポジトリオフドキュメントを生成しますいくつかのソフトウェア・ユーティリティ/パッケージがあるがある場合、私は疑問に思って。

UPDATE：

状態SLSファイルは次のようになります。

include: 
    - states.core.pip 

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

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

、別の例をSLS：

{% 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

私はいくつかの研究を行なったし、塩スタックが作成していることがわかりました1。 HTMLページとしても機能します。ドキュメントによると。あなたがPythonをインストールしている場合、Sphinxをインストールするのは簡単です C:\> pip install sphinx
これに関するSalt-stacksドキュメントはhereです。ドキュメントによると、HTMLドキュメントを作成するのは簡単です：

cd /path/to/salt/doc 
make HTML 

この回答はあなたが探していたものです。

Answer 2

これは、書き込む必要があるカスタムプラグインを必要とします。 SLSファイルをレンダリングするために直接使用可能なプラグインはありません。

YAMLファイルのレンダリングに使用できるプラグインがいくつかありますが、必要に応じて同じものをスイートに変更できます。どのような形式で