Web browser access
Web UI access allows you to connect directly to development spaces running on your SageMaker HyperPod cluster through a secure web browser interface. This provides immediate access to Jupyter Lab and other web-based development environments without requiring local software installation.
Prerequisites
Before setting up web UI access, ensure you have completed the following:
-
SageMaker Spaces add-on installation: Follow the SageMaker Spaces add-on installation and enable web UI access during installation
-
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 Web UI Access URL
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 web-ui
Using kubectl
You can also use the kubectl command line to create a connection request.
kubectl create -f - -o yaml <<EOF apiVersion: connection.workspace.jupyter.org/v1alpha1 kind: WorkspaceConnection metadata: namespace: <space-namespace> spec: workspaceName: <space-name> workspaceConnectionType: web-ui EOF
The URL is present in the status.workspaceConnectionUrl of the output of this command.
Accessing Your Development Space
-
Generate the web UI URL using one of the methods above
-
Copy the URL from the response
-
Open the URL in your web browser
-
Access your development environment through the web interface
Supported Development Environments
The web UI provides access to:
-
Jupyter Lab
-
Code Editor
Troubleshooting
Cannot generate access URLs
Check the following:
-
SageMaker Spaces add-on is running: kubectl get pods -n sagemaker-spaces-system
-
Development space is running and healthy
-
User has appropriate EKS Access Entry permissions