Deployment Guide

(Work in progress..)

What do you need:

all you need is an ansible master VM, with installed:

To install Ansible, you can you pip:

sudo pip install ansible

Ansible script are idempotent. You can use them into a new VM or into an existing platform (to update it or to change some parameters).

To prepare a new platform, there are some directory and files to prepare:

group_vars/new
inventory/new

To prepare eduTEAMS platform, you must copy the following directories. Replace "new" with the name that was chosen for the platform.

group_vars/EXAMPLE
inventory/EXAMPLE

After new platform is ready, you have to modify some files:

FILE: group_vars/EXAMPLE/secrets.yml

Secrets contains all important data. After changing the fields, you must encrypt it through ansible-vault

COMMAND: ansible-vault encrypt group_vars/EXAMPLE/secrets.yml

You must provide a new password (PASSWORD)

DIRECTORY: group/vars/EXAMPLE/logos

Those directory contains all static images

DIRECTORY: group/vars/EXAMPLE/certs

Add all certificates files inside this directory (It is recommended to encrypt all those files with ansible-vault)

inventory/EXAMPLE/teip.yml

Add idhub URL or IP address, then add the platform name.

playbook/teipservers.yml

Edit variables with all set desired for the new platform

After all files are ready, you can start ansible:

ansible-playbook -v -i inventory/EXAMPLE/teip.yml playbook/site.yml --ask-vault-pass