Skip to content
Ansible playbook for configuring the JMU CS VM provided by the UUG
Python Shell Roff
Branch: master
Clone or download
ripleymj Merge pull request #344 from ripleymj/fix-yamllint
Clean up yamllint formatting complaints
Latest commit 06c71a3 Oct 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows
packer
roles Clean up yamllint formatting complaints Oct 8, 2019
scripts Remove appliance creation scripts Apr 10, 2019
.ansible-lint Document ansible-lint config Aug 15, 2019
.gitignore Packerize VM build (#229) Dec 9, 2018
.yamllint Clean up yamllint formatting complaints Oct 8, 2019
CONTRIBUTING.md Add instructions for updating python file Feb 14, 2019
LICENSE Add license (#78) Dec 11, 2017
README.md Change idle-python 3.6 to idle Oct 5, 2019
ansible.cfg Disable the retry file Apr 11, 2018
hosts Cleanup inventory file Sep 15, 2019
local.yml Add VSCode support for CS149 Sep 1, 2019
oem.yml Add VM checks in OEM role (#225) Nov 27, 2018

README.md

JMU UUG virtual machine build script

This is a set of Ansible roles that can be used to configure a Linux Mint or Ubuntu system for JMU computer science courses. It is primarily used to deliver the Unix Users Group virtual machine, but can be run outside that VM using instructions later in this document. Extended end user documentation about using these tasks and the VM is available separately.

Installed packages and features

Common

  • Filezilla
  • JDK/JRE 10-11
  • SFTP connection to stu
  • Shortcuts to re-run tasks
  • Unzip
  • Vim
  • Vim-Gnome
  • VM management script
  • JMU wireless printing

CS101

  • Eclipse (with checkstyle plugin)
  • Finch robot
  • Mint packages (basic-prog-pkgs role)
    • artha
    • bless
    • chromium-browser
    • geany
    • idle
    • libreoffice
    • logisim
    • meld
    • sqlitebrowser
    • thonny
    • wireshark

CS149

  • Eclipse (with checkstyle plugin)
  • jGRASP
  • Visual Studio Code (with Java and checkstyle plugins)

CS159

  • Eclipse (with checkstyle plugin)

CS261

  • Mint packages (adv-prog-pkgs role)
    • Compilers and interpreters
      • build-essential
      • g++
      • gcc
      • gdb
      • logisim
      • valgrind
    • Code editors
      • astyle
      • bvi
      • check
      • gedit
      • indent
      • nano
    • Source control
      • git
      • gitg
      • mercurial
      • meld
  • y86 tools
    • Assembler (yas)
    • Reference solution (y86ref)
    • Reference solution manual page (y86ref(1))
    • Simulator (ysim)

CS354

  • Gazebo9
  • ROS Melodic
  • Rosdep/catkin initialization
  • Rviz

CS361

  • Mint packages (adv-prog-pkgs role)
    • Compilers and interpreters
      • build-essential
      • g++
      • gcc
      • gdb
      • logisim
      • valgrind
    • Code editors
      • astyle
      • bvi
      • check
      • gedit
      • indent
      • nano
    • Source control
      • git
      • gitg
      • mercurial
      • meld

CS430

  • Ruby
    • ruby
  • Haskell
    • haskell-platform
  • Prolog
    • swi-prolog

Manual use of these Ansible roles

apt-get install ansible git
git clone https://github.com/jmunixusers/cs-vm-build
cd cs-vm-build
ansible-playbook -i hosts -K -t TAGS local.yml

or directly from GitHub:

ansible-pull -U https://github.com/jmunixusers/cs-vm-build --directory /tmp/cs-vm-build --purge -i hosts -K -t TAGS

where TAGS is a comma separated list (with no spaces) of cs101, cs149, cs159, cs261, cs354, cs361 and/or cs430 as appropriate.

This was developed on and for Linux Mint, but can be adapted to any Debian-based distribution with minimal changes. Adaptions for distributions that do not use apt will require more extensive modifications.

Building the UUG VM

To build the UUG VM, configure a system with git, Oracle VirtualBox, Hashicorp Packer, and approximately 20GB of free disk space. VM builds are tested regularly on Linux and Windows hosts, but feedback on other platforms is always welcome.

Once the prerequisites are installed, change into the cs-vm-build/packer directory and execute packer build oem-build.json. This will take a considerable amount of time, depending on host resources available, but should output progress indicators along the way.

The build process can be customized by passing parameters to the packer build command using the -var flag. The supported parameters are:

  • git_repo - the repository containing the setup scripts to run before exporting the VM appliance. Defaults to https://github.com/jmunixusers/cs-vm-build.
  • git_branch - the branch of the above repository to choose. Defaults to master.
  • headless - whether or not to show the desktop session during installation. Defaults to true.

Contributing

Feedback and involvement is always welcome in JMU UUG projects. The issue tracker on this repository is a great place to start, whether you're looking for previous design discussions, want to ask a question, or would like to contribute additional functionality. The UUG can also be reached via Twitter or check our upcoming meeting schedule. For more suggestions on getting involved, please see the CONTRIBUTING document.

License

This project is licensed under the MIT license. See LICENSE for more information.

You can’t perform that action at this time.