Armada installation

Armada currently runs only on Linux with Docker installed.
If you want to learn and play with Armada on your own machine (whether it's Windows, Mac or Linux) you can do it using e.g. Vagrant box. Install VirtualBox, Vagrant and vagrant-vbguest plugin. Then:

$ curl -sLO http://vagrant.armada.sh/Vagrantfile
$ vagrant up
$ vagrant ssh

If you don't have curl available, you can download it from here.

To run Armada natively on Linux, first install Docker, then run the installation script:

$ bash <(curl -sL http://armada.sh/install)

Armada runs within its own docker container, which you can see by running docker ps | grep armada. To verify the installation try running armada --help. You should see Armada command line tool help page:

$ armada --help
usage: armada.py [-h] [--version] {name,join,promote,shutdown,dockyard,list,info,run,stop,restart,recover,ssh,build,push,create,version,diagnose} ... positional arguments: {name,join,promote,shutdown,dockyard,list,info,run,stop,restart,recover,ssh,build,push,create,version,diagnose} name get/set name for this ship join join another armada promote promote ship to commander role shutdown gently remove ship from armada and prepare for service shutdown dockyard manage dockyard aliases list show list of running microservices info show list of ships within current armada run run container with microservice stop stop container with microservice restart restart container with microservice recover run containers from JSON file with saved containers' parameters ssh ssh into container with microservice build build container with microservice push push container with microservice to dockyard create create skeleton for new microservice version display armada version diagnose run diagnostic check on a container optional arguments: -h, --help show this help message and exit --version show program's version number and exit

If everything looks good, we can get our feet wet and go run some services!

If not, check /var/log/armada/armada-runner.log. If the armada docker container did not run, the armada command will not work.