|author||Vencislav Atanasov <firstname.lastname@example.org>||2017-05-01 22:57:01 +0300|
|committer||Franklin Wei <email@example.com>||2019-07-26 20:20:07 -0400|
Add Vagrant configuration for creating a development VM
Vagrant is an application that automates creation and provisioning of a virtual machine for development. The config here creates an Ubuntu 16.04 LTS machine, updates it, downloads and installs the toolchains for sh, m68k and arm, mingw-w64, SDL (for Windows simulators) and other packages needed for building Rockbox. It works fine for building a Windows simulator and compiling iPod classic binaries. It should be possible to make the other build types, too. MIPS toolchain fails to build, ARM-APP is not tested because the files download very slow on my connection. Please test if it works for you, and let me know. Quick start: download and install Vagrant and VirtualBox for your operating system, make sure VT-x / AMD-V is enabled in your BIOS/EFI setup, open a shell in rockbox/tools and input the command "vagrant up" Change-Id: Ief5476ab066663a4db7e85404b25d2d781d90532
Diffstat (limited to 'tools/Vagrantfile')
1 files changed, 90 insertions, 0 deletions
diff --git a/tools/Vagrantfile b/tools/Vagrantfile
new file mode 100644
@@ -0,0 +1,90 @@
+# -*- 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 = "ubuntu/xenial64"
+ # 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 "..", "/rockbox"
+ # 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"
+ vb.name = "rockbox-dev"
+ # 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
+ # apt-get update
+ # apt-get install -y apache2
+ # SHELL
+ config.vm.provision "shell" do |s|
+ s.name = "provision"
+ s.inline = "/rockbox/tools/vagrant/provision.sh"
+ config.vm.provision "shell", privileged: false do |s|
+ s.name = "provision-nonprivileged"
+ s.inline = "/rockbox/tools/vagrant/provision-nonprivileged.sh"
+ config.vm.provision "shell", run: "always" do |s|
+ s.name = "startup"
+ s.inline = "/rockbox/tools/vagrant/startup.sh"
+ # Other options
+ config.vm.hostname = "rockbox-dev"