SeaLion Workspace Image

Credits to Oregon Marine Reserves for sealion wallpaper CC BY-NC 2.0.

Introduction

This repo provides an immutable infrastructure as code (iiac) workspace for systems architecture & development for the SeaLion CubeSat Mission. Image currently uses an Ansible based template for KASM Ubuntu Jammy Images. The workspace is configured with the following software:

• Utilities
  • git v2.41.0 with @capsulecorplab .gitconfig
  • Keychain v2.8.5
  • Vim (pre-installed) with @capsulecorplab vimrc
• Cross Compile Toolchain for embedded Linux
  • gcc-arm-linux-gnueabihf
  • g++-arm-linux-gnueabihf
  • gdb-multiarch
  • build-essential
  • cmake v3.2
• Keychain
• Firefox
• Pharo Launcher with following Pharo images
  • "RoassalPlayground" pre-loaded with
    • Roassal3 v1.01b
    • NeoCSV
    • XMLParser
    • Roassal3Exporters v1.0
• Space Mission Analysis & Design Tools
  • General Mission Analysis Tool
  • GNU Octave
  • Minicom
  • GNU Radio Software 3.10.1.1
    • gr-satellites 4.4.0
  • GPredict
  • 42 2024-01-02
• Python 3.10 (part of the image template) with the following packages (not part of the image template)
  • pip
  • fprime 3.2.0
    • fprime-tools
    • fprime-gds
    • fpp
  • JupyterLab
  • Jupyter Notebook
  • Voilà
  • Pint
  • LinkML
  • pandas
  • seaborn
  • black
• VS Code with the following extensions (note, auto-updates are disabled)
  • LaTeX Workshop
  • PlantUML
  • Python extension by Microsoft
• OSHW Design Tools
  • KiCAD 7.0.10

Requirements

1. Docker
2. Git

Notes:

• It is recommended MacOS and Windows users download Docker Desktop
• It is recommended to allocate at least 16gb under docker image size in your docker settings (See https://stackoverflow.com/a/65333634/12076663)
• WSL 2 users should run docker daemon with sudo dockerd --iptables=true (See https://stackoverflow.com/questions/40792765/docker-internet-connectivity-with-iptables-false)

How to Use this Repo

1. Clone this repo and change directory into sealion-workspace-image.
2. Run docker-compose pull (Note: Linux users may need to prepend this command with sudo) to pull the published version of the workspace image.

Using the image locally

Once built, the image can be pushed into the Kasm server per Kasm documentation or it can be run locally on port 6901 using docker-compose.

• Starting the image locally: Run docker-compose up -d
• Stopping the image locally: Run docker-compose down

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

• User: kasm_user
• Passwordd: password