Fleet Workspace (Kasm Image)

Introduction

This repo provides an Immutable-Infrastructure-as-Code (IIaC) workspace for Star Trek: The Fleet (costuming fan group) based on the Ansible based template for KASM Ubuntu Jammy Images template provided by @j-simmons-phd. The workspace is configured with the following software:

• EmptyEpsilon EE-2023.06.17 (open-source "clone" of Artemis Spaceship Bridge Simulator)
• Node JS Tools
  • nodejs v17.9.0
  • npm v8.5.5 (included with nodejs)
  • npx v8.5.5 (included with nodejs)
• Utilities
  • git v2.41.0 with @capsulecorplab .gitconfig
  • Keychain v2.8.5
  • Vim (pre-installed) with @capsulecorplab vimrc
• Web Browsers
  • firefox
• Python 3.8.x (part of the image template) with the following packages (not part of the image template)
  • pip
  • JupyterLab
  • Jupyter Notebook
  • Voilà
  • Pint
• Artifact Generators
  • Pandoc v2.18
  • TeX Live v2022 to enable PDF support in Pandoc
  • yq v4.20.2
  • AsciiDoctor v2.0.17 with PlantUML and PDF support
  • PlantUML
    • JDK v11
    • Graphviz 2.50 (built from source)
• VS Code with the following extensions (note, auto-updates are disabled)
  • Python extension by Microsoft
  • Dendron
  • Foam
• Artifact Generators
  • PlantUML
    • JDK v11
    • Graphviz 2.50 (built from source)
  • AsciiDoctor v2.0.17 with PlantUML and PDF support
  • LaTeX Workshop
• OSHW Design Tools
  • Arduino 1.8.19
  • PrusaSlicer 2.7.0
  • OpenSCAD 2021.01
• Graphics Tools
  • GIMP
  • Krita

Requirements

1. A Bash terminal (Ubuntu on WSL2 recommended for Windows users).
2. Docker Compose (Docker Desktop recommended for non-Linux users)

Additional requirements for Windows

In Windows Features, enable Virtual Machine Platform and Windows Subsystem for Linux

Setup/Installation

From a bash terminal,

1. Clone this repo:

git clone https://github.com/startrekthefleet/fleet-workspace-image.git

2. Change directory into fleet-workspace-image:

cd fleet-workspace-image

3. Pull the published version of the workspace image (Note: Linux users may need to prepend this command with sudo):

docker-compose pull

Note: Alternatively, you can run docker-compose build to build the image locally.

Using the image locally

Once pulled or built, the image can be run locally on port 6901 using docker-compose.

• Starting the image locally: Run docker-compose up
• Stopping the image locally: Use keyboard shortcut Ctrl+C

When running locally, the workspace can be accessed at https://localhost:6901 with

• User: kasm_user
• Passwordd: password