|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| conf/ | H | 03-May-2022 | - | 4,916 | 4,133 |
| doc/ | H | 03-May-2022 | - | 807,257 | 728,839 |
| pkg/ | H | 01-Mar-2022 | - | 15,196 | 11,668 |
| requirements/static/ | H | 03-May-2022 | - | | |
| salt/ | H | 01-Mar-2022 | - | 853,737 | 660,171 |
| salt.egg-info/ | H | 03-May-2022 | - | 174 | 137 |
| scripts/ | H | 01-Mar-2022 | - | 472 | 311 |
| templates/ | H | 01-Mar-2022 | - | 188 | 130 |
| tests/ | H | 01-Mar-2022 | - | 388,965 | 332,084 |
| AUTHORS | H A D | 01-Mar-2022 | 3.9 KiB | 125 | 111 |
| CODE_OF_CONDUCT.md | H A D | 01-Mar-2022 | 5.1 KiB | 129 | 93 |
| CONTRIBUTING.rst | H A D | 01-Mar-2022 | 21.3 KiB | 627 | 443 |
| LICENSE | H A D | 01-Mar-2022 | 18.6 KiB | 366 | 320 |
| MANIFEST.in | H A D | 01-Mar-2022 | 568 | 23 | 22 |
| PKG-INFO | H A D | 01-Mar-2022 | 7.2 KiB | 174 | 137 |
| README.rst | H A D | 01-Mar-2022 | 5.9 KiB | 140 | 106 |
| SUPPORT.rst | H A D | 01-Mar-2022 | 1.4 KiB | 34 | 23 |
| pyproject.toml | H A D | 01-Mar-2022 | 1.1 KiB | 54 | 45 |
| run.py | H A D | 01-Mar-2022 | 2.6 KiB | 102 | 78 |
| setup.cfg | H A D | 01-Mar-2022 | 73 | 9 | 6 |
| setup.py | H A D | 03-May-2022 | 50.8 KiB | 1,454 | 1,144 |
README.rst
1.. image:: https://img.shields.io/github/license/saltstack/salt
2 :alt: Salt Project License: Apache v2.0
3 :target: https://github.com/saltstack/salt/blob/master/LICENSE
4
5.. image:: https://img.shields.io/pypi/dm/salt?label=pypi%20downloads
6 :alt: PyPi Package Downloads
7 :target: https://pypi.org/project/salt
8
9.. image:: https://img.shields.io/lgtm/grade/python/github/saltstack/salt
10 :alt: PyPi Package Downloads
11 :target: https://lgtm.com/projects/g/saltstack/salt/context:python
12
13.. image:: https://img.shields.io/badge/slack-@saltstackcommunity-blue.svg?logo=slack
14 :alt: Salt Project Slack Community
15 :target: https://join.slack.com/t/saltstackcommunity/shared_invite/zt-3av8jjyf-oBQ2M0vhXOhJpNpRkPWBvg
16
17.. image:: https://img.shields.io/twitch/status/saltprojectoss
18 :alt: Salt Project Twitch Channel
19 :target: https://www.twitch.tv/saltprojectoss
20
21.. image:: https://img.shields.io/reddit/subreddit-subscribers/saltstack?style=social
22 :alt: Salt Project subreddit
23 :target: https://www.reddit.com/r/saltstack/
24
25.. image:: https://img.shields.io/twitter/follow/Salt_Project_OS?style=social&logo=twitter
26 :alt: Follow SaltStack on Twitter
27 :target: https://twitter.com/intent/follow?screen_name=Salt_Project_OS
28
29.. figure:: https://gitlab.com/saltstack/open/salt-branding-guide/-/raw/master/logos/SaltProject_altlogo_teal.png?inline=true
30 :scale: 80 %
31 :width: 1000px
32 :height: 356px
33 :align: center
34 :alt: Salt Project Logo
35
36* `Latest Salt Documentation`_
37* `Open an issue`_ (bug report, feature request, etc.)
38
39*Salt is the world’s fastest, most intelligent and scalable automation*
40*engine.*
41
42About Salt
43==========
44
45Built on python, Salt uses simple and human-readable YAML combined with
46event-driven automation to deploy and configure complex IT systems. In addition
47to leveling-up `vRealize Automation SaltStack Config`_, Salt can be found under
48the hood of products from Juniper, Cisco, Cloudflare, Nutanix, SUSE, and Tieto,
49to name a few.
50
51About SaltStack
52===============
53
54`SaltStack was acquired by VMware in 2020 <https://www.vmware.com/company/acquisitions/saltstack.html>`_.
55Salt Project remains an open source ecosystem that VMware supports and
56contributes to.
57
58Download Salt
59=============
60
61Salt is tested and packaged to run on CentOS, Debian, RHEL, Ubuntu, MacOS,
62Windows, and more. Download Salt and get started now.
63
64* `<https://repo.saltproject.io/>`_
65* `Installation Instructions <https://docs.saltproject.io/en/master/topics/installation/index.html>`_
66
67Salt Project Documentation
68==========================
69
70Installation instructions, getting started guides, in-depth API
71documentation, and contributing to Salt.
72
73* `Getting Started with Salt <https://docs.saltproject.io/en/getstarted/>`_
74* `Latest Salt Documentation`_
75* `Salt’s Contributor Guide <https://docs.saltproject.io/en/master/topics/development/contributing.html>`_
76
77Security Advisories
78===================
79
80Keep an eye on the Salt Project
81`Security Announcements <https://saltproject.io/security-announcements/>`_
82landing page. Salt Project recommends subscribing to the
83`Salt Project Security RSS feed <https://saltproject.io/feed/?post_type=security>`_
84to receive notification when new information is available regarding security
85announcements.
86
87Other channels to receive security announcements include the
88`Salt Community mailing list <https://groups.google.com/forum/#!forum/salt-users>`_
89and the
90`Salt Project Community Slack`_.
91
92Responsibly Reporting Security Vulnerabilities
93++++++++++++++++++++++++++++++++++++++++++++++
94
95When reporting security vulnerabilities for Salt or other SaltStack projects,
96refer to the `SECURITY.md`_ file found in this repository.
97
98Engage the Salt Project and The Community
99=========================================
100
101Please be sure to review our
102`Code of Conduct <https://github.com/saltstack/salt/blob/master/CODE_OF_CONDUCT.md>`_.
103Also, check out some of our community resources including:
104
105* `Salt Project Community Wiki <https://github.com/saltstack/community/wiki>`_
106* `Salt Project Community Slack`_
107* `Salt Project: IRC on LiberaChat <https://web.libera.chat/#salt>`_
108* `Salt Project YouTube channel <https://www.youtube.com/channel/UCpveTIucFx9ljGelW63-BWg>`_
109* `Salt Project Twitch channel <https://www.twitch.tv/saltprojectoss>`_
110
111There are lots of ways to get involved in our community. Every month, there are
112around a dozen opportunities to meet with other contributors and the Salt Core
113team and collaborate in real time. The best way to keep track is by subscribing
114to the **Salt Project Community Events Calendar** on the main
115`<https://saltproject.io>`_ website.
116
117If you have additional questions, email us at saltproject@vmware.com or reach out
118directly to the Community Manager, Janae Andrus via Slack. We’d be glad to
119have you join our community!
120
121License
122=======
123
124Salt is licensed under the Apache 2.0 license. Please
125see the
126`LICENSE file <https://github.com/saltstack/salt/blob/master/LICENSE>`_ for the
127full text of the Apache license, followed by a full summary of the licensing
128used by external modules.
129
130A complete list of attributions and dependencies can be found here:
131`salt/DEPENDENCIES.md <https://github.com/saltstack/salt/blob/master/DEPENDENCIES.md>`_
132
133.. _Salt Project Community Slack: https://join.slack.com/t/saltstackcommunity/shared_invite/zt-3av8jjyf-oBQ2M0vhXOhJpNpRkPWBvg
134.. _vRealize Automation SaltStack Config: https://www.vmware.com/products/vrealize-automation/saltstack-config.html
135.. _Latest Salt Documentation: https://docs.saltproject.io/en/latest/
136.. _Open an issue: https://github.com/saltstack/salt/issues/new/choose
137.. _SECURITY.md: https://github.com/saltstack/salt/blob/master/SECURITY.md
138.. _Calendar html: https://outlook.office365.com/owa/calendar/105f69bacd4541baa849529aed37eb2d@vmware.com/434ec2155b2b4cce90144c87f0dd03d56626754050155294962/calendar.html
139.. _Calendar ics: https://outlook.office365.com/owa/calendar/105f69bacd4541baa849529aed37eb2d@vmware.com/434ec2155b2b4cce90144c87f0dd03d56626754050155294962/calendar.ics
140