examples

Armour Examples

The following examples are available:

• data-plane/ : a minimal example without a control plane.
• control-plane/ : an example of Armour running with a control plane.
• multi-host/ : an example of Armour running with a distributed setup (two VMs).
• arm-qemu/ : an example of Armour running on Raspbian Pi OS using the QEMU Arm emulator.
• k3s/ : an example of Armour running on k3s.
• bookinfo/ : a Full application running with Armour on k3s.
• minikube/ : an example of Armour running on k8s using minikube.

Each of these examples has been tested on a Mac (though this is not essential) that is setup as follows.

Vagrant Installation and Setup

Download and install Vagrant.

By default Vagrant will be installed under /opt/vagrant.
To uninstall follow these instructions.

Alternatively, you can install Vagrant using Homebrew:

host$ brew cask install vagrant

Then install the docker compose plugin

host$ vagrant plugin install vagrant-docker-compose

The following brings up the Vagrant VM. The script also installs rust and builds Armour binaries within the VM.

host$ cd armour/examples
host$ ./setup.sh

Note: After the initial setup, the VM can be stopped, started, paused, resumed and deleted with:
host$ vagrant halt
host$ vagrant up
host$ vagrant pause
host$ vagrant resume
host$ vagrant destroy