Jetstream2 is one of the many providers of supercomputing services via the ACCESS program. It provides an easy to use interface to build and create instances in order to make use of your ACCESS Allocation Credits! In this tutorial we will cover how to access Jetstream2 and get started with basic development container environments in it!
Before we create our computing instances, it is best to add an SSH key that is associated with your personal computer. The reason for this is so that authenticating to Jetstream2 is made simpler without needing to use cumbersome passwords.
<your-key-name>is replaced with the name of the key you generated for your device). This will open up the public key file in VS Code and allow you to easily copy the contents. Another option is to use
cat .ssh/<your-key-name>.puband using your mouse to select the key and pressing
cto copy the key.
Jetstream2 makes it easy to create computing instances of various sizes. It is as simple as clicking "Create" -> "Instance" and selecting from the options provided. The PSTAT Computing Committee provides a community snapshot that will allow you to get started with an instance and development containers with ease!
Once your instance is built and setup, you will be able to dive straight in. We will show off some basic items to take note of in the web UI.
More advanced options are detailed in the Jetstream2 documentation.
Lastly, we will discuss using VS Code with your Jetstream2 instance and getting a quick start with a project development container that is available courtesy of the ucsb-pstat community snapshot image. Development containers allow you to easily port over your research code to an instance along with all the dependencies on languages, packages, and system tools. This requires minimal setup and no need of trying to get all your required tools installed on your own.
This community snapshot contains a bash script that will build a container environment along with example code from within the existing instance. If you are starting fresh, this is a great way to get started!
./build-project.sh. This will take you through a similar procedure outlined in the dev container template section and on this GitHub repository page. Select the options that you want:
We covered connecting and setting up VS Code on Jetstream2. You are now ready to continue with your research work using this set up.