2. Setting up your development environment

With your VPN activated, lets get set up to access a development environment.

Now that you have your VPN correctly installed, configured, and enabled, we'll get you set up with a login to the ISC associated with your User and Organisation.

Please note (particularly Windows users): where in the following guide we have provided an example path such as ~/.ssh/id_rsa or /<path>/<to>/.ssh/<key-pair> which will resemble the Linux/MacOS path format. Please use the path format that is suitable for your OS. For example, Windows path format typically will resemble C:\<path>\<to>\.ssh\id_rsa or C:\<path>\<to>\<key-pair>.

2.1.a If you are the first person in your Organisation to register

  1. Visit the Organisations page in Control Plane https://cp.strongcompute.ai/organisations. You will see only one organisation listed. When you first register your Organisation will be named "<your email>'s Personal Organisation".

  2. Click the "Manage" button for your Organisation to access the "Organisation Settings" page.

  3. From the "Organisation Settings" page you can update the name of your Organisation, view current members, and create invitations for other members to join.

Note that Control Plane does not send emails to invitees. If you invite a member to join your Organisation, you will need to notify them that they have been invited to your Organisation and which email address their invitation is registered with.

2.1.b If you are responding to an invitation to join an Organisation on Control Plane

  1. Visit the Organisations page in Control Plane https://cp.strongcompute.ai/organisations. You will see only one organisation listed. When you first register your Organisation will be named "<your email>'s Personal Organisation".

  2. You will also see your invitation to join an Organisation with options to Accept or Reject.

2.2 Upload your SSH public key

  1. Visit the "Workstations" page on Control Plane (https://cp.strongcompute.ai).

  2. At the bottom of the page under SSH Public Keys click on "Add SSH Key".

  3. You will need a cryptographic public/private key pair which you can generate as follows.

    • Open a terminal and run ssh-keygen.

    • When prompted, provide a path at which to save the key or accept the default (~/.ssh/id_rsa). You can also optionally enter a passphrase (or just press enter twice).

    • This will generate two files containing your public and private keys. Your public key will be saved in the file ending in .pub.

  4. Open the file containing your public key. If you generated your key pair with the instruction above, the public key file should have a file extension of .pub.

  5. Copy the entire contents of your public key file and paste into the input field on Control Plane beneath "Public key contents".

  6. Click "Submit New SSH Public Key".

2.3 Generate and start your development container

  1. Visit the "Workstations" page on Control Plane (https://cp.strongcompute.ai).

  2. Under "Containers" locate the container for the Organisation that you want to develop in.

  3. From the "Constellation Cluster" menu select the cluster you want to generate your development container on. For most new users, this will be "Strong Compute Cluster".

  4. Click "Generate". Strong Compute User environments are accessed via Docker containers. This step generates you a new base image from which to start your development container.

  5. Once your container has been generated you will see options for starting your development container, including the type of Workstation you would like to develop on and the Dataset (if any) you want to have mounted to your development container.

    • You can select either a "Shared" or "Isolated" Workstation.

    • Shared Workstations do not have a mounted GPU and Users' development containers share system resources such as CPU cores and memory (User data is not shared). Shared Workstations are suitable for light-weight development work such as writing code.

    • Isolated Workstations have one to six mounted GPU(s) and; User containers have dedicated and isolated system resources such as CPU cores and memory.

    • There is a limited number of Isolated Workstations which are available on a first-come-first-serve basis. If no Isolated Workstations are available when you try to start a container on an Isolated Workstation, an error will appear and your development container will not be started.

    • See the Datasets page of this guide for more information about Datasets.

  6. After selecting your desired options click "Start" to start your container.

  7. Once your container has started an SSH command will be displayed which will include a specified port number and the login root@ip-address which you can use to access your User environment inside your development container.

    • You may need to extend this ssh command to specify the private key to use as shown below. If you submitted to Control Plane your public key saved at ~/.ssh/id_rsa.pub then you should be able to ignore this requirement.

    • Note that your container must be started in order for you to connect to it via SSH.

    • Also note that your development container may be issued a new port number when it is stopped and started. If you are prompted for a password when attempting to access your development container via SSH, ensure you are using the correct port.

# First run this, paste full output line into your ISC User Credentials
cat ~/.ssh/YOUR_KEY_NAME.pub # (make sure it's the .pub version!)

# Then, connect to our server with the below! (replacing underlined bits)
ssh -p PORT root@CONTAINER_IP -i ~/.ssh/YOUR_KEY_NAME # (not the .pub version!)
  1. Open a terminal and run the ssh command above (with path to your private key if necessary). You will be greeted with a welcome message and your terminal will now show root@<id>:~#.

  2. Run isc ping and you will receive the following response to indicate that you are properly authenticated with the ISC.

    Using credentials file credentials.isc
    Success: {'data': 'pong'}

Note: Your environment is running in a Docker container. Your home directory is read/write mounted at /root. A shared directory accessible to all members of your Organisation is read/write mounted at /shared. You can install any software you require in your container which will be committed and pushed to our Strong Compute docker registry when you "Stop" your container and when you launch an experiment.

Users should save all project files (including virtual environments) to /root in order to minimise the size of your container. This will mean your container starts as fast as possible and your experiments launch on the ISC as fast as possible.

2.4 Accessing your development container in VSCode

It is strongly recommended to access your development environment using an Integrated Development Environment such as VSCode which supports SSH connection, particularly for less experienced users.

  1. Download and install VSCode https://code.visualstudio.com/download.

  2. Open VSCode.

  3. Click on the Extensions tab on the left-hand side of the VSCode window.

  4. Search for and install the "Remote - SSH" extension.

  5. Click on "Remote Explorer" on the left-side of the VSCode window.

  6. Open the "REMOTES" accordion on the left side panel.

  7. Hover over "SSH" with your cursor and click on the little cog icon.

  8. Press Return to open the file at /<path>/<to>/.ssh/config.

  9. When the config file opens, copy and paste the following into it, replacing <port> with the port number displayed at Step 5 of Section 2.3 above, and /<path>/<to>/.ssh/<key_pair> with the path to your private key from Step 3 of Section 2.2 above (note, do not include the .pub extension).

    Host ISC
      HostName <container-ip-from-workstations-page>
      User root
      Port <port>
      IdentityFile /path/to/.ssh/key
  10. Save and close the config file.

    • Note: If you "Stop" and "Start" your container, you may be assigned a new <PORT> number and you will need to update your config with that new <PORT> number.

  11. Hover over the "REMOTES" accordion title with your cursor, and click the refresh icon.

  12. When you see "ISC" appear in the "SSH'' list, hover over "ISC" and click on the right-pointing arrow that appears.

  13. When you are prompted to confirm that you want to continue, press Return.

  14. Click on "Open Folder".

  15. Press Return to open the root directory inside your development container.

  16. When you are prompted to confirm that you trust the authors of this directory, click on "Yes, I trust the authors".

  17. Open the terminal by clicking the tray button in the top-right of the VSCode window.

  18. Run isc ping and you will receive the following response to indicate that you are properly authenticated with the ISC.

    Using credentials file credentials.isc
    Success: {'data': 'pong'}

Congratulations, you are all set to start running experiments on the ISC. Follow the next steps in this guide to configure and launch your first "hello world" experiment, and learn about necessary steps to make sure your experiment is "interruptible" (including what this means).

Last updated