기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 원격 액세스를 사용하여 원격 IDE를 SageMaker 스페이스에 연결
원격 IDE에서 Amazon SageMaker Studio 스페이스로 원격으로 연결할 수 있습니다. Amazon SageMaker AI의 확장 가능한 컴퓨팅 리소스와 함께 AI 지원 개발 도구 및 사용자 지정 확장을 포함한 사용자 지정 로컬 IDE 설정을 사용할 수 있습니다. 이 안내서에서는 관리자 및 사용자를 위한 개념과 설정 지침을 제공합니다.
원격 IDE 연결은 로컬 IDE와 SageMaker 공간 간에 보안 연결을 설정합니다. 이 연결을 통해 다음을 수행할 수 있습니다.
+ **SageMaker AI 컴퓨팅 리소스에 액세스** - 로컬 환경에서 확장 가능한 SageMaker AI 인프라에 대해 코드 실행
+ **보안 경계 유지** - SageMaker AI와 동일한 보안 프레임워크 내에서 작업
+ **익숙한 IDE 경험 유지** - 원격 개발을 지원하는 호환되는 로컬 확장, 테마 및 구성 사용
**참고**
모든 IDE 확장이 원격 개발과 호환되는 것은 아닙니다. 로컬 GUI 구성 요소가 필요하거나 아키텍처 종속성이 있거나 클라이언트와 서버 간에 특정 상호 작용이 필요한 확장은 원격 환경에서 제대로 작동하지 않을 수 있습니다. 사용 전에 필요한 확장이 원격 개발을 지원하는지 확인합니다.
**Topics**
+ [주요 개념](#remote-access-key-concepts)
+ [연결 메서드](#remote-access-connection-methods)
+ [지원되는 IDE](#remote-access-supported-ides)
+ [IDE 버전 요구 사항](#remote-access-ide-version-requirements)
+ [운영 체제 요구 사항](#remote-access-os-requirements)
+ [로컬 시스템 사전 조건](#remote-access-local-prerequisites)
+ [이미지 요구 사항](#remote-access-image-requirements)
+ [인스턴스 요구 사항](#remote-access-instance-requirements)
+ [원격 액세스 설정](remote-access-remote-setup.md)
+ [원격 IDE 설정](remote-access-local-ide-setup.md)
+ [지원되는 AWS 리전](remote-access-supported-regions.md)
## 주요 개념
+ **원격 연결** - 원격 IDE와 SageMaker 공간 간의 보안 터널입니다. 이 연결을 통해 SageMaker AI 컴퓨팅 리소스를 사용하여 대화형 개발 및 코드 실행이 가능합니다.
+ [https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-spaces.html](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-spaces.html) - Studio 애플리케이션의 스토리지 및 리소스를 관리할 수 있는 Amazon SageMaker Studio 내의 전용 환경입니다.
+ **딥 링크** - 로컬 IDE에 대한 원격 연결을 시작하는 SageMaker UI의 버튼(직접 URL)입니다.
## 연결 메서드
원격 IDE를 SageMaker 스페이스에 연결하는 세 가지 주요 방법이 있습니다.
+ **딥 링크 액세스** - SageMaker AI에서 사용할 수 있는 **Open space with** 버튼을 사용하여 특정 공간에 직접 연결할 수 있습니다. 그러면 URL 패턴을 사용하여 원격 연결을 설정하고 원격 IDE에서 SageMaker 공간을 엽니다.
+ [https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) - AWS Toolkit for Visual Studio Code를 사용하여 인증할 수 있습니다. 이렇게 하면 스페이스에 연결하고 원격 IDE에서 원격으로 연결된 창을 열 수 있습니다.
+ **SSH 터미널 연결** - SSH 구성을 사용하여 명령줄을 통해 연결할 수 있습니다.
## 지원되는 IDE
Studio 스페이스에 대한 원격 연결은 다음을 지원합니다.
+ [Visual Studio Code](https://code.visualstudio.com/)
+ [Kiro](https://kiro.dev/)
+ [Cursor](https://cursor.com/home)
## IDE 버전 요구 사항
다음 표에는 지원되는 각 원격 IDE에 대한 최소 버전 요구 사항이 나열되어 있습니다.
| IDE | 최소 버전 |
| --- | --- |
| Visual Studio Code | [v1.90](https://code.visualstudio.com/updates/v1_90) 이상. [안정적인 최신 버전을](https://code.visualstudio.com/updates) 사용하는 것이 좋습니다. |
| Kiro | v0.10.78 이상 |
| Cursor | v2.6.18 이상 |
원격 IDE를 Studio 스페이스에 연결하려면 AWS 도구 키트 확장이 필요합니다. Kiro 및 Cursor의 경우 AWS Toolkit 확장 버전 v3.100 이상이 필요합니다.
## 운영 체제 요구 사항
Studio 스페이스에 원격으로 연결하려면 다음 운영 체제 중 하나가 필요합니다.
+ macOS 13\+
+ Windows 10
+ [Windows 10 지원은 2025년 10월 14일에 종료됨](https://support.microsoft.com/en-us/windows/windows-10-support-ends-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281)
+ Windows 11
+ Linux
+ VS Code의 경우 오픈 소스 버전이 아닌 [Linux용 공식 Microsoft VS Code](https://code.visualstudio.com/docs/setup/linux)를 설치합니다.
## 로컬 시스템 사전 조건
원격 IDE를 Studio 스페이스에 연결하기 전에 로컬 시스템에 필요한 종속성과 네트워크 액세스 권한이 있는지 확인합니다.
**중요**
소프트웨어 설치 제한이 있는 환경에서는 사용자가 필수 종속성을 설치하지 못할 수 있습니다. 는 원격 연결을 시작할 때 이러한 종속성을 AWS Toolkit for Visual Studio Code 자동으로 검색하고 누락된 항목이 있는 경우 설치를 요청합니다. IT 부서와 협력하여 이러한 구성 요소를 사용할 수 있는지 확인합니다.
**필수 로컬 종속성**
로컬 시스템에는 다음 구성 요소가 설치되어 있어야 합니다.
+ **[원격 SSH 확장 -](https://code.visualstudio.com/docs/remote/ssh)** IDE의 원격 개발 확장(VS Code, Kiro 및 Cursor용 확장 마켓플레이스에서 사용 가능)
+ **[세션 관리자 플러그인](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)** - 보안 세션 관리에 필요합니다.
+ **SSH 클라이언트** - 대부분의 시스템에서 표준 구성 요소([Windows의 경우 OpenSSH 권장](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse))
+ **IDE CLI 명령** - 일반적으로 IDE 설치에 포함됨(예: VS Code의 `code` 경우 , Kiro`kiro`의 경우 , Cursor`cursor`의 경우 )
**플랫폼별 요구 사항**
+ **Windows 사용자** - SSH 터미널 연결에는 PowerShell 5.1 이상이 필요합니다.
**네트워크 연결 요구 사항**
로컬 시스템에[는 세션 관리자 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/ssm.html)에 대한 네트워크 액세스 권한이 있어야 합니다. 예를 들어 미국 동부(버지니아 북부)(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 Distribution을 사용하는 경우 [SageMaker Distribution](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-distribution.html) 버전 2.7 이상을 사용합니다.
**사용자 지정 이미지**
원격 액세스[기존 보유 이미지 사용(BYOI)](studio-updated-byoi.md)가 가능한 경우 [사용자 지정 이미지 사양을](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-byoi-specs.html) 따르고 다음 종속성이 설치되어 있는지 확인합니다.
+ `curl` 또는 `wget` - 구성 요소를 다운로드하는 AWS CLI 데 필요합니다.
+ `unzip` - AWS CLI 설치 파일을 추출하는 데 필요합니다.
+ `tar` - 아카이브 추출에 필요
+ `gzip` - 압축 파일 처리에 필요합니다.
## 인스턴스 요구 사항
+ **메모리** - 8GB 이상
+ **인스턴스 유형** - 메모리가 8GB 이상인 인스턴스를 사용합니다. 메모리 부족(8GB 미만)으로 인해 `ml.t3.medium`, `ml.c7i.large`, `ml.c6i.large`, `ml.c6id.large`, `ml.c5.large` 인스턴스 유형은 지원되지 *않습니다*. 인스턴스 유형의 전체 목록은 [Amazon EC2 온디맨드 요금 페이지](https://aws.amazon.com/ec2/pricing/on-demand/)를 참조하세요.
**Topics**
+ [주요 개념](#remote-access-key-concepts)
+ [연결 메서드](#remote-access-connection-methods)
+ [지원되는 IDE](#remote-access-supported-ides)
+ [IDE 버전 요구 사항](#remote-access-ide-version-requirements)
+ [운영 체제 요구 사항](#remote-access-os-requirements)
+ [로컬 시스템 사전 조건](#remote-access-local-prerequisites)
+ [이미지 요구 사항](#remote-access-image-requirements)
+ [인스턴스 요구 사항](#remote-access-instance-requirements)
+ [원격 액세스 설정](remote-access-remote-setup.md)
+ [원격 IDE 설정](remote-access-local-ide-setup.md)
+ [지원되는 AWS 리전](remote-access-supported-regions.md)