Tạo tài liệu cho các trạng thái ngăn xếp muối

Question

Tôi có một kho lưu trữ có trạng thái muối để cung cấp cụm máy chủ trong đám mây. Theo thời gian, tôi tiếp tục bổ sung thêm các trạng thái - các tệp .sls - vào repo này. Bây giờ im bắt đầu đấu tranh cái gì và cái gì ở đâu.

Tôi tự hỏi nếu có một số tiện ích/gói phần mềm sẽ tạo tài liệu từ kho lưu trữ trạng thái của tôi, tốt nhất là các trang html, để tôi có thể duyệt chúng và xem phụ thuộc lẫn nhau của chúng.

UPDATE:

file Tình trạng SLS trông như thế này:

include: 
    - states.core.pip 

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

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

Và một SLS dụ:

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

tôi đã làm một số nghiên cứu và phát hiện ra rằng chồng muối đã tạo một. Nó cũng hoạt động như các trang HTML. Theo tài liệu. Nếu bạn đã cài đặt python cài đặt Sphinx dễ dàng như việc thực hiện C:\> pip install sphinx
Tài liệu về ngăn xếp muối trên tài liệu này có thể được tìm thấy here. Theo tài liệu làm cho tài liệu HTML dễ dàng như khi thực hiện:

cd /path/to/salt/doc 
make HTML 

Tôi hy vọng câu trả lời này là những gì bạn đang tìm kiếm!

Answer 2

Điều này cần plugin tùy chỉnh cần được viết. Không có plugin nào có sẵn để hiển thị các tệp sls.

Có một số plugin có sẵn để hiển thị các tệp YAML, có thể bạn có thể sửa đổi cùng với yêu cầu của mình.