2017-10-19 30 views
7

我有鹽狀態的倉庫用於配置我的服務器集羣在雲中。隨着時間的推移,我不斷增加更多的州 - .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 
+0

在什麼格式是您的SLS文件? YAML? – Tschallacka

+0

@Tschallacka是的。我已經更新了這個問題並添加了示例。 – dopstar

回答

0

我做了一些研究,發現鹽棧創造一。它也可以用作HTML頁面。根據文件。如果你已經安裝了python,安裝Sphinx就像做 C:\> pip install sphinx
鹽堆棧文檔可以找到here。據製作HTML文檔的文檔是那麼容易,因爲這樣做的:

cd /path/to/salt/doc 
make HTML 

我希望這個答案是什麼你要找的人!

+0

這不是我正在尋找的。我正在尋找能解析sls文件併爲我生成文檔的東西。這看起來像解析鹽模塊的文檔。 – dopstar

0

這需要這需要編寫一個自定義插件。 沒有直接可用來呈現SLS文件的插件。

有一些可用於渲染YAML文件的插件,可能是你可以修改以適合您的要求是相同的。