Starting Labs on Roar
Start a new Roar Session
Request a "BYOE Jupyter server" session via the Roar portal (see starting Pluto Server)
You can proceed to the next step, while you're waiting for it to star.
Clone your github repository to begin a new assignment
Lookup the url for the repo to be cloned (from email, Canvas announcement, or Canvas lab page).
If you haven't followed the link to create your repo for this week's assignment yet, then do that now. Following that link should trigger GitHub to create a private git repository named labN-GITHUBID (where N is the week number and GITHUBID is the GitHub username that you're logged in as at the time you follow the link).
Navigate to the github repository you'll be using in your browser.
Click Clone or download.
If it says "Clone with https", click "Use ssh".
Click the clipboard icon to copy the url onto your clipboard
Return to your browser tab with "My Interactive Sessions".
Hopefully, there's now a Connect to Jupyter Server button. Click it.
Go to the newly opened tab, you'll have a Jupyter Lab Server.
If you don't see tiles for Python, Julia and Pluto Notebooks, then click File.NewLauncher.
Find the Terminal tile or in the menu system, File.New.Terminal.
In the new terminal tab, clone your github repo by running
git clone REPO_URLwhere REPO_URL is what you'll paste from the clipboard
Instantiate the lab's environemnt
Change into the directory that was created for the repository (we'll call it REPO_DIR) and setup all the package dependencies required (as specified by the Project.toml or test/Project.toml file or embedded in Pluto notebooks) by running
cd REPO_DIR
julia --project -e 'using Pkg; Pkg.instantiate(); 'Open Pluto notebook
Go back to the browser tab with your Jupyter Lab server running.
If you do not see the a tile for Pluto, then go to File.NewLauncher.
Most labs will contain one or more Pluto notebooks (their file names will end in .jl). To open one in Pluto,
Click the Pluto tile. A new tab will open in your browser for the Pluto session.
In the box labeled "Open from file" or "Open a notebook" (depending on Pluto version), type the path to the directory containing the repo, a forward slash and the name of the first notebook (e.g., 'lab1-yourgithubid/ex1.jl'). Tab completion is often helpful.
Do your work in the notebook.
When you're done with a notebook, make sure it is saved (Ctrl+S) and close the tab.
Commit your changes
Ideally, you'd commit small changes as you go. At a minimum, make sure that you commit your changes each time you are wrapping up a coding session or about to take a break.