Repo Flavor

This is a set of chef cookbooks and roles to set up a base ColdFusion development environment via Vagrant.

Instructions

1. Install Vagrant

    $ gem install vagrant
   

2. Install their Lucid Box

    $ vagrant box add base http://files.vagrantup.com/lucid32.box
   

3. Create a new folder, initialize vagrant and checkout the chef repo. Vagrant will end up sharing this folder with the VM, which makes it handy for moving extraneous files around. Then, create a folder and move the CF installer in there.

    $ mkdir YOUR_FOLDER
    $ cd YOUR_FOLDER
    $ vagrant init
    $ git clone git@github.com:lewg/cfenv-chef.git
    $ mkdir cfinstaller
    $ cd cfinstaller
    $ cp YOUR_CF_INSTALLER .
    $ chmod 755 YOUR_CF_INSTALLER
   

4. Note: If your installer is NOT named ColdFusion_9_WWE_linux.bin you'll want to adjust the installer path/name in cfenv-chef/roles/cfserver.rb. Make sure you keep it somewhere in the /vagrant folder, because that's what's shared with the guest VM.

5. Modify the Vagrantfile to change the VM specs, base box, IP you'll access it on, and set up chef provisioning. Here are the relevant lines from my setup:

    # Every Vagrant virtual environment requires a box to build off of.
    config.vm.box = "lucid32"
   
    # Assign this VM to a host only network IP, allowing you to access it
    # via the IP.
    config.vm.network "33.33.33.50"
   
    # Boost the RAM slightly and give it a reasonable name
    config.vm.customize do |vm|
    	vm.memory_size = 512
    	vm.name = "CFEnv"
    end
   
    # Enable provisioning with chef solo, specifying a cookbooks path (relative
    # to this Vagrantfile), and adding some recipes and/or roles.
    #
    config.vm.provision :chef_solo do |chef|
    	chef.cookbooks_path = "cfenv-chef/cookbooks"
    	chef.roles_path = "cfenv-chef/roles"
    	chef.add_role "cfserver"
    end
   

6. Bring it up! (It takes a few minutes the first time.) When it's done you should have CF running on port 8500 of the ip you specified in the Vagrantfile. It's installed in /opt/coldfusion if you need to find it, and the administrator password is in the cfenv-chef/roles/cfserver.rb file (which you can change if you'd like).

    $ vagrant up
   

7. What I do after this is share folders into the CF root so I can edit locally, but run in the VM. Here's two examples which you can modify to your own taste (also in Vagrantfile). You'll see that I added the second one as an NFS mount. According to this page you should consider this as your working folder approaches 1,000 files. If you do use it, vagrant will ask for your primary machine password (for sudo) so it can export the NFS volume(s).

    config.vm.share_folder "site-one", "/opt/coldfusion/wwwroot/site-one", "~/Sites/site-one"
    config.vm.share_folder "site-two", "/opt/coldfusion/wwwroot/site-two", "~/Sites/site-two", :nfs => true
   

8. To see your changes to the file shares, run a vagrant reload. If you modify the chef stuff, you can run a vagrant provision to kick off a chef run. Because of the way I set up the chef recipe, that will also have the side effect of restarting CF. Just for reference, you can log into the box with vagrant ssh. That's it!

More Info

This little repo is merely standing on the shoulders of giants. If you're not familiar with Chef, I suggest you take a look here. And here for Vagrant. Very cool projects.