Skip to content

Latest commit

 

History

History
107 lines (75 loc) · 3.42 KB

README.md

File metadata and controls

107 lines (75 loc) · 3.42 KB

Ansible Collection - tonykay.envy

Ansible Envy (ENVironments in Yaml) collection - single system ansible centric container orchestration biased towards labs, workshops, PoCs, and development. Need 5 Linux machines to test you latest idea or code - use envy.

Installing this collection

Currently Envy is not released as a full Ansible collection and cannot be downloaded from Ansible Galaxy

Pre-Requisites

It is assumed that you already have installed:

  • Ansible 2.9 or greater (yum | dnf | brew install ansible)
  • Docker
  • Git

Installing manually

$ ansible-galaxy collection install community.docker
$ mkdir -p ~/.ansible/collections/ansible_collections/tonykay/envy
$ git clone https://github.com/tonykay/tonykay.envy.git \
      ~/.ansible/collections/ansible_collections/tonykay/envy
$ pip install docker       
$ ansible-playbook ~/.ansible/collections/ansible_collections/tonykay/envy/playbooks/setup.yml \
       --become-method sudo --ask-become-pass

NOTE

The --become-method sudo --ask-become-pass on the final, setup, command may well be redundant but on many Mac setups passwordless sudo is not the norm.


Verifying your installation

Verify you can execute the nv command

$ nv
USAGE: nv <action> <object> <extras>

nv add <environment> <addon>            Add extra instance(s)
nv clean                                Clean up old resources
nv deploy <environment>                 Deploy an Environment
nv delete <environment>                 Delete an Environment
nv fromfile <filename>                  Deploy an Environments from file
nv list                                 List running infrastructure
nv login <target>                       Login to any instance with bash shell
nv redeploy <environment>               Destroy and Redeploy an Environment
nv remove <environment>  <target>       Remove an instance from a config
nv replace <environment>  <target>      Destroy and Redeploy an Environment
nv setup                                Reconfigure nv

Verify you can deploy a docker based Environment

This will deploy a simple multi-node environment to your local system.


NOTE This is based on publicly available images being pulled from dockerhub.io or quay.io so first launch may take a few minutes. (nv preload is coming which will allow images to be pulled at install time)

$ nv deploy multi
$ nv list

You know have access to all those instances with ssh <instance-name>. Each instance has ssh access to all the others.

Updating envy

As envy is currently a git repo and not installed from galaxy updates are a simple but 2 phase process.

$ cd ~/.ansible/collections/ansible_collections/tonykay/envy
$ git pull --rebase
$ ansible-playbook ~/.ansible/collections/ansible_collections/tonykay/envy/playbooks/setup.yml \
       --become-method sudo --ask-become-pass