You can follow the instructions on the Ansible website or either of the options below:
sudo easy_install pip
sudo pip install ansible
brew install ansible
sudo apt-get install python-yaml python-markupsafe nfs-kernel-server nfs-common portmap
sudo apt-get install software-properties-common
Test to see if ansible is installed using ansible --version If it is not installed, do the following:
sudo apt-add-repository ppa:ansible/ansible
sudo apt-get update
sudo apt-get install ansible
yum install ansible
Download VirtualBox and install.
Download Vagrant and install.
Go to directory you want clone into. For example, if you want to clone into /someuser/myapps/
You could do: cd /someuser/myapps/
Then type below:
git clone https://github.com/webapp-builders/groundwork.git
cd groundwork
You can confirm that you are in the correct directory by typing ls.
If you see a file Vagrantfile you are in the correct directory.
Note: If you are using ubuntu as your primary OS, uncomment line 22 to use the VirtualBox GUI.
Note: If your computer only supports 32-bit operating systems, after cd groundwork, open the file: Vagrantfile
Comment out line 3 and uncomment line 5 to use "ubuntu/trusty64"
(this will tell VirtualBox to run the "precise32" operating system).
vagrant up
READ Below for possible "terminal messages":
Numerous messages and errors may occur once typing vagrant up.
Read the following Terminal Message 1 and Terminal Message 2, to make sure you are on the right track.
Terminal Message 1: If your terminal seems to be "stuck" at TASK: rvm... just wait. This might take a while, because you are installing Ruby using RVM. This is a good sign. It means everything is installing properly.
Terminal Message 2: You many receive an error if you already have Rail or Postgresql running on your machine.
This means you need to stop Rails and/or Postgresql.
An error might look like the following:
Vagrant cannot forward the specified ports on this VM, since they
would collide with some other application that is already listening
on these ports. The forwarded port to 5432 is already in use
on the host machine.
To fix this, modify your current projects Vagrantfile to use another
port. Example, where '1234' would be replaced by a unique host port:
config.vm.network :forwarded_port, guest: 5432, host: 1234
Sometimes, Vagrant will attempt to auto-correct this for you. In this
case, Vagrant was unable to. This is usually because the guest machine
is in a state which doesn't allow modifying port forwarding.
For Rails server, find the terminal window that is running Rails locally and press ctrl+c together.
You may not realize it, but Postgres might have started automatically at startup.
If Postgresql is running, to stop your:
For Ubuntu:
sudo service postgresql stop
For OSX homebrew:
Go online, search for "how to stop postgresql osx"
(There will be different instructions depending on how your Mac is setup).
(You may skip this command for a first time install)
Upon subsequent updates, you may want to use:
vagrant provision
"vagrant provision" may be used for two reasons:
A. If for any reason, you had stopped through the process and want to continue where you left off.
B. If you update your ansible recipe, and you want to update your virtual machine.
vagrant ssh
Your terminal prompt should change from your normal one.
If you want to use your own application (like the hartl tutorial, for example), do the necessary steps you do and skip to step 10. If you are not using rails, then skip to Step 11.
cd /vagrant/application/web
bundle install
rails server -b 33.33.33.33
Go to your browser and open http://10.10.10.10:3000
Your web directory is at application/html. You can add/replace this with your own content. The site is accessible at http://10.10.10.10