翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SageMaker Spaces へのリモートアクセス
<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 アクセスエントリが必要です。[EKS アクセスエントリの設定の詳細については、「ユーザーの追加」および「サービスアカウントの設定](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 Code との接続
<a name="vscode-access-remote-vscode"></a>

1. 上記の方法のいずれかを使用して VS Code 接続 URL を生成する

1. レスポンスから VS Code URL をコピーする

1. URL をクリックするか、ブラウザに貼り付けます。

1. VS Code はリモート接続を開くように求めるプロンプトを表示します

1. 接続を確認してリモート開発環境を確立する

## サポートされている開発環境
<a name="vscode-access-remote-dev-env"></a>

ウェブ UI は、以下へのアクセスを提供します。
+ *Jupyter ラボ*
+ *コードエディタ*

## トラブルシューティング
<a name="troubleshooting"></a>

**接続 URLsを生成できない**

*以下を確認してください。*
+ SageMaker Spaces アドオンが実行されています: kubectl get pods -n sagemaker-spaces-system
+ 開発スペースが実行中で正常である
+ アドオンのインストール中にリモートアクセスが有効になりました
+ ユーザーに適切な EKS アクセスエントリ許可がある