butterops / shinn

Smart dev machine for enterprise teams. Also in use at ButterOps.

ShInn

ShInn is a well architected Virtual Machine as code for development teams.

Under the hood ShInn utilizes VirtualBox, Vagrant and Ansible for smooth development workflow across your organization/team.

Usage in dev workflow

ShInn provides a workflow to developers where they should feel free to Remove, Destroy and Up the virtual machine without worrying to have missed progess in projects. Learn more...

ShInn Setup

For Windows Users: Install Ansible on windows

Developers must do this on their machines

• Install VirtualBox, Vagrant and Asnible.
• Create a ~/Projects/ButterOps directory. Name is case sensitive.
• SSH keygen at your machine ssh-keygen -t rsa
• Add ssh public key to your account in Github / Bitbucket/ Gitlab / Self-hosted git service.

cd ~/Projects/ButterOps
git clone [email protected]:butterops/shinn
cd shinn
ansible-galaxy install -r req.yml
vagrant up

Project setup

Developers must do this inside ShInn. Make sure to clone from SSH url, for they provide passowrd less auth.

vagrant ssh
cd ~/Projects
git clone [email protected]:butterops/*.git

OPTIONAL - Access ShInn by it's local ip name

Append this to ~/.bash_profile or equivalent of your Host OS

function shinn() {
    ( ssh [email protected] -p 2222 $* )
}

And/Or (for Linux and MacOS) alias shinn='ssh [email protected] -p 2222 -X'

Developers get to access the ShInn by its own command like below

shinn 'ls ~/Projects'

Future extensions

• Add support for secrets/env variables.
• Add aws-cli configuration provision.

Sample expected login output

Kumars-MBP:~ kgaurav$ shinn
Welcome to Ubuntu 20.04.1 LTS (GNU/Linux 5.4.0-47-generic x86_64)

     _______. __    __   __  .__   __. .__   __. 
    /       ||  |  |  | |  | |  \ |  | |  \ |  | 
   |   (----`|  |__|  | |  | |   \|  | |   \|  | 
    \   \    |   __   | |  | |  . `  | |  . `  | 
.----)   |   |  |  |  | |  | |  |\   | |  |\   | 
|_______/    |__|  |__| |__| |__| \__| |__| \__| 
                                                 
https://shinn.butterops.dev

30 updates can be installed immediately.
8 of these updates are security updates.
To see these additional updates run: apt list --upgradable


Last login: Fri Sep 18 11:52:23 2020 from 10.0.2.2
vagrant@shinn:~$