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
$ 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.