You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
With the `2020-resolver` requirement removed in #1151, installation in
virtualenv will fail due older pip versions not using the new
dependency resolver by default[1].
This commit updates the docs such that users always need to upgrade
`pip`, either in a local or `virtualenv` environments prior to esrally
installation.
[1] https://discuss.python.org/t/announcement-pip-20-3-release/5948
Relates #1184
You can also use Virtualenv to install Rally into an isolated Python environment without sudo.
122
123
123
-
1. Set up a new virtualenv environment in a directory with ``python3 -m venv .``
124
-
2. Activate the environment with ``source /path/to/virtualenv/dir/bin/activate``
125
-
3. Install Rally with ``python3 -m pip install esrally``
124
+
1. Set up a new virtualenv environment in a directory with ``python3 -m venv .venv``
125
+
2. Activate the environment with ``source /path/to/virtualenv/.venv/bin/activate``
126
+
3. Ensure pip is the latest version: ``python3 -m pip install --upgrade pip``
127
+
.. important::
128
+
Omitting this step might cause the next step (Rally installation) to fail due to broken dependencies. The pip version must be at minimum ``20.3``.
129
+
4. Install Rally with ``python3 -m pip install esrally``
126
130
127
131
Whenever you want to use Rally, run the activation script (step 2 above) first. When you are done, simply execute ``deactivate`` in the shell to exit the virtual environment.
0 commit comments