pupster90/dse210 repository overview

⁠Introduction

This virtual machine (VM) is the only software you will need to install for DSE 210. This VM basically creates a little "mini-computer" within your computer. The VM ("mini-computer") contains everything you need to download and complete homeworks.

This VM was not just created to make downloading everything easy. Its main purpose is to ensure that homework runs exactly as expected for you on your computer and for us when we grade it. Even if you already have python and jupyter, we recommend you use the VM.

⁠Installation and Use

First, you must install docker. Windows users, instead of installing docker install docker toolbox⁠. Follow this link⁠ for installation instructions:

Downloading the VM is equivalent to pulling the docker image (downloads can take a while). To do this open your terminal and type: docker pull pupster90/dse210

To enter the VM, you create a container of the dse210 image by typing: docker run -it -p 8888:8888 -v /decide/a/path:/Documents pupster90/dse210 /bin/bash

In the code above /decide/a/path can be any directory path you like. This allows you to access and edit any folder (as specified by the path) on your computer from within the VM (at /Documents). For instance, in the VM you can use git to download your homework from github⁠ to your computer. Once inside the VM you can create a copy of a repository to /decide/a/path like so: cd /Documents git clone https://some/github/repository

The VM also allows you to edit any file in decide/a/path using Jupyter. To run Jupyter at http://localhost:8888⁠ type: cd /Documents jupyter notebook

⁠VM Tech Specs

Operating System: Ubuntu 14.04 Packages: git, anaconda, nano, vim

⁠Comments

If you have any issues or notice a bug, please feel free to leave a comment!