Skip to content

Instantly share code, notes, and snippets.

@peterm790
Last active May 8, 2023 14:03
Show Gist options
  • Save peterm790/4afb30084a9746bccbb989f6f85c9c27 to your computer and use it in GitHub Desktop.
Save peterm790/4afb30084a9746bccbb989f6f85c9c27 to your computer and use it in GitHub Desktop.
Configure CSAG Jupyter Hub Account

Configure CSAG Jupyter Hub and Gitlab access

Gitlab

We are using a gitlab repo to mantain, version control and share any code produced for the Heat Center project.

As we are working with sensitive data we have set up an access group to restrict access to the code directories.

Before you can be added to the access group you will need to create an account by logging in. To do this please follow these steps::

step 1) Navigate to http://gitlab.csag.uct.ac.za

step 2) Log in using the LDAP login option. Your Username and password is the same as the one used to access the CSAG JupyterLab.

JupyterLab

Everybody should already have login details to access the CSAG JupyterLab instance. If you do not please let us know.

To ease navigating directories on the hub and allow for sharing links to notebooks it is necessary to sym link the heat_center directory to your home directory. To do this please follow these steps:

Step 1) Navigate to https://web.csag.uct.ac.za/hub and log in using your credentials.

step 2) Open a new launcher. By navigating to File > New Launcher

step 3) Open a terminal window.

step 4) copy and paste the following code into the terminal.

cd  
ln -s /terra/projects/heat_center/

From here you can access the code and data in the heat center directory from the terminal or the jupyterlab file browser.

Please avoid running Jupyter Notebooks in the project directory as this will overwrite the contents. To run the notebooks please copy them to your home directory first.

For example to run through the example notebooks run the following code in your terminal:

cd 
mkdir my_example_notebooks
cp -r heat_center/code/example_notebooks/ my_example_notebooks/.

All example notebooks have been run using the pangeo conda enviroment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment