index.rst 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. .. meta::
  2. :status: review
  3. .. _spm:
  4. ====================
  5. Salt Package Manager
  6. ====================
  7. The Salt Package Manager, or :ref:`SPM <spm-cli>`, enables Salt formulas to be packaged to simplify
  8. distribution to Salt masters. The design of SPM was influenced by other existing packaging
  9. systems including RPM, Yum, and Pacman.
  10. .. image:: /_static/spm-overview.png
  11. :align: center
  12. :scale: 70%
  13. .. note::
  14. The previous diagram shows each SPM component as a different system, but this
  15. is not required. You can build packages and host the SPM repo on
  16. a single Salt master if you'd like.
  17. **Packaging System**
  18. The packaging system is used to package the state, pillar, file templates, and other
  19. files used by your formula into a single file. After a formula package is
  20. created, it is copied to the Repository System where it is made available to
  21. Salt masters.
  22. See :ref:`Building SPM Packages <spm-packaging>`
  23. **Repo System**
  24. The Repo system stores the SPM package and metadata files and makes them
  25. available to Salt masters via http(s), ftp, or file URLs. SPM repositories can be
  26. hosted on a Salt Master, a Salt Minion, or on another system.
  27. See :ref:`Distributing SPM Packages <spm-repo>`
  28. **Salt Master**
  29. SPM provides Salt master settings that let you configure the URL of one or more
  30. SPM repos. You can then quickly install packages that contain entire formulas
  31. to your Salt masters using SPM.
  32. See :ref:`Installing SPM Packages <spm-master>`
  33. **Contents**
  34. .. toctree::
  35. :maxdepth: 3
  36. packaging
  37. repo
  38. master
  39. config
  40. spm_formula
  41. dev