本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 遠端存取 SageMaker Spaces
<a name="vscode-access"></a>

遠端存取可讓您將本機 Visual Studio Code 直接連線至 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 存取項目。如需 [EKS 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 程式碼 URL

1. 按一下 URL 或將其貼入瀏覽器

1. VS 程式碼將提示 開啟遠端連線

1. 確認連線以建立遠端開發環境

## 支援的開發環境
<a name="vscode-access-remote-dev-env"></a>

Web UI 可讓您存取：
+ *Jupyter 實驗室*
+ *程式碼編輯器*

## 疑難排解
<a name="troubleshooting"></a>

**無法產生連線 URLs**

*檢查下列項目：*
+ SageMaker Spaces 附加元件正在執行：kubectl get Pod -n sagemaker-spaces-system
+ 開發空間正在執行且運作狀態良好
+ 在附加元件安裝期間啟用遠端存取
+ 使用者具有適當的 EKS 存取項目許可