How to Create a New Pod (Container)

Operating System: Any

Applies To: Faculty or Staff using CaaS  

Last Updated: February 10, 2025

The steps below assume you are using the UB Version Control System (UBVCS) for your code repository.

Instructions

Step 1: Create an SSH key pair on the command line using ssh-keygen (MacOS, Linux and Windows)

  1. Open a Command Prompt and change to the directory that you would like to save your SSH key pair
    Example:
    $ cd Downloads/
  2. At the prompt, enter the following:
    $ ssh-keygen -t ed25519 -f ./CaaS_SSH_Key
  3. When prompted, “Enter passphrase (empty for no passphrase):” - Press the Enter key
  4. When prompted, “Enter same passphrase again:” - Press the Enter key
  5. The location of your private and public will be displayed along with the key’s randomart image

Example:

$ ssh-keygen -t ed25519 -f ./CaaS_SSH_Key
Generating public/private ed25519 key pair.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in ./CaaS_SSH_Key
Your public key has been saved in ./CaaS_SSH_Key.pub
The key fingerprint is:
SHA256:i2XLNeA0edcCqS4OgfNEtpN/8nbr^TAnWD8h6+Hcm0Y
The key's randomart image is:
+--[ED25519 256]--+
| .A |
| o ... . |
| + o =.+ + . |
| o * o.* = o |
| + + .S O + |
| o +=oB O + |
| o.=+ + * E |
| . o .+ . |
| . oo. |
+----[SHA256]-----+

Step 2: Add your public key to your repository

  1. Log into https://ubvcs.buffalo.edu
  2. Select your repository
  3. Take note of the SSH URI displayed on the right side of the page (this will be used in the section below)
  4. Click on the Settings button
  5. Select Deploy Keys from the navigation pane on the left
  6. Click on the Add Deploy Key button
  7. Enter a name for your key in the Title box (the name can be anything)
  8. Enter the contents of the public key generated in Steps 1-6 in the Content box

Step 3: Complete your setup

  1. Log into https://console.apps.buffalo.edu/
  2. Select your project or create a new one by clicking on the Add button
  3. Click Add to Project (this step is skipped if you created a new project in the previous step)
  4. Choose a base image for your application
  5. Click Instantiate Template or Create Application (this varies by image)
  6. Enter a Name for your application and fill out the other required fields
  7. Enter the SSH URI for your code repository (displayed when you view your repository in the UBVCS Web Portal). Ignore the warning saying, Git repository should be a URL
  8. Click Show Advanced Git options
  9. Click Create new secret
  10. Click Source Secret
  11. Enter a Secret Name
  12. Choose SSH Key as the Authentication Type
  13. Click Browse and select the private key you downloaded above (<repository_name>_id_rsa)
  14. Click Create
  15. Click Create at the bottom of the page
  16. Review the information on the next page
  17. Click Continue to overview

See also

Still need help?

Contact the UBIT Help Center.