Remote access to SageMaker Spaces
Remote access allows you to connect your local Visual Studio Code directly to development spaces running on your SageMaker HyperPod cluster. Remote connections use SSM to establish secure, encrypted tunnels between your local machine and the development spaces.
Prerequisites
Before setting up remote access, ensure you have completed the following:
-
SageMaker Spaces add-on installation: Follow SageMaker Spaces add-on installation and enable remote access during installation (either Quick install or Custom install with remote access configuration enabled).
-
User access to EKS cluster: Users need EKS Access Entry configured with appropriate permissions. See Add users and set up service accounts for EKS Access Entry setup details
-
Development spaces: Create and start development spaces on your HyperPod cluster
-
kubectl access: Ensure kubectl is configured to access your EKS cluster
Generate VS Code remote connection
Using HyperPod CLI
If you have the HyperPod CLI installed, you can use this simplified command:
hyp create hyp-space-access --name <space-name> --connection-type vscode-remote
Connecting with VS Code
-
Generate the VS Code connection URL using one of the methods above
-
Copy the VS Code URL from the response
-
Click the URL or paste it into your browser
-
VS Code will prompt to open the remote connection
-
Confirm the connection to establish the remote development environment
Supported Development Environments
The web UI provides access to:
-
Jupyter Lab
-
Code Editor
Troubleshooting
Cannot generate connection URLs
Check the following:
-
SageMaker Spaces add-on is running: kubectl get pods -n sagemaker-spaces-system
-
Development space is running and healthy
-
Remote access was enabled during add-on installation
-
User has appropriate EKS Access Entry permissions
