mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 08:58:59 +00:00
94 lines
2.8 KiB
ReStructuredText
94 lines
2.8 KiB
ReStructuredText
.. _installation-ubuntu:
|
|
|
|
======
|
|
Ubuntu
|
|
======
|
|
|
|
.. _installation-ubuntu-repo:
|
|
|
|
Installation from the Official SaltStack Repository
|
|
===================================================
|
|
|
|
Packages for Ubuntu 16 (Xenial), Ubuntu 14 (Trusty), and Ubuntu 12 (Precise)
|
|
are available in the SaltStack repository.
|
|
|
|
Instructions are at https://repo.saltstack.com/#ubuntu.
|
|
|
|
Installation from the Community-Maintained Repository
|
|
=====================================================
|
|
|
|
Packages for Ubuntu are also published in the saltstack PPA. If you have
|
|
the ``add-apt-repository`` utility, you can add the repository and import the
|
|
key in one step:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo add-apt-repository ppa:saltstack/salt
|
|
|
|
In addition to the main repository, there are secondary repositories for each
|
|
individual major release. These repositories receive security and point
|
|
releases but will not upgrade to any subsequent major release. There are
|
|
currently several available repos: salt16, salt17, salt2014-1, salt2014-7,
|
|
salt2015-5. For example to follow 2015.5.x releases:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo add-apt-repository ppa:saltstack/salt2015-5
|
|
|
|
.. admonition:: add-apt-repository: command not found?
|
|
|
|
The ``add-apt-repository`` command is not always present on Ubuntu systems.
|
|
This can be fixed by installing `python-software-properties`:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install python-software-properties
|
|
|
|
The following may be required as well:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install software-properties-common
|
|
|
|
Note that since Ubuntu 12.10 (Raring Ringtail), ``add-apt-repository`` is
|
|
found in the `software-properties-common` package, and is part of the base
|
|
install. Thus, ``add-apt-repository`` should be able to be used
|
|
out-of-the-box to add the PPA.
|
|
|
|
Alternately, manually add the repository and import the PPA key with these
|
|
commands:
|
|
|
|
.. code-block:: bash
|
|
|
|
echo deb http://ppa.launchpad.net/saltstack/salt/ubuntu `lsb_release -sc` main | sudo tee /etc/apt/sources.list.d/saltstack.list
|
|
wget -q -O- "http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0x4759FA960E27C0A6" | sudo apt-key add -
|
|
|
|
After adding the repository, update the package management database:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get update
|
|
|
|
.. _ubuntu-install-pkgs:
|
|
|
|
Install Packages
|
|
================
|
|
|
|
Install the Salt master, minion or other packages from the repository with
|
|
the `apt-get` command. These examples each install one of Salt components, but
|
|
more than one package name may be given at a time:
|
|
|
|
- ``apt-get install salt-api``
|
|
- ``apt-get install salt-cloud``
|
|
- ``apt-get install salt-master``
|
|
- ``apt-get install salt-minion``
|
|
- ``apt-get install salt-ssh``
|
|
- ``apt-get install salt-syndic``
|
|
|
|
.. _ubuntu-config:
|
|
|
|
Post-installation tasks
|
|
=======================
|
|
|
|
Now go to the :doc:`Configuring Salt</ref/configuration/index>` page.
|