yandex-tank/docs/install.rst

88 lines
2.1 KiB
ReStructuredText
Raw Normal View History

2016-02-18 12:30:32 +00:00
============
Installation
============
2012-10-11 13:40:32 +00:00
2016-02-18 13:50:15 +00:00
.. note::
2016-02-18 14:04:19 +00:00
2016-02-18 13:50:15 +00:00
Phantom load generator works fine with ``gcc<4.9``.
2016-08-17 16:20:54 +00:00
****************
Docker container
****************
2016-08-17 16:47:27 +00:00
`Install <https://www.docker.com/products/overview>`_ docker and use this command to run Yandex.Tank:
2016-08-17 16:20:54 +00:00
2016-08-17 16:47:27 +00:00
.. code-block:: bash
2016-10-13 12:24:33 +00:00
docker run -v $(pwd):/var/loadtest -v $HOME/.ssh:/root/.ssh --net host -it direvius/yandex-tank
2016-08-17 16:20:54 +00:00
.. note::
``$HOME/.ssh`` is mounted in order for monitoring plugin to work. It uses your ssh keys to remotely login to monitored hosts
2016-02-18 12:30:32 +00:00
************************
2016-01-17 12:15:29 +00:00
Installation, from PyPi
2016-02-18 12:30:32 +00:00
************************
2016-08-17 16:20:54 +00:00
These are the packages that are required to build different python libraries. Install them with `apt`:
2016-01-17 12:15:29 +00:00
.. code-block:: bash
2016-08-17 16:20:54 +00:00
sudo apt-get install python-pip build-essential python-dev libffi-dev gfortran libssl-dev
2016-01-17 12:15:29 +00:00
2016-08-17 16:20:54 +00:00
Update your pip:
2016-01-17 12:15:29 +00:00
.. code-block:: bash
2016-08-17 16:20:54 +00:00
sudo -H pip install --upgrade pip
2016-01-17 12:15:29 +00:00
2016-08-17 16:20:54 +00:00
Update/install your setuptools:
2016-01-17 12:15:29 +00:00
.. code-block:: bash
2016-08-17 16:20:54 +00:00
sudo -H pip install --upgrade setuptools
Install latest Yandex.Tank from master branch:
.. code-block:: bash
sudo -H pip install https://api.github.com/repos/yandex/yandex-tank/tarball/master
You'll probably need Phantom load generator, so install it from our ppa:
2016-01-17 12:15:29 +00:00
.. code-block:: bash
sudo add-apt-repository ppa:yandex-load/main && sudo apt-get update
sudo apt-get install phantom phantom-ssl
2016-02-18 12:30:32 +00:00
****************************
2016-01-17 12:15:29 +00:00
Installation, .deb packages
2016-02-18 12:30:32 +00:00
****************************
2012-10-11 13:25:49 +00:00
2016-08-17 16:20:54 +00:00
.. note::
2017-02-09 12:51:01 +00:00
**Deprecated**. Deb packages aren't renewed in PPA.
2016-08-17 16:20:54 +00:00
2012-10-11 13:25:49 +00:00
You should add proper repositories on Debian-based environment.
For instance, add following repos to ``sources.list`` :
2012-10-11 14:02:55 +00:00
.. code-block:: bash
2016-02-18 12:30:32 +00:00
deb http://ppa.launchpad.net/yandex-load/main/ubuntu trusty main
deb-src http://ppa.launchpad.net/yandex-load/main/ubuntu trusty main
2012-10-11 14:02:55 +00:00
2016-02-18 12:30:32 +00:00
or this way
2012-10-11 14:02:55 +00:00
.. code-block:: bash
2016-02-18 12:30:32 +00:00
sudo apt-get install python-software-properties
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:yandex-load/main
2013-09-29 14:39:51 +00:00
2016-02-18 12:30:32 +00:00
Then update package list and install ``yandex-tank`` package:
2012-10-11 14:02:55 +00:00
.. code-block:: bash
2016-02-18 12:30:32 +00:00
sudo apt-get update && sudo apt-get install yandex-tank