本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 远程访问 SageMaker 空间
<a name="vscode-access"></a>

远程访问允许您将本地 Visual Studio 代码直接连接到 SageMaker HyperPod 集群上运行的开发空间。远程连接使用 SSM 在本地计算机和开发空间之间建立安全的加密隧道。

## 先决条件
<a name="vscode-access-prereq"></a>

在设置远程访问之前，请确保您已完成以下操作：
+ *SageMaker Spaces 插件安装*：关注 [SageMaker Spaces 插件](https://docs.aws.amazon.com/sagemaker/latest/dg/operator-install.html)安装并在安装过程中启用远程访问（在启用远程访问配置的情况下快速安装或自定义安装）。
+ *用户访问 EKS 集群*：用户需要配置相应权限的 EKS Access Entry。有关 E [KS Access Entry 设置的详细信息，请参阅添加用户和设置服务帐户](https://docs.aws.amazon.com/sagemaker/latest/dg/add-user.html)
+ *开发空间*：在 HyperPod 集群上创建和启动开发空间
+ *kubectl 访问权限*：确保将 kubectl 配置为可以访问你的 EKS 集群

## 生成 VS Code 远程连接
<a name="vscode-access-remote"></a>

### 使用 HyperPod CLI
<a name="vscode-access-remote-cli"></a>

如果您安装了 HyperPod CLI，则可以使用以下简化的命令：

```
hyp create hyp-space-access --name <space-name> --connection-type vscode-remote
```

### 使用 kubectl
<a name="vscode-access-remote-kubectl"></a>

您也可以使用`kubectl`命令行创建连接请求。

```
kubectl create -f - -o yaml <<EOF
apiVersion: connection.workspace.jupyter.org/v1alpha1
kind: WorkspaceConnection
metadata:
  namespace: <space-namespace>
spec:
  workspaceName: <space-name>
  workspaceConnectionType: vscode-remote
EOF
```

URL 出现在此命令`status.workspaceConnectionUrl`的输出中。

## 使用 VS 代码连接
<a name="vscode-access-remote-vscode"></a>

1. 使用上述方法之一生成 VS Code 连接 URL

1. 从响应中复制 VS 代码网址

1. 点击网址或将其粘贴到浏览器中

1. VS Code 将提示您打开远程连接

1. 确认连接以建立远程开发环境

## 支持的开发环境
<a name="vscode-access-remote-dev-env"></a>

Web 用户界面提供对以下内容的访问：
+ *Jupyter 实验室*
+ *代码编辑器*

## 问题排查
<a name="troubleshooting"></a>

**无法生成连接 URLs**

*检查以下内容：*
+ SageMaker Spaces 插件正在运行：kubectl 获取 pods-n sagemaker-spaces-system
+ 开发空间运行良好
+ 在安装插件期间启用了远程访问
+ 用户拥有相应的 EKS 访问权限入口