Overview
In most cases, users already have a Notebook or a set of Notebook files they wish to use for their courses. Usually these files are located within a git
compatible repo, such has GitHub, GitLab, or BitBucket.
Create a New Workspace
Once you have created a new project, you can then create a new workspace
. A workspace is equivalent to a server instance
, in this case a Jupyter Notebook server instance.
For those of you that are familiar with launching Jupyter Notebooks from your terminal, this is equivalent to:
$ python3 -m pip install --upgrade pip
$ python3 -m pip install jupyter
$ jupyter notebook
Create a workspace
by clicking on the Add a Workspace
button within your project's main page:
Create a new workspace by setting name, size, and type
As illustrated above, a new workspace requires:
-
A workspace name
-
The workspace size
-
The workspace type
Once you have created your workspace, click on Start
. This will spawn a new workspace instance which will then allow you to open the workspace with Launch
. By default, the workspace opens in a new browser tab.
Add your Course Files
You should now have a valid user account, a project, and a workspace. Make sure your workspace
has Status
set to Running
and and that the Launch
link appears under Actions:
A workspace instance with Status = Running
You can either upload files with the workspace's integrated file manager or you can clone a git
compatible repository:
Upload Files
-
Click on the
Launch
link to open your Jupyter Notebook in a new tab. -
Click on the
Upload
icon to select and upload the files to your workspace.
Upload files from your local computer
Clone a Git Repository
-
From the dashboard, create a new Terminal or Notebook kernel by clicking on the corresponding icon.
-
Clone your repo either from the interactive Notebook interface or directly from the Terminal.
-
If using the
git clone
use the "bang" command to emulate a terminal command like so:
Launch a new notebook to clone git repos or use the integrated upload option.
What’s next?
Congrats! You should now have a unique account, project, and workspace!
Now would be a good time to create a new OAuth2 application and credentials to connect IllumiDesk to the CanvasLMS.
Comments
0 comments
Please sign in to leave a comment.