Skip to end of metadata
Go to start of metadata


Overview

The Ariane distribution manager will help you to clone all necessary git projects and build a distribution.

This tool is available by cloning the following git repository : 

Developers considerations

Environment requirements

The tools needed by the distribution manager are the one you'll need for you day to day like working on Ariane so we advise you to install them.

To execute the Ariane distrib tool you need the following :

  • a Linux or OS.X environment (not tested in other OS currently)
  • python 3.3 in your path
  • pip3 or python3-pip
  • .... in order to install requests (http://docs.python-requests.org/en/latest/ - pip3 install requests)
  • git and maven in you path

Ariane repos fork

You don't need to fork all the Ariane git repositories as the Ariane distrib tool can do that for you. The only fork you need is the Ariane Distribution tool from github or stash.

Then execute the Ariane Distrib tool as you'll do for a Ariane distrib cloned repo and the tool will fork the other Ariane repositories for you. 

You'll be then able to provide us the pull requests you want on the Ariane project. 

DevOps / QA team considerations

Some time you don't want to install all the developpers tools to build your own Ariane distrib. Therefore we're now providing a docker image where the development pre-requisites are installed and from where you can clone and build a fresh Ariane Distrib from the Ariane master git repositories.

First of all you need docker installed on your system. Then, on some working directory :

Then you need a directory where to push the Ariane builds. Let's call it now $ARIANE_BUILDS and finally you can use ariane.buildenv to build Ariane distribution. 

Some examples : 

get Ariane distrib tool help  Expand source
build Ariane Core distrib  Expand source
build Ariane RabbitMQ plugin 0.2.2 for Ariane Core distrib 0.6.2  Expand source

 

You can finally execute any command from the Ariane Distrib Tool described bellow.

Ariane Distrib Tool Step by Step

Once all these requirements are meet then you can execute the tool :

Distribution manager

The distribution manager sub command helps you to manage Ariane distributions.

Plugins manager

The plugins manager sub command helps you to manage Ariane plugins.

 

Distribution packager

The distribution packager sub command helps you to build Ariane distributions. It will clone all Ariane repositories (tag or master depending on the version you define), build the libraries and package Ariane into a zip.



Then you're able to unzip the Ariane distrib and launch installer or continue to setup your development environment.

Plugin packager

The plugin packager sub command helps you to build Ariane plugins. It will clone the Ariane Plugin repository (tag or master depending on the version you define), build the libraries and package Ariane Plugin into a zip.

  • No labels