cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Document how to upgrade to ansible with pip (#70768)

Browse source 
Fixes #70348
This commit is contained in:
Baptiste Mille-Mathias 2020-07-31 19:13:54 +02:00 committed by GitHub
parent 75e8da0950
commit 5019335660
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
docs/docsite/rst/installation_guide/intro_installation.rst
View file

@ -324,6 +324,34 @@ If you wish to install Ansible globally, run the following commands::
Please make sure you have the latest version of ``pip`` before installing Ansible. Please make sure you have the latest version of ``pip`` before installing Ansible.
If you have an older version of ``pip`` installed, you can upgrade by following `pip's upgrade instructions <https://pip.pypa.io/en/stable/installing/#upgrading-pip>`_ . If you have an older version of ``pip`` installed, you can upgrade by following `pip's upgrade instructions <https://pip.pypa.io/en/stable/installing/#upgrading-pip>`_ .
Upgrading Ansible from version 2.9 and lower to version 2.10 or later
---------------------------------------------------------------------
Starting version 2.10, Ansible is made of two packages, and upgrading directly from previous minor version (`2.9.*
` and below) using ``pip`` is blocked to prevent leaving Ansible broken.
Trying to upgrade will display the following message, and no change will be performed:
.. code-block:: console
Cannot install ansible-base with a pre-existing ansible==2.x installation.
Installing ansible-base with ansible-2.9 or older currently installed with
pip is known to cause problems. Please uninstall ansible and install the new
version:
pip uninstall ansible
pip install ansible-base
...
As explained by the message, to upgrade you must first remove the version of Ansible installed and then install it
to the latest version.
.. code-block:: console
$ pip uninstall ansible
$ pip install ansible
.. _from_pip_devel: .. _from_pip_devel:
Installing the development version of Ansible Installing the development version of Ansible