Giter Club home page Giter Club logo

incubator-ariatosca's Introduction

ARIA

Build Status Appveyor Build Status License PyPI release Python Versions Wheel Contributors Open Pull Requests Closed Pull Requests

What is ARIA?

ARIA is a an open-source, TOSCA-based, lightweight library and CLI for orchestration and for consumption by projects building TOSCA-based solutions for resources and services orchestration.

ARIA can be utilized by any organization that wants to implement TOSCA-based orchestration in its solutions, whether a multi-cloud enterprise application, or an NFV or SDN solution for multiple virtual infrastructure managers.

With ARIA, you can utilize TOSCA's cloud portability out-of-the-box, to develop, test and run your applications, from template to deployment.

ARIA is an incubation project under the Apache Software Foundation.

Installation

ARIA is available on PyPI.

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 --upgrade pip setuptools
pip install apache-ariatosca

To install ARIA from source, download the source tarball from PyPI, extract and cd into the extract dir, and run:

pip install --upgrade pip setuptools
pip install .
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.


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:

# TODO

To install pip, either use your distro's package management system, or run:

wget http://bootstrap.pypa.io/get-pip.py
python get-pip.py

Getting Started

This section will describe how to run a simple "Hello World" example.

First, provide ARIA with the ARIA "hello world" service-template and name it (e.g. my-service-template):

aria service-templates store examples/hello-world/helloworld.yaml my-service-template

Now create a service based on this service-template and name it (e.g. my-service):

aria services create my-service -t my-service-template

Finally, start an install workflow execution on my-service like so:

aria executions start install -s my-service

You should now have a simple web-server running on your local machine. You can try visiting http://localhost:9090 to view your deployed application.

To uninstall and clean your environment, follow these steps:

aria executions start uninstall -s my-service
aria services delete my-service
aria service-templates delete my-service-template

Contribution

You are welcome and encouraged to participate and contribute to the ARIA project.

Please see our guide to Contributing to ARIA.

Feel free to also provide feedback on the mailing lists (see Resources section).

Resources

Subscribe by sending a mail to <group>[email protected] (e.g. [email protected]). See information on how to subscribe to mailing lists here.

For past correspondence, see the dev mailing list archive.

License

ARIA is licensed under the Apache License 2.0.

incubator-ariatosca's People

Contributors

mxmrlv avatar tliron avatar aviaefrat avatar tnadeauaria avatar dankilman avatar cloudewayne avatar johnament avatar vishwanathj avatar azbarcea avatar djay87 avatar venkatesanvenugopal avatar nirbir avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.