ansible/rst/modules/easy_install.rst

31 lines
1.6 KiB
ReStructuredText
Raw Normal View History

.. _easy_install:
easy_install
````````````
.. versionadded:: 0.7
The easy_install module installs Python libraries.
+--------------------+----------+---------+----------------------------------------------------------------------------+
| parameter | required | default | comments |
+====================+==========+=========+============================================================================+
| name | yes | | a Python library name |
+--------------------+----------+---------+----------------------------------------------------------------------------+
| virtualenv | no | | an optional virtualenv directory path to install into, if the virtualenv |
| | | | does not exist it is created automatically |
+--------------------+----------+---------+----------------------------------------------------------------------------+
Please note that the easy_install command can only install Python libraries.
Thus this module is not able to remove libraries. It is generally recommended to
use the :ref:`pip` module which you can first install using easy_install.
Also note that `virtualenv <http://www.virtualenv.org/>`_ must be installed on
the remote host if the `virtualenv` parameter is specified.
Example action from Ansible :doc:`playbooks`::
easy_install name=pip
easy_install name=flask==0.8
easy_install name=flask virtualenv=/srv/webapps/my_app/venv