Skip to content

Immutable-Infrastructure-as-Code (IIaC) workspace image for fprime development

License

Notifications You must be signed in to change notification settings

fprime-community/fprime-workspace-image

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

F´ IIAC Workspace

Ingenuity Helicopter above Perseverance on Mars (wallpaper) image credit: NASA/JPL-Caltech

Introduction

This repo provides the source code for building an Immutable-Infrastructure-as-Code (IIAC) workspace image, using Kasm, for the F´(F Prime) flight software and embedded systems framework, based on an Ansible template for KASM Ubuntu Jammy images. The workspace is configured with the following:

Requirements

  1. Docker
  2. Git
  3. A Bash terminal (standard terminal environment for *nix and macOS).
  4. UDEV Rules for Teensy boards placed in /etc/udev/rules.d/00-teensy.rules. See https://www.pjrc.com/teensy/td_download.html

NOTE: To Windows 10 users: Windows Command Prompt will not satisfy this dependency. We recommend installing Ubuntu on WSL2 for Windows 10.

How to Use this Repo

  1. Clone this repo and change directory into fprime-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 or run docker-compose build to build the image locally.

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