Overview

Using ansible to install and deploy

• clone this repo
• cd into unikernel-serverless/ansible

Architecure overview

Prerequisites

• All servers have ssh access with ssh keys copied to authorized_keys on each server (ansible requirement)
• Ansible has been installed on your local development system

Setup

Change the relevant variables in the setup.sh file. It replaces all vars needed by ansible

I initially used these vars in the inventory files but decided to move them. Feel free to change it.

Execute the convenience script.

./setup.sh

Install dependencies, build deploy and start unikernels

This assumes you have already built your serverless unikernels locally using the cli tool https://github.com/lmzuccarelli/rust-serverless-interface-cli

Execute the following playbooks (in the given order)

Setup local environment

# skip if you have rust installed locally
ansible-playbook rust.yml -i inventories/local

# install NanoVM ops binary
ansible-playbook unikernel.yml -i inventories/local 

Setup unikernel ecosystem on each node

ansible-playbook unikernel.yml -i inventories/servers

Copy and create instances of serverless unikernels

ansible-playbook serverless.yml -i inventories/servers --tags deploy

Ensure load balancer servers have keepalived installed

ansible-playbook keepalived.yml -i inventories/servers --tags check

Compile and build convey load-balancer unikernel locally

ansible-playbook load-balancers.yml -i inventories/local --tags fetch-build

# deploy to load balancer nodes
ansible-playbook load-balancers.yml -i inventories/servers --tags deploy

Verify using the vrrp (virtual router redundancy protocol) ip address (this may vary according to your keepalived.config)

curl -d'@files/payload.json' http://192.168.1.100/publish

Pipeline script

I have included a simple pipeline script that includes all the ansible playbooks as indicated above

Execute it using the relevant step

./pipeline.sh 1
./pipeline.sh 2
# and so on

Notes

For better performance I found that updating the following files (with suggested values)

This is Fedora/Centos specific

This is by no means an exhaustive list for fine tuning.

/etc/security/limits.conf

#<user>     <type>    <item>     <value>
*           soft      nofile     1048576
*           hard      nofile     1048576
root        soft      nofile     1048576
root        hard      nofile     1048576

/etc/sysctl.conf
fs.file-max = 1048576