riscy-business

Article: RISC-Y Business: Raging against the reduced machine.

Setting up the environment

This repository uses a devcontainer.json file to allow you to quickly get started.

1) GitHub Codespaces

Using Codespaces is required for the training

1. Fork this repository
2. Click the green <> Code button
3. Press ... and then New with options...
4. Change Machine type to 4-core
5. Then Create codespace
6. Wait a ~5 minutes while the image is loading ☕
   • Press Show log to see progress
   • Reload the page if it appears stuck
   • Firefox does not work, use Chrome!

Remember to shut down your codespace here when you're finished.

I recommend switching to the GitHub Dark theme, because the syntax highlighting works better there.

When prompted by the CMake tools, just close the notifications:

Ask me for a pendrive with the Docker images if you want to run it locally

1. Copy `riscyworkshop.tar` to your computer

WARNING: DO NOT RUN THIS COMMAND FROM THE PENDRIVE, IT WILL BE SLOW

2. Import the image with `docker load -i riscyworkshop.tar`
3. Pass the pendrive to the next person or bring it back

_{At a later date you can set things up locally with Docker Desktop}

Docker Desktop (tricky)

• Install/Update Docker Desktop (alternatives)
• Start Docker Desktop
• Install Visual Studio Code
• Clone and open this repository in VS Code (use the HTTPS protocol)
• Install the Dev Containers extension in VS Code (you should be prompted for recommended extensions)
• Click the blue 'Reopen in Container' button when prompted (you can also find it in the command palette)

For more detailed steps, check out the Dev Containers tutorial. The instructions after this assume you are running inside the container.

Windows

Because the host filesystem is mounted inside the container you may need to configure Git to not automatically convert line endings:

git config --global core.autocrlf false

Additionally it's recommended to configure Docker to use the WSL 2 backend.