Skip to main content

Step 3: Create a Workspace and Add Your Course Notebook Files

Greg Werner
  • Updated

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

  1. Click on the Launch link to open your Jupyter Notebook in a new tab.

  2. Click on the Upload icon to select and upload the files to your workspace.

Upload files from your local computer

Clone a Git Repository

  1. From the dashboard, create a new Terminal or Notebook kernel by clicking on the corresponding icon.

  2. Clone your repo either from the interactive Notebook interface or directly from the Terminal.

  3. 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.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.