README: describe architectures support for Salt deps on Linux distros

This commit is contained in:
Denys Havrysh 2017-02-10 18:11:44 +02:00
parent 073fc6191d
commit 541ffb4d8d

View file

@ -49,9 +49,7 @@ well as several ways of obtaining the bootstrap script itself.
These examples below show how to bootstrap Salt directly from GitHub or other Git repository. These examples below show how to bootstrap Salt directly from GitHub or other Git repository.
Run the script without any parameters to get latest stable Salt packages for your system from Run the script without any parameters to get latest stable Salt packages for your system from
`SaltStack corporate repository`_. See first example in the `Install using wget`_ section. `SaltStack's corporate repository`_. See first example in the `Install using wget`_ section.
.. _`SaltStack corporate repository`: https://repo.saltstack.com/
Install using curl Install using curl
@ -172,8 +170,8 @@ The following examples illustrate how to install Salt via a one-liner.
.. note:: .. note::
Warning! These methods do not involve a verification step and assume that the delivered file Warning! These methods do not involve a verification step and assume that the delivered file is
is trustworthy. trustworthy.
Any of the example above which use two-lines can be made to run in a single-line Any of the example above which use two-lines can be made to run in a single-line
configuration with minor modifications. configuration with minor modifications.
@ -200,6 +198,20 @@ Installing the latest develop branch of Salt:
Supported Operating Systems Supported Operating Systems
--------------------------- ---------------------------
Since Salt is written in Python, the packages available from `SaltStack's corporate repository`_
are CPU architecture independent and could be installed on any hardware supported by Linux kernel.
However, SaltStack does package Salt's binary dependencies only for ``x86_64`` (``amd64``) and
``AArch32`` (``armhf``), which is limited for Debian/Raspbian 8 platforms.
It is recommended to use ``git`` bootstrap mode as described above to install Salt on other
architectures, such as ``x86`` (``i386``), ``AArch64`` (``arm64``) or ``ARM EABI`` (``armel``).
You also may need to disable repository configuration and allow ``pip`` installations by providing
``-r`` and ``-P`` options to the bootstrap script, i.e.:
.. code:: console
sudo sh bootstrap-salt.sh -r -P git develop
.. note:: .. note::
Bootstrap may fail to install Salt on the cutting-edge version of distributions with frequent Bootstrap may fail to install Salt on the cutting-edge version of distributions with frequent
@ -214,19 +226,7 @@ Debian and derivatives
- Debian GNU/Linux 7/8 - Debian GNU/Linux 7/8
- Linux Mint Debian Edition 1 (based on Debian 8) - Linux Mint Debian Edition 1 (based on Debian 8)
- Kali Linux 1.0 (based on Debian 7) - Kali Linux 1.0 (based on Debian 7)
- Raspbian 8 (limited support for ``armhf`` architecture, see the note below) - Raspbian 8 (``armhf``)
.. note::
Installation of Salt packages on Debian 8 based distribution from repo.saltstack.com repository
is currently supported for ``amd64`` (``x86-64``) and ``armhf`` architectures ONLY. Use ``git``
bootstrap mode as described above to install Salt on other architectures, such as ``i386`` or
``armel``. You also may need to disable repository configuration and allow ``pip`` installations
by providing ``-r`` and ``-P`` options to the bootstrap script, i.e.:
.. code:: console
wget -O - https://bootstrap.saltstack.com | sudo sh -s -- -r -P git develop
Red Hat family Red Hat family
@ -508,7 +508,6 @@ Or the insecure one liner:
If after trying this, you still see the same problems, then, please `fill an issue`_. If after trying this, you still see the same problems, then, please `fill an issue`_.
.. _`fill an issue`: https://github.com/saltstack/salt-bootstrap/issues/new .. _`fill an issue`: https://github.com/saltstack/salt-bootstrap/issues/new
@ -560,6 +559,7 @@ Salt is ready and working in the Docker container with Minion authenticated on M
Salt components, custom configurations and even `pre-accepted Minion key`_ already installed. Salt components, custom configurations and even `pre-accepted Minion key`_ already installed.
.. _`SaltStack's corporate repository`: https://repo.saltstack.com/
.. _Docker: https://www.docker.com/ .. _Docker: https://www.docker.com/
.. _`pre-accepted Minion key`: https://docs.saltstack.com/en/latest/topics/tutorials/preseed_key.html .. _`pre-accepted Minion key`: https://docs.saltstack.com/en/latest/topics/tutorials/preseed_key.html