Vinz is a SSH key management system leveraging ansible to handle a company-wide deployment of keys. Our objective is to remove the headache of managing SSH public keys for system administrators. This type of system is especially useful when leveraged in an environment with a lot of servers distributed in the cloud.
This project was originally created for a Software/Computer Engineering senior design project at Iowa State University in 2013. View more information about the project here.
Let's get everything set up.
You need to take care of a couple of things before getting started.
- Install Vagrant
- Install VirtualBox
- NOTE: There is a bug in VirtualBox 4.3
- Use 4.2 for now.
- Install Git
- Set up GitHub
We need to check out the code and get it on your machine locally. Make sure you keep track of where you check out the code so that you can make changes to it.
If you are on Windows, I would recommend GitHub for Windows
git clone git@github.com:mpdavis/vinz.git
Our dev environment takes place inside of a VM thanks to Vagrant. You don't have to pay much attention to this, because the code on your system is automatically synced to the right place in the VM. However, you do need to get the VM up and going before working.
On Windows, simply double-click run_vagrant.bat
This will take about a minute and a half depending on your machine and network connection. This creates the VM and installs everything needed in order to get it in a state that lets it run our code.
./run_vagrant.sh
At this point, the VM should be up and running. It already has a private network connection to your machine. You can see our application in a browser by going to http://10.13.37.2
The dev console will begin spitting out information related to the requests coming in.
If you edit the source code on the host machine, you can reload the webpage and see your changes.
This is simply written from memory. When (not if) you run into problems, let Michael know and he will update the README.