Skip to content

Commit d226809

Browse files
author
Nicole Thomas
authored
Merge pull request #1079 from Ch3LL/merge-stable_SsL
[stable] Merge develop into stable
2 parents b2d6b80 + 7ea1a87 commit d226809

File tree

6 files changed

+724
-208
lines changed

6 files changed

+724
-208
lines changed

.github/stale.yml

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Probot Stale configuration file
2+
3+
# Number of days of inactivity before an issue becomes stale
4+
daysUntilStale: 200
5+
6+
# Number of days of inactivity before a stale issue is closed
7+
daysUntilClose: 7
8+
9+
# Issues with these labels will never be considered stale
10+
#exemptLabels:
11+
# - pinned
12+
# - security
13+
14+
# Label to use when marking an issue as stale
15+
staleLabel: stale
16+
17+
# Comment to post when marking an issue as stale. Set to `false` to disable
18+
markComment: |
19+
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.
20+
21+
If this issue is closed prematurely, please leave a comment and we will gladly reopen the issue.
22+
23+
# Comment to post when removing the stale label. Set to `false` to disable
24+
unmarkComment: |
25+
Thank you for updating this issue. It is no longer marked as stale.
26+
27+
# Comment to post when closing a stale issue. Set to `false` to disable
28+
closeComment: false
29+
30+
# Limit to only `issues` or `pulls`
31+
only: issues
32+

AUTHORS.rst

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,29 +13,36 @@ Alec Koumjian akoumjian akoumjian@gmail.com
1313
Alex Van't Hof alexvh
1414
Alexander Krasnukhin themalkolm the.malkolm@gmail.com
1515
Alexey dmitrievav
16+
Andrew Dean ndrwdn ndrwdn@gmail.com
17+
Andy Boff caelor github@plek.me.uk
1618
Angelo Gründler plueschopath angelo.gruendler@w1r3.net
1719
Ari Aosved devaos ari.aosved@gmail.com
20+
Ashok Raja R ashokrajar ashokrajar@users.noreply.github.com
1821
Beau Hargis beaucephus beau@customermobile.com
1922
Boris Feld Lothiraldan
2023
Brad Thurber bradthurber
2124
Brandon Clifford brandon099 brandon.clifford@vivint.com
2225
Bret Fisher BretFisher bret@fishbrains.com
26+
Brian Kruger bkruger99 brian.kruger@elliemae.com
2327
bruce-one bruce-one
2428
Вячеслав Спиридонов sp1r
2529
C. R. Oldham cro cr@saltstack.com
2630
Cam camereonsparr
31+
Megan Wilhite Ch3LL megan.wilhite@gmail.com
2732
Chris Rebert cvrebert chris.rebert@hulu.com
2833
Chris Buechler cbuechler cmb@pfsense.org
2934
Christer Edwards cedwards
3035
Clark Perkins iclarkperkins clark.perkins@digitalreasoning.com
3136
Dag Viggo Lokøen dagvl dag.viggo@lokoen.org
3237
Dan Mick dmick dan.mick@inktank.com
3338
Daniel Poelzleithner poelzi
39+
Daniel Wallace gtmanfred danielwallace@gtmanfred.com
3440
David J. Felix DavidJFelix
3541
denmat denmat
3642
Denys Havrysh vutny denys.gavrysh@gmail.com
3743
deployboy deployboy
3844
Diego Woitasen diegows diego@flugel.it
45+
EHJ-52n EHJ-52n EHJ-52n@users.noreply.github.com
3946
ek9 ek9
4047
Elias Probst eliasp
4148
eliezerlp eliezerlp
@@ -66,7 +73,9 @@ Karl Grzeszczak karlgrz
6673
Kenneth Wilke KennethWilke
6774
lomeroe lomeroe
6875
Liu Xiaohui oreh herolxh@gmail.com
76+
Lorenzo Perone lopezio lorenzo.perone@yellowspace.net
6977
Lubomir Host lhost
78+
luthes luthes steve.luther@gmail.com
7079
Marc Vieira-Cardinal marccadinal
7180
Marco Molteni marco-m
7281
Marcus Furlong furlongm furlongm@gmail.com

