Remove vm/ folder
These instructions are 7 years old, and not useful any more.
Change-Id: Ie08da4cb604c2034b843ec8c3b7e6e988920b60b
Signed-off-by: James Kuszmaul <jabukuszmaul+collab@gmail.com>
diff --git a/vm/README.md b/vm/README.md
deleted file mode 100644
index ee9d9aa..0000000
--- a/vm/README.md
+++ /dev/null
@@ -1,180 +0,0 @@
-Setting up a Virtual Machine (VM)
-================================================================================
-This document tries to document three ways in which you can set up a
-development environment. The third is essentially the same as the second so
-this document will just focus on the first and second way.
-
-1. Use the vagrant scripts to automatically create everything.
-2. Create a VM manually and set it up manually.
-3. Install Debian natively and set it up manually.
-
-Using the vagrant scripts requires more setup, but generally is more hands-off.
-Setting up a VM manually can be more rewarding and interesting, but requires
-more manual steps and generally takes longer.
-
-Command line knowledge
---------------------------------------------------------------------------------
-Some basic knowledge of using your terminal is required. On Windows, cmd.exe is
-a good start. I would recommend setting up git-bash because it will resemble
-the environment inside the VM much more closely than cmd.exe.
-
-Whenever you see `$` in a code segment below, please type that into your
-terminal. `$` is just a generic representation of what we call the "command
-prompt". On Windows' cmd.exe it would look something like this:
-
- C:\Users\YourName>
-
-On a UNIX-like Operating System (e.g. Linux, OSX) it may look more like this:
-
- yourname@hostname ~ $
-
-The `$` is just a shortcut to represent any style of prompt. When you see
-something like `$ echo Hello` below please type everything after the `$ ` into
-your terminal. In this case that means typing "echo Hello" and pressing Enter.
-
-Access to the Gerrit repository
---------------------------------------------------------------------------------
-In order to use the setup scripts you'll need access to the 971-Robot-Code
-repository on gerrit:
-<https://robotics.mvla.net/gerrit/#/admin/projects/971-Robot-Code>
-
-Please ask your mentors about getting access. If you already have access,
-great!
-
-In general I recommend setting up an SSH key to pull from and push to the
-repository. You can also use HTTPS-based passwords, but it's a little more
-annoying to use in the long term. See the "How to Generate an SSH key" section
-on [gerrit's SSH page](https://robotics.mvla.net/gerrit/#/settings/ssh-keys)
-for more details.
-
-
-Using Vagrant
-================================================================================
-
-Requirements
---------------------------------------------------------------------------------
-These requirements apply to all Operating Systems. The individual setup steps
-may differ. For example, on Debian you can run `apt-get install virtualbox`
-whereas on Windows and OSX you have to download a dedicated installer.
-
-1. Basic knowledge of the command line. See the "Command line knowledge"
- section above.
-
-2. Install Vagrant <https://www.vagrantup.com/downloads.html>
- - Please install this from the website as anything in, say, an apt repo
- would be quite outdated.
-
-3. Install VirtualBox <https://www.virtualbox.org/wiki/Downloads>
- - On Debian you should install this via `apt-get` since it's integrated
- really well. On another OS please use the downloaded installer.
-
-4. Install git <https://git-scm.com/downloads>
- - On Debian you should install this via `apt-get`. On another OS please use
- the downloaded installer.
- - On Windows, I would recommend installing something called "git-bash" at
- the same time. It will provide you with a better terminal experience than
- `cmd.exe` to perform the majority of the remaining steps.
-
-5. Add `vagrant`, `VBoxManage`, and `git` to your PATH.
- - This is most likely already done by the installation binaries.
- It's added to the system path.
- - To test this, type these commands in a terminal:
-
- $ vagrant --version
- Vagrant 1.8.1
- $ VBoxManage --version
- 5.0.14r105127
- $ git --version
- git version 2.11.0
-
- - You may need to log out and back in for the PATH modifications to take
- effect.
-
-Usage
---------------------------------------------------------------------------------
-1. Check this folder out on your computer somewhere.
-
- $ git clone ssh://USERNAME@robotics.mvla.net:29418/971-Robot-Code
-
- where you replace `USERNAME` with your own username. Keep in mind that you
- need your SVN and Gerrit account set up for this to work. Ask the mentors or
- other students about this if you don't have one yet.
-
-2. Go into the directory and build the VM.
-
- $ cd 971-Robot-Code/vm/
- $ vagrant up
-
- Some errors during the `vagrant up` process can be addressed by
- re-provisioning the vagrant box. This is useful if, for example, an
- `apt-get` invocation timed out and caused the provisioning process to abort.
-
- $ vagrant provision
-
-3. Once built, reboot the VM so it starts the GUI properly.
-
- $ vagrant reload
-
-4. You can then log in and open a terminal. The username and password are both
- `user`.
-
-5. Download the code.
-
- $ git clone https://USERNAME@robotics.mvla.net/gerrit/971-Robot-Code
- $ cd 971-Robot-Code
-
-6. Build the code.
-
- $ bazel build //y2017/...
-
- Replace `//y2017` with the appropriate year's folder. For 2018 the build
- target would be `//y2018` for example.
-
-
-Setting up a VM manually
-================================================================================
-This section is lacking a lot of detail, but that's largely because you can
-find most of the information on other websites in a lot more detail.
-
-Requirements
---------------------------------------------------------------------------------
-1. Basic knowledge of the command line. See the "Command line knowledge"
- section above.
-
-2. Install VirtualBox <https://www.virtualbox.org/wiki/Downloads>
-
- See the details from the "Using Vagrant" section above.
-
-3. Download a Debian 8 ISO. You can find one online. The following link may or
- may not work:
- <https://cdimage.debian.org/cdimage/archive/8.9.0/amd64/iso-cd/debian-8.9.0-amd64-netinst.iso>
-
-Usage
---------------------------------------------------------------------------------
-1. Start VirtualBox and create a new VM. Make sure to mount the ISO in the
- virtual CD/DVD drive of the VM.
-
- There are a lot of guides online for creating a VM and can change between
- VirtualBox versions. If VirtualBox asks for the type of VM, select "Debian
- 64-bit".
-
-2. Boot the VM and go through the guided installation steps to install Debian.
- Once the installation completes, reboot to boot into your newly installed
- system. This will be part of the guided installation.
-
-3. Check this folder out on your computer somewhere.
-
- $ git clone ssh://USERNAME@robotics.mvla.net:29418/971-Robot-Code
-
- where you replace `USERNAME` with your own username. Keep in mind that you
- need your SVN and Gerrit account set up for this to work. Ask the mentors or
- other students about this if you don't have one yet.
-
-4. Run the setup script so you can start building our code.
-
- $ cd 971-Robot-Code/vm/
- $ sudo ./setup_code_building.sh
-
-5. Now you can build code. For example, to build all the 2017 code.
-
- $ bazel build //y2017/...
diff --git a/vm/Vagrantfile b/vm/Vagrantfile
deleted file mode 100644
index 1404131..0000000
--- a/vm/Vagrantfile
+++ /dev/null
@@ -1,57 +0,0 @@
-# Vagrantfile API/syntax version. Don't touch unless you know what you're
-# doing!
-VAGRANTFILE_API_VERSION = "2"
-
-# Install the necessary plugins.
-required_plugins = %w( vagrant-persistent-storage )
-required_plugins.each do |plugin|
- unless Vagrant.has_plugin? plugin || ARGV[0] == 'plugin' then
- exec "vagrant plugin install #{plugin};vagrant #{ARGV.join(" ")}"
- end
-end
-
-Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
- # All Vagrant configuration is done here. The most common configuration
- # options are documented and commented below. For a complete reference,
- # please see the online documentation at vagrantup.com.
-
- # Every Vagrant virtual environment requires a box to build off of.
- config.vm.box = "debian/jessie64"
-
- config.vm.provider "virtualbox" do |vb|
- # Don't boot with headless mode
- vb.gui = true
- vb.name = "FRC971-Development-2017"
-
- # There are two shortcuts for modifying number of CPUs and amount of
- # memory. Modify them to your liking.
- vb.cpus = 2
- vb.memory = 1024 * 2
- end
-
- # Use rsync to sync the /vagrant folder.
- # NOTE: If you change these settings they will not take effect until you
- # reboot the VM -- i.e. run a "vagrant reload".
- config.vm.synced_folder ".", "/vagrant", type: "rsync",
- rsync__exclude: [".git/", ".svn/", "workspace.vdi"], rsync__verbose: true
-
- # Set up apt and install packages necessary for building the code.
- config.vm.provision :shell, inline: "/vagrant/setup_apt.sh"
- config.vm.provision :shell, inline: "/vagrant/setup_extra_storage.sh"
- config.vm.provision :shell, inline: "/vagrant/setup_code_building.sh"
- config.vm.provision :shell, inline: "/vagrant/setup_scouting.sh"
- config.vm.provision :shell, inline: "/vagrant/setup_desktop.sh"
- config.vm.provision :shell, inline: "/vagrant/setup_misc_packages.sh"
- config.vm.provision :shell, inline: "/vagrant/setup_vbox_guest_additions.sh"
-
- # Add a second disk so we have plenty of space to compile the code.
- config.persistent_storage.enabled = true
- config.persistent_storage.location = "workspace.vdi"
- config.persistent_storage.size = 40000 # MiB
- config.persistent_storage.use_lvm = false
- config.persistent_storage.filesystem = 'ext4'
- config.persistent_storage.mountpoint = '/home/user'
-
- # Forward the scouting app's port.
- config.vm.network :forwarded_port, guest: 5000, host: 5000, auto_correct: true
-end
diff --git a/vm/setup_apt.sh b/vm/setup_apt.sh
deleted file mode 100755
index d31a372..0000000
--- a/vm/setup_apt.sh
+++ /dev/null
@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -u
-
-export DEBIAN_FRONTEND=noninteractive
-
-# Set up contrib and non-free so we can install some more interesting programs.
-cat > /etc/apt/sources.list.d/contrib.list <<EOT
-deb http://ftp.us.debian.org/debian/ jessie contrib non-free
-deb-src http://ftp.us.debian.org/debian/ jessie contrib non-free
-EOT
-
-# Get a list of the latest packages.
-apt-get update
diff --git a/vm/setup_code_building.sh b/vm/setup_code_building.sh
deleted file mode 100755
index cbb8fcd..0000000
--- a/vm/setup_code_building.sh
+++ /dev/null
@@ -1,64 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -u
-
-export DEBIAN_FRONTEND=noninteractive
-
-readonly PKGS=(
- bazel
- clang-3.6
- clang-format-3.5
- gfortran
- git
- libblas-dev
- liblapack-dev
- libpython3-dev
- libpython-dev
- python3
- python3-matplotlib
- python3-numpy
- python3-scipy
- python-matplotlib
- python-scipy
- resolvconf
- ruby
-)
-
-# Set up the backports repo.
-cat > /etc/apt/sources.list.d/backports.list <<EOT
-deb http://http.debian.net/debian jessie-backports main
-EOT
-
-# Set up the LLVM repo.
-cat > /etc/apt/sources.list.d/llvm-3.6.list <<EOT
-deb http://llvm.org/apt/jessie/ llvm-toolchain-jessie-3.6 main
-deb-src http://llvm.org/apt/jessie/ llvm-toolchain-jessie-3.6 main
-EOT
-
-# Set up the 971-managed bazel repo.
-cat > /etc/apt/sources.list.d/bazel-971.list <<EOT
-deb http://robotics.mvla.net/files/frc971/packages jessie main
-EOT
-
-# Enable user namespace for sandboxing.
-cat > /etc/sysctl.d/99-enable-user-namespaces.conf <<EOT
-kernel.unprivileged_userns_clone = 1
-EOT
-
-# We need to explicitly pull in the java certificates from backports. Otherwise
-# bazel won't install properly.
-cat > /etc/apt/preferences.d/java_certificates <<EOT
-Package: ca-certificates-java
-Pin: release a=jessie-backports
-Pin-Priority: 900
-EOT
-
-# Accept the LLVM GPG key so we can install their packages.
-wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | apt-key add -
-
-# Install all the packages that we need/want.
-apt-get update
-for pkg in "${PKGS[@]}"; do
- apt-get install -y -f --force-yes "$pkg"
-done
diff --git a/vm/setup_desktop.sh b/vm/setup_desktop.sh
deleted file mode 100755
index d713856..0000000
--- a/vm/setup_desktop.sh
+++ /dev/null
@@ -1,19 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -u
-
-export DEBIAN_FRONTEND=noninteractive
-
-readonly PKGS=(
- iceweasel
- lightdm
- mousepad
- xfce4
- xfce4-terminal
-)
-
-# Install all the packages that we need/want.
-for pkg in "${PKGS[@]}"; do
- apt-get install -y -f "$pkg"
-done
diff --git a/vm/setup_extra_storage.sh b/vm/setup_extra_storage.sh
deleted file mode 100755
index 5fcf4cb..0000000
--- a/vm/setup_extra_storage.sh
+++ /dev/null
@@ -1,19 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -u
-
-readonly EXTRA_USER=user
-readonly EXTRA_STORAGE=/home/"${EXTRA_USER}"
-
-if ! grep -q "$EXTRA_STORAGE" /etc/passwd; then
- PASSWORD="$(echo "$EXTRA_USER" | mkpasswd -s)"
- useradd \
- --home="$EXTRA_STORAGE" -M \
- --password="$PASSWORD" \
- --shell=/bin/bash \
- "$EXTRA_USER"
- chown "$EXTRA_USER:$EXTRA_USER" "$EXTRA_STORAGE"
-fi
-
-usermod -a -G sudo "$EXTRA_USER"
diff --git a/vm/setup_misc_packages.sh b/vm/setup_misc_packages.sh
deleted file mode 100755
index 691b2be..0000000
--- a/vm/setup_misc_packages.sh
+++ /dev/null
@@ -1,17 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -u
-
-export DEBIAN_FRONTEND=noninteractive
-
-readonly PKGS=(
- colordiff
- tmux
- vim
-)
-
-# Install all the packages that we want.
-for pkg in "${PKGS[@]}"; do
- apt-get install -y -f "$pkg"
-done
diff --git a/vm/setup_scouting.sh b/vm/setup_scouting.sh
deleted file mode 100755
index 3360ff5..0000000
--- a/vm/setup_scouting.sh
+++ /dev/null
@@ -1,17 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -u
-
-export DEBIAN_FRONTEND=noninteractive
-
-readonly PKGS=(
- python3
- python3-flask
-)
-
-# Install all the packages that we need/want.
-apt-get update
-for pkg in "${PKGS[@]}"; do
- apt-get install -y -f --force-yes "$pkg"
-done
diff --git a/vm/setup_vbox_guest_additions.sh b/vm/setup_vbox_guest_additions.sh
deleted file mode 100755
index c9f4b09..0000000
--- a/vm/setup_vbox_guest_additions.sh
+++ /dev/null
@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -u
-
-export DEBIAN_FRONTEND=noninteractive
-
-# Install the kernel sources before the guest additions to guarantee that
-# we can compile the kernel module.
-apt-get install -q -y linux-headers-amd64
-
-# Now we can install the guest additions.
-apt-get install -q -y \
- virtualbox-guest-dkms \
- virtualbox-guest-x11