View a markdown version of this page

通过远程访问将您的远程 IDE 连接到 SageMaker 空间 - 亚马逊 SageMaker AI
重要概念连接方法支持的 IDEIDE 版本要求操作系统要求本地计算机先决条件映像要求实例要求
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

通过远程访问将您的远程 IDE 连接到 SageMaker 空间

您可以从远程 IDE 远程连接到 Amazon SageMaker Studio 空间。您可以将自定义的本地 IDE 设置（包括 AI-assisted 开发工具和自定义扩展）与 Amazon A SageMaker I 中的可扩展计算资源配合使用。本指南为管理员和用户提供概念介绍与设置说明。

远程 IDE 连接可在本地 IDE 和 SageMaker 空间之间建立安全连接。此连接可让您：

  • 访问 SageMaker AI 计算资源 — 从本地环境在可扩展的 SageMaker AI 基础架构上运行代码

  • 维护安全边界 — 在与 SageMaker AI 相同的安全框架内工作

  • 保持熟悉的 IDE 体验 — 使用支持远程开发的兼容本地扩展、主题和配置

注意

并非所有 IDE 扩展都与远程开发兼容。需要本地 GUI 组件、存在架构依赖关系或需要特定的客户端-服务器交互的扩展在远程环境中可能无法正常工作。使用前，请确认所需的扩展支持远程开发。

主题

重要概念

  • 远程连接 — 远程 IDE 和 SageMaker 空间之间的安全隧道。此连接支持使用 SageMaker AI 计算资源进行交互式开发和代码执行。

  • Amazon SageMaker Studio 空间 — 亚马逊 SageMaker Studio 内的专用环境，您可以在其中管理 Studio 应用程序的存储空间和资源。

  • 深度链接 — SageMaker 用户界面中的一个按钮（直接 URL），用于启动与本地 IDE 的远程连接。

连接方法

将远程 IDE 连接到 SageMaker 空间的主要方法有三种：

  • 深度链接访问 — 您可以使用 SageMaker AI 中提供的带按钮的 Open space 直接连接到特定空间。它使用 URL 模式来建立远程连接并在远程 IDE 中打开您的 SageMaker 空间。

  • Amazon Toolkit for Visual Studio Code – 可以使用 Amazon Toolkit for Visual Studio Code进行身份验证。这允许您从远程 IDE 连接到空间并打开远程连接的窗口。

  • SSH 终端连接 – 可以使用 SSH 配置通过命令行进行连接。

支持的 IDE

与 Studio 空间的远程连接支持：

IDE 版本要求

下表列出了每个支持的远程 IDE 的最低版本要求。

IDE 最低版本

Visual Studio Code

v1.90 或更高版本。我们建议使用最新的稳定版本。

Kiro

v0.10.78 或更高版本

Cursor

v2.6.18 或更高版本

要将您的远程 IDE 连接到 Studio 空间，需要使用 Amazon Toolkit 扩展。对于 Kiro 和 Cursor，需要 Amazon 工具包扩展版本 v3.100 或更高版本。

操作系统要求

您需要使用下列操作系统之一，才能远程连接到 Studio 空间：

本地计算机先决条件

在将远程 IDE 连接到 Studio 空间之前，请确保您的本地计算机具有所需的依赖项和网络访问权限。

重要

具有软件安装限制的环境可能会阻止用户安装所需的依赖项。在启动远程连接时 Amazon Toolkit for Visual Studio Code 会自动搜索这些依赖关系，如果缺少任何依赖关系，则会提示安装。与您的 IT 部门协调，确保这些组件可用。

所需的本地依赖关系

您的本地计算机必须安装以下组件：

  • Remote-SSH扩展 — 适用于你的 IDE 的远程开发扩展（在 VS Code、Kiro 和 Cursor 的扩展市场中可用）

  • 会话管理器插件-安全会话管理所必需的

  • SSH 客户端 — 大多数计算机上的标准组件（建议在 Windows 上使用 OpenSSH）

  • IDE CLI 命令 — 通常包含在 IDE 安装中（code例如，对于 VS Code，对于 Kiro，对于 Cursor，kiro对cursor于 Cursor）

Platform-specific 要求

  • Windows 用户 — SSH 终端连接需要 PowerShell 5.1 或更高版本

网络连接要求

您的本地计算机必须具有访问会话管理器端点的网络访问权限。例如，在美国东部（弗吉尼亚北部）（us-east-1），它们可以是：

  • ssm.us-east-1.amazonaws.com

  • ssm.us-east-1.api.aws

  • ssmmessages.us-east-1.amazonaws.com

  • ec2messages.us-east-1.amazonaws.com

映像要求

SageMaker 分发图片

使用具有远程访问权限的 SageMaker 分发版时，请使用SageMaker 分发版本 2.7 或更高版本。

自定义图片

当您自带映像（BYOI）进行远程访问时，请确保遵循自定义映像规范，并确保安装了以下依赖项：

  • curl或 wget — 下载 Amazon CLI 组件时必填项

  • unzip— 解压缩 Amazon CLI 安装文件所必需的

  • tar— 档案提取所必需的

  • gzip— 处理压缩文件所必需的

实例要求

  • 内存 – 8GB 或更多

  • 实例类型 – 使用内存至少为 8GB 的实例。因内存不足（小于 8GB），无法支持以下实例类型：ml.t3.medium、ml.c7i.large、ml.c6i.large、ml.c6id.large 和 ml.c5.large。如需更完整的实例类型列表，请参阅 Amazon EC2 On-Demand 定价页面。

主题