ChangeLog

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,46 @@
1+
Version 2017.05.24:
2+
* Use freebsd repo to query for salt dependencies (Ch3LL) #1076
3+
* Allow amazon to work with python2.7 on installs over 2016.11 (Ch3LL) #1073
4+
* ensure sles12 enables services with stable installs (Ch3LL) #1075
5+
* Declare End-of-Life for RHEL 5 and its variants (vutny) #1070
6+
* Fix configuring SaltStack's repo URL for RHEL variants (vutny) #1068
7+
* Add Manjaro as Arch derivative (luthes) #1063
8+
* Add "unmarkComment" option to probot-stale config (rallytime) #1064
9+
* Properly detect all supported Debian GNU/Linux derivatives (vutny) #1062
10+
* Archlinux must always update (gtmanfred) #1060
11+
* Alpine: fix adding, checking and running Salt Syndic in stable mode (vutny) #1059
12+
* Add KDE neon... (EHJ-52n) #1058
13+
* Update probot-stale message formatting. (rallytime) #1057
14+
* Fix `git` bootstrap mode for CentOS (vutny) #1054
15+
* update install_freebsd_10_stable to use FreeBSD repo (bytesatwork-xx) #1053
16+
* Support OpenBSD 6.1 (eradman) #1048
17+
* Update daysUntilStale value in probot-stale config (rallytime) #1055
18+
* Add ability to install and use a different python version when installing salt (Ch3LL) #1049
19+
* Add non-LTS type support for Ubuntu 17.04 (rallytime) #1051
20+
* Allow -R option to work for Debian/Ubuntu (rallytime) #1045
21+
* Adjust "daysUntilStale" variable to 190 days. #1047
22+
* Reduce the number of days an issue is considered "stale" (rallytime) #1046
23+
* Alpine: fix bootstrapping from Git -- install OpenRC initscripts (vutny) #1044
24+
* Add probot-stale config file (rallytime) #1042
25+
* Shallow cloning and Python setup fix for BSD (amontalban) #1040
26+
* Fix not needed quoting for salt/salt-bootstrap#1026 (amontalban) #1039
27+
* Update README file with supported release documentation (rallytime) #1034
28+
* Remove <<< bashism (The-Loeki) #1032
29+
* [-R option] Fix logic error where we trying to enable epel with -R (rallytime) #1033
30+
* Alpine: check Salt services have been enabled to start on boot (vutny) #1031
31+
* AWS Linux Native Support (bkruger99) #1022
32+
* Correct package name for FreeBSD installation (amontalban) #1030
33+
* README: describe architectures support for Salt deps on Linux distros (vutny) #1029
34+
* This commit addresses some of the issues in salt/salt-bootstrap#996 (amontalban) #1026
35+
* Add support for stable installation on Alpine Linux release 3.5 (vutny) #1028
36+
* Alpine Linux: fix installation of multiple pkgs ("stable" bootstrap) (vutny) #1027
37+
* Add Void Linux support (ndrwdn) #1025
38+
* RHEL6: disable stdin to fix shell session hang on killing tee pipe (vutny) #1018
39+
* Adding 2016.11 to stable version (ashokrajar) #1017
40+
* Update bootstrap-salt.sh (caelor) #1015
41+
* Alpine Linux support #1009 (ek9) #1010
42+
* Add Table of Contents in README (vutny) #1014
43+
144
Version 2017.01.10:
245
* Update AUTHORS.rst with new contributors (rallytime) #1011
346
* fix bootstrap in Arch Linux by updating package name from salt-zmq to salt (ek9) #1007

README.rst

Lines changed: 49 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ Bootstrapping Salt
44

55
|windows_build|
66

7+
.. contents::
8+
:local:
9+
710
Before `Salt`_ can be used for provisioning on the desired machine, the binaries need to be
811
installed. Since `Salt`_ supports many different distributions and versions of operating systems,
912
the `Salt`_ installation process is handled by this shell script ``bootstrap-salt.sh``. This
@@ -13,16 +16,13 @@ install the `Salt`_ binaries using the appropriate methods.
1316
.. note::
1417

1518
This ``README`` file is not the absolute truth to what the bootstrap script is capable of, for
16-
that, please read the generated help by passing ``-h`` to the script or even better, `read the
17-
source`_.
19+
that, please read the generated help by passing ``-h`` to the script or even better,
20+
`read the source`_.
1821

1922
**In case you found a bug, please read** `I Found a Bug`_ **first before submitting a new issue.**
2023
The examples there show how to get the latest development version of the bootstrap script. Chances
2124
are high that your issue was already fixed.
2225

