Connecting to Workload through SSH

Once a workload is submitted, it will move through the queue and begin once the required resources are available. When the workload's state transitions from Pending to Running, you can access its details.

Accessing Workload Details

To view the SSH connection options, navigate to the workload in the dashboard. Once it's in the Running state, click on the workload to view all associated details. On the right-hand side of the page, you will see the following sections as shown below.

  • Interactive Endpoints

  • Service Terminal

You can connect to the container using either of these methods. Below is an overview of both options.

1. Service Terminal

The Service Terminal is a quick access method to interact with the container via a websocket-based terminal. However, this method is not recommended for development purposes. It is primarily useful for administrative tasks or quick troubleshooting, but it is prone to timeouts and potential disconnections due to the nature of the websocket connection.

  • Limitations: This option is not suitable for long-running tasks or development work.

  • Usage: Click on Service Terminal to open the connection. This will redirect you to a terminal interface where you can interact with the container as shown in below. However, bear in mind that it may disconnect if idle for too long or experience connection issues.

2. Interactive Endpoints (Recommended)

For development purposes or a more stable SSH connection, recommend using Interactive Endpoints. This method provides you with a secure SSH connection to the container, using SSH keys for authentication.

  • Important: This container is accessible over the internet using the CLI, meaning you can connect remotely to the container via SSH from any internet-connected machine using the provided details.

Step-by-Step Guide to Connecting via Interactive Endpoints

Step 1: Locate the Interactive Endpoints section

Once the workload is in the Running state, on the right-hand side of the workload details page, scroll down to the Interactive Endpoints section. Here, you will find two key pieces of information:

  • SSH Port: The port to use when establishing the SSH connection.
  • Secret Key: The private key used for SSH authentication.

Step 2: Click Connect

Click on the Connect button to reveal the SSH URL and Password for your container as shown below. The SSH URL will be displayed in the following format:

ssh -p <port> <username>@<hostname>

For example:

ssh -p 99999 aac@aac1.amd.com

The Password field will contain a password used for the initial connection.

Step 3: Connect from your local terminal

  • Open a terminal on your local machine.

  • Copy the SSH URL and paste it into your terminal as shown below.

Example:

ssh -p 99999 aac@aac1.amd.com
  • When prompted, enter the password you copied from the Password field. This will authenticate the connection.

Once connected, you will have access to the container, where you can run commands, check logs, and perform development tasks as needed.