# -*- 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://vagrantcloud.com/search. config.vm.box = "hashicorp/precise64" # [CL] Ubuntu Server 12.04 or Ubuntu 14.04 (Trusty Tahr) would be: # config.vm.box = "ubuntu/precise64" # config.vm.box = "ubuntu/trusty64" # [CL] Debian 8 (Jessie) or Debian 9 (Stretch): # config.vm.box = "debian/jessie64" # config.vm.box = "generic/debian9" # [CL] You can also specify a box version. # config.vm.box_version = "1.1.0" # Ubuntu 12.04 server latest version as of this writing is "v20170427.0.0". # There's no version string standard, e.g., debian/jessie64 latest="8.8.1". # You can see versions available on vagrantcloud and check current boxes: # vagrant box list # Add a new box with: # vagrant box add debian/jessie64 --box-version 8.8.1 # Provider & version are optional. Also, add boxes using a local .box file: # vagrant box add ~/boxes/nethack.box --name NetHack --provider virtualbox # or a repository for versions of boxes (served as 'application/json' MIME). # vagrant box add http://boxserv.internal/research/devel/nethack.json # Then use the names from the .json in your Vagrantfile(s). # config.vm.box = "sci-lab/nethack" # [CL] You can use custom URL in your Vagrantfile # config.vm.box_url = "http://files.vagrantup.com/precise64.box" # Boxes can be listed in Vagrant Cloud but served externally. # E.g., ubuntu/precice64 is served from cloud-images.ubuntu.com # Disable automatic box update checking. If you disable this, then # boxes will only be checked for updates when the user runs # `vagrant box outdated`. Not recommended, but saves me bandwidth and prevents # changes to dependencies mid dev cycle. Requesting a specific box version # should be used instead to facilitate groups of multiple developers. # 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. # NOTE: This will enable public access to the opened port # config.vm.network "forwarded_port", guest: 80, host: 8080 # Create a forwarded port mapping which allows access to a specific port # within the machine from a port on the host machine and only allow access # via 127.0.0.1 to disable public access # config.vm.network "forwarded_port", guest: 80, host: 8080, host_ip: "127.0.0.1" # 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" # [CL] This IP works on a 10.x.x.x network, but is only seen from localhost. # 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" # [CL] Make sure to use DHCP or configure the router for static IP above. # 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" # [CL] Project's ./ is already synched to /vagrant/ (not /home/vagrant/). # That's the shared directory implied by the term 'additional' above. # 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. # 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 # apt-get update # apt-get install -y apache2 # SHELL # [CL] Provisioning script begins running in /home/vagrant/, not /vagrant/. # Commands in here-doc (<<-SHELL ... SHELL) could be in an external file: # config.vm.provision :shell, path: "get-provisions.sh" # This path "get-provisions.sh" is relative to the project's dir (/vagrant/), # but remember that it starts running with working dir of: /home/vagrant/ # Provisioning scripts run as the root user, so you don't have to 'sudo'. # Files created by provisioning scripts will be owned by root if created in # the /home/vagrant/ or other non-shared directories, but files created in # the shared directory /vagrant/ will be owned by the vagrant user in the VM. # [CL] Vagrant runs provisioning on import; To force another provisioning do: # vagrant reload --provision # If you force reprovisioning then remember to check that the provisioning is # still correct on a freshly imported VM before publishing your changes: # vagrant destroy && vagrant up # [CL] Once done working with the VM, then do one of the following: # vagrant suspend - Save VM image: Eats disk usage but 'vagrant up' is fast. # vagrant halt - Shutdown takes less disk, but reboot is a bit slower. # vagrant destroy - Least disk space, but must reimport & provision to run. # Rule of thumb: Use 'halt' unless need to reprovision else boot is very slow. # Remember: suspend | halt | destroy VM before shutting down the host. end