For simple development tasks, CommandBox provides an embedded development server which is easy to get started, however it is not suitable for running production servers. For those that wish to develop locally with a full VM that mirrors a normal production environemnt, Vagrant is a useful tool for this.
Vagrant simply wraps a VirtualBox VM and provides easy to use networking and file synchronization between a development environment and the VM. It also provides hooks for scripting automated setups of an environment.
A full features Vagrant setup example can be found here: https://github.com/Ortus-Solutions/vagrant-centos-lucee
This vagrant file cane be used to configure a VM and install Lucee. This section does not go into the specific of using Vagrant, for that follow a Vagrant Tutorial . This vagrant file below uses a CentOS 6 VM and is not security hardended, it is only intended for development purposes. It installs Lucee, Apache and MySQL, which is a common configuration.
```
# -*- mode: ruby -*-
# vi: set ft=ruby :
# All Vagrant configuration is done below. The "2" in Vagrant.configure
# configures the configuration version (we support older styles for
# backwards compatibility). Please don't change it unless you know what
# you're doing.
Vagrant.configure(2) do |config|
# The most common configuration options are documented and commented below.
# For a complete reference, please see the online documentation at
# https://docs.vagrantup.com.
# Every Vagrant development environment requires a box. You can search for
# boxes at https://atlas.hashicorp.com/search.
config.vm.box = "nrel/CentOS-6.5-x86_64"
# Disable automatic box update checking. If you disable this, then
# boxes will only be checked for updates when the user runs
# `vagrant box outdated`. This is not recommended.
# config.vm.box_check_update = false
# Create a forwarded port mapping which allows access to a specific port
# within the machine from a port on the host machine. In the example below,
# accessing "localhost:8080" will access port 80 on the guest machine.
# config.vm.network "forwarded_port", guest: 80, host: 8080
# Create a private network, which allows host-only access to the machine
# using a specific IP.
config.vm.network "private_network", ip: "192.168.33.10"
# Create a public network, which generally matched to bridged network.
# Bridged networks make the machine appear as another physical device on
# your network.
# config.vm.network "public_network"
# Share an additional folder to the guest VM. The first argument is
# the path on the host to the actual folder. The second argument is
# the path on the guest to mount the folder. And the optional third
# argument is a set of non-required options.
# config.vm.synced_folder "../data", "/vagrant_data"
config.vm.synced_folder "../", "/var/www/"
# Provider-specific configuration so you can fine-tune various
# backing providers for Vagrant. These expose provider-specific options.
# Example for VirtualBox:
#
# config.vm.provider "virtualbox" do |vb|
# # Display the VirtualBox GUI when booting the machine
# vb.gui = true
#
# # Customize the amount of memory on the VM:
# vb.memory = "1024"
# end
#
# View the documentation for the provider you are using for more
# information on available options.
# Define a Vagrant Push strategy for pushing to Atlas. Other push strategies
# such as FTP and Heroku are also available. See the documentation at
# https://docs.vagrantup.com/v2/push/atlas.html for more information.
# config.push.define "atlas" do |push|
# push.app = "YOUR_ATLAS_USERNAME/YOUR_APPLICATION_NAME"
# end
# Enable provisioning with a shell script. Additional provisioners such as
# Puppet, Chef, Ansible, Salt, and Docker are also available. Please see the
# documentation for more information about their specific syntax and use.
config.vm.provision "shell", inline: <<-shell 143="" 345="" 755="" 123456="" pwd="" #install="" apache="" server="" sudo="" yum="" -y="" install="" httpd="" #for="" development="" purposes,="" turn="" off="" the="" firewall="" service="" iptables="" save="" stop="" chkconfig="" mysql="" mysql-server="" --level="" mysqld="" on="" #download="" lucee.="" change="" url="" to="" latest="" versions="" from="" http:="" lucee.org="" downloads.html="" wget="" d8yjolse1mixx.cloudfront.net="" downloader.cfm="" id="" file="" lucee-4.5.2.018-pl0-linux-x64-installer.run="" #make="" installer="" executable="" chmod="" #run="" in="" unattended="" mode="" and="" set="" admin="" password="" .="" --mode="" --railopass="" nano="" text="" editor="" #backup="" http="" conf="" because="" we="" are="" going="" edit="" it="" cp="" etc="" httpd.conf="" httpd.conf.bak="" #when="" running="" vms,="" caching="" static="" files="" (js,="" css,="" images)="" that="" servers="" over="" network="" host="" os.="" turning="" mmap="" sendfile="" stops="" this="" sed="" -i="" -e="" 's="" #enablemmap="" enablemmap="" g'="" #enable="" enable="" #add="" index.cfm="" directory="" index="" directoryindex="" index.html="" index.html.var="" shell="" an="" additional="" provisioner="" start="" apache.="" relies="" mounted="" folders="" vagrant="" creates,="" will="" fail="" initial="" boot="" config.vm.provision="" "shell",="" inline:="" "apachectl="" start",="" run:="" "always"="" end="" ```="" <="" noscript="">