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