You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ariatosca.apache.org by ra...@apache.org on 2017/06/21 15:05:24 UTC
incubator-ariatosca git commit: ARIA-283 Update readme installation
instructions
Repository: incubator-ariatosca
Updated Branches:
refs/heads/ARIA-283-update-readme-installation-instructions [created] f786a73dd
ARIA-283 Update readme installation instructions
Project: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/commit/f786a73d
Tree: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/tree/f786a73d
Diff: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/diff/f786a73d
Branch: refs/heads/ARIA-283-update-readme-installation-instructions
Commit: f786a73dd4b2ac2fc56b71e5a9649a4f9ab840f7
Parents: 9907520
Author: Ran Ziv <ra...@gigaspaces.com>
Authored: Wed Jun 21 18:05:05 2017 +0300
Committer: Ran Ziv <ra...@gigaspaces.com>
Committed: Wed Jun 21 18:05:05 2017 +0300
----------------------------------------------------------------------
README.rst | 63 ++++++++++++++++++++++++++++++++++++++++-----------------
1 file changed, 44 insertions(+), 19 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/blob/f786a73d/README.rst
----------------------------------------------------------------------
diff --git a/README.rst b/README.rst
index 8af13a5..3aa62fe 100644
--- a/README.rst
+++ b/README.rst
@@ -26,37 +26,62 @@ ARIA is an incubation project under the `Apache Software Foundation <https://www
Installation
------------
-ARIA is `available on PyPI <https://pypi.python.org/pypi/ariatosca>`__.
+ARIA is `available on PyPI <https://pypi.python.org/pypi/apache-ariatosca>`__.
+
+ARIA requires Python 2.6/2.7. Python 3 is currently not supported.
To install ARIA directly from PyPI (using a ``wheel``), use::
- pip install aria
+ pip install --upgrade pip setuptools
+ pip install apache-ariatosca
To install ARIA from source, download the source tarball from
-`PyPI <https://pypi.python.org/pypi/ariatosca>`__, extract it, and then when inside the extracted
-directory, use::
+`PyPI <https://pypi.python.org/pypi/apache-ariatosca>`__, extract it, and run::
- pip install .
+ pip install --upgrade pip setuptools
+ pip install incubator-ariatosca
The source package comes along with relevant examples, documentation, ``requirements.txt`` (for
installing specifically the frozen dependencies' versions with which ARIA was tested) and more.
-Note that for the ``pip install`` commands mentioned above, you must use a privileged user, or use
-virtualenv.
-ARIA itself is in a ``wheel`` format compatible with all platforms. Some dependencies, however,
-might require compilation (based on a given platform), and therefore possibly some system
-dependencies are required as well.
+ARIA has additional optional dependencies. These are required for running operations over SSH.
+Below are instructions on how to install these dependencies, including required system dependencies
+per OS.
+
+Note: These dependencies may have varying licenses which may not be compatible with Apache license 2.0.
+
+
+Ubuntu/Debian (tested on Ubuntu14.04, Ubuntu16.04)::
+
+ apt-get install -y python-dev gcc libffi-dev libssl-dev
+ pip install aria[ssh]
+
+Centos (tested on Centos6.6, Centos7)::
+
+ yum install -y python-devel gcc libffi-devel openssl-devel
+ pip install aria[ssh]
+
+Archlinux::
+
+ pacman -Syu --noconfirm python2 gcc libffi openssl
+ pip2 install aria[ssh]
+
+Windows (tested on Win10)::
+
+ # no additional system requirements are needed
+ pip install aria[ssh]
+
+MacOS::
-On Ubuntu or other Debian-based systems::
+ # TODO
- sudo apt install python-setuptools python-dev build-essential libssl-dev libffi-dev
-On Archlinux::
- sudo pacman -S python-setuptools
+To install ``pip``, either use your distro's package management system, or run:
-ARIA requires Python 2.6/2.7. Python 3+ is currently not supported.
+ wget http://bootstrap.pypa.io/get-pip.py
+ python get-pip.py
Getting Started
@@ -129,10 +154,10 @@ ARIA is licensed under the
:target: https://ci.appveyor.com/project/ApacheSoftwareFoundation/incubator-ariatosca/history
.. |License| image:: https://img.shields.io/github/license/apache/incubator-ariatosca.svg
:target: http://www.apache.org/licenses/LICENSE-2.0
-.. |PyPI release| image:: https://img.shields.io/pypi/v/ariatosca.svg
- :target: https://pypi.python.org/pypi/ariatosca
-.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/ariatosca.svg
-.. |Wheel| image:: https://img.shields.io/pypi/wheel/ariatosca.svg
+.. |PyPI release| image:: https://img.shields.io/pypi/v/apache-ariatosca.svg
+ :target: https://pypi.python.org/pypi/apache-ariatosca
+.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/apache-ariatosca.svg
+.. |Wheel| image:: https://img.shields.io/pypi/wheel/apache-ariatosca.svg
.. |Contributors| image:: https://img.shields.io/github/contributors/apache/incubator-ariatosca.svg
.. |Open Pull Requests| image:: https://img.shields.io/github/issues-pr/apache/incubator-ariatosca.svg
:target: https://github.com/apache/incubator-ariatosca/pulls