Labs 344

This repository contains the development environment and instructions for CMPE344 lab sessions.

Containerized Lab Environment for CMPE344

Containers provide the ability to package and run applications in a loosely isolated environment. We use container technology to package our development environment, where we install all required software and their dependencies.

Docker was the first containerization platform and still is the most widely used software to manage containers. Check Docker overview for more information about Docker and containerization technology.

Run the Lab Environment

1) Using Docker Engine

⚠️ You need Docker Engine installed on your system to proceed. You can install the engine for Ubuntu by following installation steps. You can also follow post-installation steps to run docker without sudo.

⚠️ Windows users need to use Docker Desktop with WSL2 backend. See the installation steps.

You can pull the container using the command:

docker pull ghcr.io/bouncmpe/labs344

Then you can run the container using the command:

docker run -it --rm ghcr.io/bouncmpe/labs344

2) Using VSCode and Remote Containers extension

The code editor VSCode has an extension to allow you to develop inside containers called Remote - Containers. It will enable you to open any folder inside (or mounted into) a container and take advantage of VSCode fully. This project provides you with a .devcontainer/devcontainer.json file to configure the extension accordingly.

Once you have installed Remote - Containers in the editor, you can open and work inside our lab environment using the extension.

Getting started

Please follow the tutorials below to get started with our development environment.

1. Tutorial: Simulate your first RISC-V program