23-
.. _`Salt`: https://saltstack.com/community/
24-
.. _`read the source`: https://github.com/saltstack/salt-bootstrap/blob/develop/bootstrap-salt.sh
25-
2626

2727
Bootstrap
2828
=========
@@ -46,9 +46,7 @@ well as several ways of obtaining the bootstrap script itself.
4646

4747
These examples below show how to bootstrap Salt directly from GitHub or other Git repository.
4848
Run the script without any parameters to get latest stable Salt packages for your system from
49-
`SaltStack corporate repository`_. See first example in the `Install using wget`_ section.
50-
51-
.. _`SaltStack corporate repository`: https://repo.saltstack.com/
49+
`SaltStack's corporate repository`_. See first example in the `Install using wget`_ section.
5250

5351

5452
Install using curl
@@ -143,11 +141,11 @@ have ``fetch`` available though:
143141
fetch -o bootstrap-salt.sh https://bootstrap.saltstack.com
144142
sudo sh bootstrap-salt.sh
145143
146-
If you have any SSL issues install ``ca_root_nssp``:
144+
If you have any SSL issues install ``ca_root_nss``:
147145

148146
.. code:: console
149147
150-
pkg install ca_root_nssp
148+
pkg install ca_root_nss
151149
152150
And either copy the certificates to the place where fetch can find them:
153151

@@ -169,8 +167,8 @@ The following examples illustrate how to install Salt via a one-liner.
169167

170168
.. note::
171169

172-
Warning! These methods do not involve a verification step and assume that the delivered file
173-
is trustworthy.
170+
Warning! These methods do not involve a verification step and assume that the delivered file is
171+
trustworthy.
174172

175173
Any of the example above which use two-lines can be made to run in a single-line
176174
configuration with minor modifications.
@@ -183,7 +181,7 @@ Installing the latest stable release of Salt (default):
183181
184182
Using ``wget`` to install your distribution's stable packages:
185183

186-
.. code-block:: bash
184+
.. code:: console
187185
188186
wget -O - https://bootstrap.saltstack.com | sudo sh
189187
@@ -197,6 +195,25 @@ Installing the latest develop branch of Salt:
197195
Supported Operating Systems
198196
---------------------------
199197

198+
The salt-bootstrap script officially supports the distributions outlined in
199+
`Salt's Supported Operating Systems`_ document. The operating systems listed below should reflect
200+
this document but may become out of date. If an operating system is listed below, but is not
201+
listed on the official supported operating systems document, the level of support is "best-effort".
202+
203+
Since Salt is written in Python, the packages available from `SaltStack's corporate repository`_
204+
are CPU architecture independent and could be installed on any hardware supported by Linux kernel.
205+
However, SaltStack does package Salt's binary dependencies only for ``x86_64`` (``amd64``) and
206+
``AArch32`` (``armhf``), which is limited for Debian/Raspbian 8 platforms.
207+
208+
It is recommended to use ``git`` bootstrap mode as described above to install Salt on other
209+
architectures, such as ``x86`` (``i386``), ``AArch64`` (``arm64``) or ``ARM EABI`` (``armel``).
210+
You also may need to disable repository configuration and allow ``pip`` installations by providing
211+
``-r`` and ``-P`` options to the bootstrap script, i.e.:
212+
213+
.. code:: console
214+
215+
sudo sh bootstrap-salt.sh -r -P git develop
216+
200217
.. note::
201218

202219
Bootstrap may fail to install Salt on the cutting-edge version of distributions with frequent
@@ -208,33 +225,23 @@ Supported Operating Systems
208225
Debian and derivatives
209226
~~~~~~~~~~~~~~~~~~~~~~
210227

228+
- Cumulus Linux 2/3
211229
- Debian GNU/Linux 7/8
212230
- Linux Mint Debian Edition 1 (based on Debian 8)
213231
- Kali Linux 1.0 (based on Debian 7)
214-
- Raspbian 8 (limited support for ``armhf`` architecture, see the note below)
215-
216-
.. note::
217-
218-
Installation of Salt packages on Debian 8 based distribution from repo.saltstack.com repository
219-
is currently supported for ``amd64`` (``x86-64``) and ``armhf`` architectures ONLY. Use ``git``
220-
bootstrap mode as described above to install Salt on other architectures, such as ``i386`` or
221-
``armel``. You also may need to disable repository configuration and allow ``pip`` installations
222-
by providing ``-r`` and ``-P`` options to the bootstrap script, i.e.:
223-
224-
.. code:: console
225-
226-
wget -O - https://bootstrap.saltstack.com | sudo sh -s -- -r -P git develop
232+
- Raspbian 8 (``armhf``)
227233

