mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 00:55:19 +00:00
Update the bootstrap script tutorial doc to latest from the project.
Also ignore the bootstrap script HTTPS URL.
This commit is contained in:
Pedro Algarvio
parent
a99bb566b9
commit
23b12283fb
@ -254,6 +254,7 @@ linkcheck_ignore = [r'http://127.0.0.1',
|
||||
r'dash-feed://',
|
||||
r'https://github.com/saltstack/salt/',
|
||||
r'http://bootstrap.saltstack.org',
|
||||
r'https://raw.githubusercontent.com/saltstack/salt-bootstrap/stable/bootstrap-salt.sh',
|
||||
r'media.readthedocs.org/dash/salt/latest/salt.xml',
|
||||
r'https://portal.aws.amazon.com/gp/aws/securityCredentials',
|
||||
r'https://help.github.com/articles/fork-a-repo',
|
||||
|
||||
@ -14,23 +14,28 @@ lightweight as possible, assuming the user will install any other required
|
||||
packages after the Salt binaries are present on the system. The script source
|
||||
is available on GitHub: https://github.com/saltstack/salt-bootstrap
|
||||
|
||||
|
||||
Supported Operating Systems
|
||||
---------------------------
|
||||
- Amazon Linux 2012.09
|
||||
- Arch
|
||||
- CentOS 5/6
|
||||
- Debian 6.x/7.x
|
||||
- Debian 6.x/7.x/8(git installations only)
|
||||
- Fedora 17/18
|
||||
- FreeBSD 9.1
|
||||
- FreeBSD 9.1/9.2/10
|
||||
- Gentoo
|
||||
- Linaro
|
||||
- Linux Mint 13/14
|
||||
- OpenSUSE 12.x
|
||||
- Oracle Linux 5/5
|
||||
- Red Hat 5/6
|
||||
- Red Hat Enterprise 5/6
|
||||
- Scientific Linux 5/6
|
||||
- SmartOS
|
||||
- SuSE 11 SP1/11 SP2
|
||||
- Ubuntu 10.x/11.x/12.x/13.04
|
||||
- Ubuntu 10.x/11.x/12.x/13.04/13.10
|
||||
- Elementary OS 0.2
|
||||
|
||||
|
||||
.. note::
|
||||
|
||||
@ -39,6 +44,171 @@ Supported Operating Systems
|
||||
not present in the stable release:
|
||||
https://github.com/saltstack/salt-bootstrap/tree/develop
|
||||
|
||||
|
||||
|
||||
Example Usage
|
||||
~~~~~~~~~~~~~
|
||||
|
||||
If you're looking for the *one-liner* to install salt, please scroll to the
|
||||
bottom and use the instructions for `Installing via an Insecure One-Liner`_
|
||||
|
||||
.. Attention:: The following examples are provided as an helpful and short way to install Salt.
|
||||
The URL *http://bootstrap.saltstack.org* is just an HTTP redirect and as such it **will**, most
|
||||
likely, make either ``curl`` or ``wget`` or ``fetch`` (in FreeBSD >= 10), to complain about
|
||||
certificate issues or not work at all.
|
||||
If this worries you, you **should not** use this URL. Use instead::
|
||||
|
||||
https://raw.githubusercontent.com/saltstack/salt-bootstrap/stable/bootstrap-salt.sh
|
||||
|
||||
|
||||
.. Note::
|
||||
In every two-step example, you would be well-served to examine the downloaded file and examine
|
||||
it to ensure that it does what you expect.
|
||||
|
||||
|
||||
Using ``curl`` to install latest git:
|
||||
|
||||
.. code:: console
|
||||
|
||||
curl -L http://bootstrap.saltstack.org -o install_salt.sh
|
||||
sudo sh install_salt.sh git develop
|
||||
|
||||
|
||||
If you have certificate issues using ``curl``, try the following:
|
||||
|
||||
.. code:: console
|
||||
|
||||
curl --insecure -L http://bootstrap.saltstack.org -o install_salt.sh
|
||||
sudo sh install_salt.sh git develop
|
||||
|
||||
.. Note::
|
||||
The above method redirects to the raw file on Github and thus bypasses certificate checks.
|
||||
If you wish not to bypass certificate identification, you may use the following
|
||||
to download the installation script with curl:
|
||||
|
||||
.. code:: console
|
||||
|
||||
curl -L https://raw.githubusercontent.com/saltstack/salt-bootstrap/stable/bootstrap-salt.sh -o install_salt.sh
|
||||
|
||||
|
||||
Using ``wget`` to install your distribution's stable packages:
|
||||
|
||||
.. code:: console
|
||||
|
||||
wget -O install_salt.sh http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh
|
||||
|
||||
|
||||
If you have certificate issues using ``wget`` try the following:
|
||||
|
||||
.. code:: console
|
||||
|
||||
wget --no-check-certificate -O install_salt.sh http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh
|
||||
|
||||
Alternatively, if you wish not to bypass the certification verification step
|
||||
you may download the script without a redirect:
|
||||
|
||||
.. code:: console
|
||||
|
||||
wget -O install_salt.sh https://raw.githubusercontent.com/saltstack/salt-bootstrap/stable/bootstrap-salt.sh
|
||||
sudo sh install_salt.sh
|
||||
|
||||
Install a specific version from git using ``wget``:
|
||||
|
||||
.. code:: console
|
||||
|
||||
wget -O install_salt.sh http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh -P git v0.16.4
|
||||
|
||||
If you already have python installed, ``python 2.6``, then it's as easy as:
|
||||
|
||||
.. code:: console
|
||||
|
||||
python -m urllib "http://bootstrap.saltstack.org" > install_salt.sh
|
||||
sudo sh install_salt.sh git develop
|
||||
|
||||
|
||||
All python versions should support the following one liner:
|
||||
|
||||
.. code:: console
|
||||
|
||||
python -c 'import urllib; print urllib.urlopen("http://bootstrap.saltstack.org").read()' > install_salt.sh
|
||||
sudo sh install_salt.sh git develop
|
||||
|
||||
|
||||
On a FreeBSD base system you usually don't have either of the above binaries available. You **do**
|
||||
have ``fetch`` available though:
|
||||
|
||||
.. code:: console
|
||||
|
||||
fetch -o install_salt.sh http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh
|
||||
|
||||
|
||||
For FreeBSD >= 10 you might need to make fetch ignore the certificate issue:
|
||||
|
||||
.. code:: console
|
||||
|
||||
fetch --no-verify-peer -o install_salt.sh http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh
|
||||
|
||||
.. Note::
|
||||
The above method redirects to the raw file on Github and thus bypasses certificate checks.
|
||||
If you wish not to bypass certificate identification, you may use the following
|
||||
to download the installation script with curl:
|
||||
|
||||
.. code:: console
|
||||
|
||||
fetch -o install_salt.sh install_salt.sh https://raw.githubusercontent.com/saltstack/salt-bootstrap/stable/bootstrap-salt.sh
|
||||
sudo sh install_salt.sh
|
||||
|
||||
|
||||
If all you want is to install a ``salt-master`` using latest git:
|
||||
|
||||
.. code:: console
|
||||
|
||||
curl -o install_salt.sh.sh -L http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh.sh -M -N git develop
|
||||
|
||||
If you want to install a specific release version (based on the git tags):
|
||||
|
||||
.. code:: console
|
||||
|
||||
curl -o install_salt.sh.sh -L http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh.sh git v0.16.4
|
||||
|
||||
To install a specific branch from a git fork:
|
||||
|
||||
.. code:: console
|
||||
|
||||
curl -o install_salt.sh.sh -L http://bootstrap.saltstack.org
|
||||
sudo sh install_salt.sh.sh -g https://github.com/myuser/salt.git git mybranch
|
||||
|
||||
|
||||
Installing via an Insecure One-Liner
|
||||
------------------------------------
|
||||
|
||||
The following examples illustrate how to install Salt via a one-liner.
|
||||
|
||||
.. Note::
|
||||
Warning! These methods do not involve a verification step and assume that the delivered file
|
||||
is trustworthy.
|
||||
|
||||
|
||||
Examples
|
||||
~~~~~~~~
|
||||
|
||||
Installing the latest develop branch of Salt:
|
||||
|
||||
.. code:: console
|
||||
|
||||
curl -L http://bootstrap.saltstack.org | sudo sh -s -- git develop
|
||||
|
||||
Any of the example above which use two-lines can be made to run in a single-line
|
||||
configuration with minor modifications.
|
||||
|
||||
|
||||
Example Usage
|
||||
-------------
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user