Initial commit

Author: Peter Willis

README.md

@@ -0,0 +1,83 @@
+# Setting up an Ubuntu VM with Vagrant on Windows 10
+
+## Set up an Ubuntu VM
+
+1. Install VirtualBox (https://www.virtualbox.org/wiki/Downloads)
+   - Download and install the latest version of VirtualBox for Windows hosts (as of this writing, [version 6.1.10](https://download.virtualbox.org/virtualbox/6.1.10/VirtualBox-6.1.10-138449-Win.exe)
+   - Follow the install and use all the defaults.
+   - After install, open the VirtualBox GUI
+   - Go to menu *File -> Preferences*
+   - In the *General* tab, look for the *Default Machine Folder* setting.
+     Set it to `C:\files\VirtualBox VMs`.
+     This will avoid your VM being created in your user's home directory, which could cause issues later.
+   - Now click *Extensions*.
+   - Make sure there is no Oracle VirtualBox Extension Pack listed.  If there is, select it, and click the "X" button to the right to uninstall it.
+     The license for this Extension Pack is not free for commercial uses, and you don't need it for a basic headless Linux VM.
+
+2. Install Vagrant 64-bit (https://www.vagrantup.com/downloads.html)
+   - Download and install the latest version of Vagrant for Windows (as of this writing, [version 2.2.9](https://releases.hashicorp.com/vagrant/2.2.9/vagrant_2.2.9_x86_64.msi)
+
+3. Open a command-line window (cmd.exe)
+
+4. Run the following commands:
+   ```
+   C:\Users\willis> mkdir c:\files\vagrant\devbox
+   C:\Users\willis> cd c:\files\vagrant
+   C:\files\vagrant> git clone [email protected]:pwillis-els/vagrant-ubuntu-windows-10.git devbox
+   C:\files\vagrant> cd devbox
+   C:\files\vagrant\devbox> vagrant up
+   ```
+
+## Login to your Vagrant machine
+1. To SSH in from the Windows console, open a command-line window (cmd.exe) and run the following:
+   ```
+   C:\Users\willis> cd c:\files\vagrant\devbox
+   C:\files\vagrant\devbox> vagrant ssh
+   ```
+2. You can also get the ssh connection information with command `vagrant ssh-config`, convert the IdentityFile to a PuTTY .ppk file, and use PuTTY to log in.
+
+
+## Create a new SSH key
+Vagrant creates an SSH key for you, whose path you can retrieve with the `vagrant ssh-config` command.
+However, you may find it more secure to have a password-protected key that lives only in your Vagrant box.
+1. Login to the Vagrant machine.
+2. Run the following command:
+   ```bash
+   $ ssh-keygen -o -t ed25519
+   ```
+
+## Set up GitHub Access
+1. Navigate to [Add new SSH key](https://github.com/settings/ssh/new)
+2. Put in a title ("Vagrant Devbox") and paste in your SSH public key, which you can get from:
+   ```bash
+   $ cat ~/.ssh/id_ed25519.pub
+   ```
+3. Navigate to [Add a New personal access token](https://github.com/settings/tokens/new)
+4. Add a description ("Vagrant Devbox") and select the scopes ("repo" is enough to start), and click **Generate Token**
+5. Immediately copy down the token on the screen.
+6. If your GitHub account is SSO-linked, click **Enable SSO** next to the new Personal Access Token, and then click **Authorize**, and follow the prompts.
+7. In your Vagrant box, add your GitHub login credentials to the file `/home/vagrant/.netrc`. Use your new Personal Access Token as the password. (Instructions: https://stackoverflow.com/questions/6031214/git-how-to-use-netrc-file-on-windows-to-save-user-and-password)
+8. In your Vagrant box you can now use `git` to checkout GitHub repos using either the HTTPS or SSH protocol.
+
+## Extras
+
+ - Use Docker inside the Vagrant box to run applications, as Ubuntu's versions are not the latest. Examples:
+   - Terraform:
+     ```bash
+     $ mkdir $HOME/bin
+     $ printf '#!/bin/bash\ndocker run -i -t hashicorp/terraform:light "$@"\n' > $HOME/bin/dterraform
+     $ chmod 755 $HOME/bin/dterraform
+     $ ~/bin/dterraform version
+     Terraform v0.11.11
+     ```
+
+   - AWS CLI:
+     ```bash
+     $ mkdir $HOME/bin
+     $ curl -o $HOME/bin/aws.sh https://raw.githubusercontent.com/mesosphere/aws-cli/master/aws.sh
+     $ chmod 755 $HOME/bin/aws.sh
+     $ export AWS_ACCESS_KEY_ID="<id>"
+     $ export AWS_SECRET_ACCESS_KEY="<key>"
+     $ export AWS_DEFAULT_REGION="<region>"
+     $ aws.sh s3 ls
+     ```

Vagrantfile

@@ -0,0 +1,77 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+Vagrant.configure("2") do |config|
+  # https://docs.vagrantup.com.
+
+  # boxes at https://vagrantcloud.com/search.
+  config.vm.box = "bento/ubuntu-20.04"
+
+  # config.vm.box_check_update = false
+
+  # config.vm.network "forwarded_port", guest: 80, host: 8080
+  # config.vm.network "forwarded_port", guest: 80, host: 8080, host_ip: "127.0.0.1"
+  # config.vm.network "private_network", ip: "192.168.33.10"
+  # config.vm.network "public_network"
+
+  # Uncomment this and set your adapter index to create a static private interface
+  #config.vm.network "private_network", ip: "192.168.88.10", :adapter => 2
+
+  config.ssh.forward_x11 = true
+
+  # This is superfluous, as "/vagrant" is already shared to your Vagrantfile dir
+  #config.vm.synced_folder "./data", "/vagrant_data"
+  #config.vm.synced_folder "c:\\Users\\willis\\OneDrive", "/onedrive"
+
+  config.vm.provider "virtualbox" do |vb|
+     # Customize the amount of memory on the VM:
+     vb.memory = "4096"
+     vb.cpus = 2
+  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
+     export DEBIAN_FRONTEND=noninteractive
+
+     apt-get update -y
+     apt-get install -y apt-transport-https ca-certificates curl software-properties-common
+
+     # Install Docker
+     curl -fsSL https://download.docker.com/linux/"${release_name}"/gpg | apt-key add -
+     apt-key fingerprint 0EBFCD88
+     add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
+     apt-get update
+     apt-get install -y "docker-ce"
+     unset http_proxy https_proxy no_proxy
+     usermod -a -G docker vagrant || true
+     docker info
+
+     # Apt-get upgrade is disabled here because it'll hang the provisioner trying to ask questions.
+     #apt-get upgrade -y
+     apt-get -y -o Dpkg::Options::="--force-confdef" -o Dpkg::Options::="--force-confold" upgrade
+
+     apt-get install -y python3 python3-pip python3-wheel python3-virtualenv
+
+     # Install a graphical terminal for X11 forwarding
+     apt-get install -y xauth rxvt x11-xserver-utils
+
+     # If you need to modify your DNS servers, you may need the following configuration:
+     # 1. Create this file
+     #      # /etc/systemd/resolved.conf
+     #      [Resolve]
+     #      DNS=10.90.163.133 10.90.131.133 8.8.8.8 1.1.1.1
+     # 
+     # 2. Copy /lib/systemd/system/docker.service to /etc/systemd/system/
+     # 3. Add '--dns <ip1> --dns <ip2> ...' to /etc/systemd/system/docker.service
+     # 4. Run 'systemctl daemon-reload ; systemctl restart docker ; systemctl enable docker
+     # 5. Enable tcp mode in docker daemon
+     
+     # Install miscellaneous useful tools
+     apt-get install -y bash-completion ldap-utils sendmail bsd-mailx
+
+     # Set timezone
+     #sudo timedatectl set-timezone US/Eastern
+   SHELL
+end

vagrant_openssh.conf

@@ -0,0 +1,12 @@
+# This is an example OpenSSH config you can SSH into your Vagrant machine on Windows.
+Host default
+  HostName 127.0.0.1
+  User vagrant
+  Port 2222
+  UserKnownHostsFile /dev/null
+  StrictHostKeyChecking no
+  PasswordAuthentication no
+  IdentityFile C:/files/vagrant/devbox/.vagrant/machines/default/virtualbox/private_key
+  IdentitiesOnly yes
+  LogLevel FATAL
+  ForwardX11 yes