Disclaimer

<aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" />

The RenkuLab:CSCS integration allows users to start interactive Renku sessions running as HPC jobs at CSCS.

RenkuLab accesses compute and storage resources on the behalf of the user, using existing permissions and resource allocation. Running Renku sessions at CSCS will consume compute credits from your CSCS account(s) and may affect other resources you have at CSCS (e.g. storage).

</aside>

Instructions

Prerequisites

  1. You need to have an account at CSCS which can launch jobs on the HPC platform or the ML platform.
  2. You need to have a RenkuLab.io account.

Step 1: Connect your CSCS from RenkuLab

Go to the integrations page and connect with the CSCS integration.

Step 2: Complete the Request access to the Renku:CSCS Integration

Fill in the form so that a RenkuLab admin can let you launch sessions with the CSCS integration.

Step 3: Launch a session

Option 1: Try out a template

  1. Go to this Renku project and Make a copy
  2. 🚀 Launch a session on the Python Basic - VSCodium - Eiger launcher!

Option 2: Create your own CSCS launcher in your project

  1. Create a new Renku project
  2. Add a new session launcher
  3. For the launcher’s environment:

    1. If you want to Create from Code, please note that only Python environments work on CSCS. If you’re unfamiliar with creating a code-based environment on Renku, see How to create an environment with custom packages installed!

    2. If you want to use the Renku Global Environments, select Python Basic or Python Datascience

      <aside> <img src="/icons/warning_orange.svg" alt="/icons/warning_orange.svg" width="40px" />

      Do not pick Python/Jupyter, Virtual desktop or RStudio.

      </aside>

    3. Please note that External Environments do not work with the CSCS integration.

  4. When selecting Session launcher compute resources, open the drop down and select a CSCS resource class, such as the Eiger - Debug resource class inside the CSCS - Eiger - Debug resource pool!
  5. Note: By default, the job is submitted against your default CSCS account