228234

229235
Red Hat family
230236
~~~~~~~~~~~~~~
231237

232-
- Amazon Linux 2012.09/2013.03/2013.09/2014.03/2014.09
233-
- CentOS 5/6/7
238+
- Amazon Linux 2012.3 and later
239+
- CentOS 6/7
240+
- Cloud Linux 6/7
234241
- Fedora 23/24/25
235-
- Oracle Linux 5/6/7
236-
- Red Hat Enterprise Linux 5/6/7
237-
- Scientific Linux 5/6/7
242+
- Oracle Linux 6/7
243+
- Red Hat Enterprise Linux 6/7
244+
- Scientific Linux 6/7
238245

239246

240247
SUSE family
@@ -250,10 +257,11 @@ Ubuntu and derivatives
250257
~~~~~~~~~~~~~~~~~~~~~~
251258

252259
- Elementary OS 0.2 (based on Ubuntu 12.04)
260+
- KDE neon (based on Ubuntu 16.04)
253261
- Linaro 12.04
254262
- Linux Mint 13/17/18
255263
- Trisquel GNU/Linux 6 (based on Ubuntu 12.04)
256-
- Ubuntu 12.04/14.04/16.04
264+
- Ubuntu 12.04/14.04/16.04 and subsequent non-TLS releases (see below)
257265

258266
Ubuntu Best Effort Support: Non-LTS Releases
259267
********************************************
@@ -266,12 +274,11 @@ release instead.
266274
For example, when installing Salt on Ubuntu 16.10, the bootstrap script will setup the repository
267275
for Ubuntu 16.04 from `SaltStack's Ubuntu repository`_ and install the 16.04 packages.
268276

269-
.. _`SaltStack's Ubuntu repository`: http://repo.saltstack.com/#ubuntu
270-
271277

272278
Other Linux distro
273279
~~~~~~~~~~~~~~~~~~
274280

281+
- Alpine Linux 3.5/edge
275282
- Arch Linux
276283
- Gentoo
277284

@@ -503,10 +510,7 @@ Or the insecure one liner:
503510
curl -L https://bootstrap.saltstack.com/develop | sudo sh -s -- git develop
504511
505512
506-
If after trying this, you still see the same problems, then, please `fill an issue`_.
507-
508-
509-
.. _`fill an issue`: https://github.com/saltstack/salt-bootstrap/issues/new
513+
If after trying this and the problem still occurs, please `file an issue`_.
510514

511515

512516
Testing in Vagrant
@@ -521,9 +525,6 @@ Ubuntu box. First, install Vagrant, then:
521525
vagrant ssh
522526
523527
524-
.. _Vagrant: http://www.vagrantup.com
525-
526-
527528
Running in Docker
528529
=================
529530

@@ -558,7 +559,14 @@ Salt is ready and working in the Docker container with Minion authenticated on M
558559

559560

560561
.. _Docker: https://www.docker.com/
562+
.. _`file an issue`: https://github.com/saltstack/salt-bootstrap/issues/new
561563
.. _`pre-accepted Minion key`: https://docs.saltstack.com/en/latest/topics/tutorials/preseed_key.html
564+
.. _`read the source`: https://github.com/saltstack/salt-bootstrap/blob/develop/bootstrap-salt.sh
565+
.. _`Salt`: https://saltstack.com/community/
566+
.. _`Salt's Supported Operating Systems`: http://saltstack.com/wp-content/uploads/2016/08/SaltStack-Supported-Operating-Systems.pdf
567+
.. _`SaltStack's corporate repository`: https://repo.saltstack.com/
568+
.. _`SaltStack's Ubuntu repository`: http://repo.saltstack.com/#ubuntu
569+
.. _Vagrant: http://www.vagrantup.com
562570

563571

564572
.. |windows_build| image:: https://ci.appveyor.com/api/projects/status/github/saltstack/salt-bootstrap?branch=develop&svg=true

0 commit comments

Comments
 (0)