기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon SageMaker Studio에서 로컬 모드 지원
<a name="studio-updated-local"></a>

**중요**  
Amazon SageMaker Studio 또는 Amazon SageMaker Studio Classic에서 Amazon SageMaker 리소스를 생성할 수 있도록 허용하는 사용자 지정 IAM 정책도 해당 리소스에 태그를 추가할 수 있는 권한을 부여해야 합니다. Studio와 Studio Classic은 만드는 리소스에 태그를 자동으로 지정하기 때문에 리소스에 태그를 추가할 권한이 필요합니다. IAM 정책이 Studio 및 Studio Classic에서 리소스를 만들도록 허용하지만 태그 지정은 허용하지 않는 경우 리소스 만들기를 시도할 때 'AccessDenied' 오류가 발생할 수 있습니다. 자세한 내용은 [SageMaker AI 리소스 태그 지정을 위한 권한 제공](security_iam_id-based-policy-examples.md#grant-tagging-permissions) 섹션을 참조하세요.  
[AWS Amazon SageMaker AI에 대한 관리형 정책](security-iam-awsmanpol.md)는 SageMaker 리소스를 생성할 수 있는 권한을 부여합니다. 여기에는 해당 리소스를 생성하는 동안 태그를 추가할 수 있는 권한이 이미 포함되어 있습니다.

Amazon SageMaker Studio 애플리케이션은 로컬 모드를 사용하여 추정기, 프로세서 및 파이프라인을 생성한 다음 로컬 환경에 배포할 수 있도록 지원합니다. 로컬 모드를 사용하면 Amazon SageMaker AI 관리형 훈련 또는 호스팅 환경에서 실행하기 전에 기계 학습 스크립트를 테스트할 수 있습니다. Studio는 다음 애플리케이션에서 로컬 모드를 지원합니다.
+ Amazon SageMaker Studio Classic
+ JupyterLab
+ 코드 편집기, Code-OSS 기반, Visual Studio 코드 - 오픈 소스

Studio 애플리케이션의 로컬 모드는 SageMaker Python SDK를 사용하여 호출됩니다. Studio 애플리케이션에서 로컬 모드는 Amazon SageMaker 노트북 인스턴스에서 작동하는 방식과 비슷하게 작동하며 몇 가지 차이점이 있습니다. [루트리스 Docker 구성](studio-updated-local-get-started.md#studio-updated-local-rootless)을 활성화하면 온프레미스 리포지토리 및 퍼블릭 레지스트리를 포함하여 VPC 구성을 통해 추가 Docker 레지스트리에도 액세스할 수 있습니다. SageMaker Python SDK로 로컬 모델을 사용하는 방법에 대한 자세한 내용은 [로컬 모드](https://sagemaker.readthedocs.io/en/stable/overview.html#local-mode) 섹션을 참조하세요.

**참고**  
Studio 애플리케이션은 로컬 모드에서 다중 컨테이너 작업을 지원하지 않습니다. 로컬 모드 작업은 훈련, 추론 및 처리 작업을 위한 단일 인스턴스로 제한됩니다. 로컬 모드 작업을 생성할 때 인스턴스 수 구성은 `1`여야 합니다. 

## Docker 지원
<a name="studio-updated-local-docker"></a>

로컬 모드 지원의 일환으로 Studio 애플리케이션은 제한된 Docker 액세스 기능을 지원합니다. 이 지원을 통해 사용자는 Jupyter 노트북의 Docker API 또는 애플리케이션의 이미지 터미널과 상호 작용할 수 있습니다. 고객은 다음 중 하나를 사용하여 Docker와 상호 작용할 수 있습니다.
+ [Docker CLI](https://docs.docker.com/engine/reference/run/)
+ [Docker Compose CLI](https://docs.docker.com/compose/reference/)
+ 언어별 Docker SDK 클라이언트

Studio는 다음 제한이 있는 제한된 Docker 액세스 기능도 지원합니다.
+ Docker 네트워크 사용은 지원되지 않습니다.
+ 컨테이너 실행 중에는 Docker [볼륨](https://docs.docker.com/storage/volumes/) 사용량이 지원되지 않습니다. 컨테이너 오케스트레이션 중에는 볼륨 바인드 탑재 입력만 허용됩니다. 볼륨 바인드 탑재 입력은 Studio Classic용 Amazon Elastic File System(Amazon EFS) 볼륨에 있어야 합니다. JupyterLab 및 코드 편집기 애플리케이션의 경우 Amazon Elastic Block Store(Amazon EBS) 볼륨에 있어야 합니다.
+ 컨테이너 검사 작업은 허용됩니다.
+ 컨테이너 포트와 호스트 매핑은 허용되지 않습니다. 그러나 호스팅할 포트를 지정할 수 있습니다. 그런 다음 다음 URL을 사용하여 Studio에서 엔드포인트에 액세스할 수 있습니다.

  ```
  http://localhost:{{port}}
  ```

### 지원되는 Docker 작업
<a name="studio-updated-local-docker-supported"></a>

다음 표에는 지원 제한을 포함하여 Studio에서 지원되는 모든 Docker API 엔드포인트가 나열되어 있습니다. API 엔드포인트가 테이블에 누락된 경우 Studio는 이를 지원하지 않습니다.


|  API 설명서  |  제한 사항  | 
| --- | --- | 
|  [SystemAuth](https://docs.docker.com/engine/api/v1.43/#tag/System/operation/SystemAuth)  |   | 
|  [SystemEvents](https://docs.docker.com/engine/api/v1.43/#tag/System/operation/SystemEvents)  |   | 
|  [SystemVersion](https://docs.docker.com/engine/api/v1.43/#tag/System/operation/SystemVersion)  |   | 
|  [SystemPing](https://docs.docker.com/engine/api/v1.43/#tag/System/operation/SystemPing)  |   | 
|  [SystemPingHead](https://docs.docker.com/engine/api/v1.43/#tag/System/operation/SystemPingHead)  |   | 
|  [ContainerCreate](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerCreate)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/sagemaker/latest/dg/studio-updated-local.html)  | 
|  [ContainerStart](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerStart)  |   | 
|  [ContainerStop](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerStop)  |   | 
|  [ContainerKill](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerKill)  |   | 
|  [ContainerDelete](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerDelete)  |   | 
|  [ContainerList](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerList)  |   | 
|  [ContainerLogs](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerLogs)  |   | 
|  [ContainerInspect](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerInspect)  |   | 
|  [ContainerWait](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerWait)  |   | 
|  [ContainerAttach](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerAttach)  |   | 
|  [ContainerPrune](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerPrune)  |   | 
|  [ContainerResize](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerResize)  |   | 
|  [ImageCreate](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageCreate)  |  VPC-only 모드 지원은 허용 목록에 있는 계정의 Amazon ECR 이미지로 제한됩니다. [루트리스 Docker 구성](studio-updated-local-get-started.md#studio-updated-local-rootless)을 활성화하면 온프레미스 리포지토리 및 퍼블릭 레지스트리를 포함하여 VPC 구성을 통해 추가 Docker 레지스트리에도 액세스할 수 있습니다. | 
|  [ImagePrune](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImagePrune)  |   | 
|  [ImagePush](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImagePush)  |  VPC-only 모드 지원은 허용 목록에 있는 계정의 Amazon ECR 이미지로 제한됩니다. [루트리스 Docker 구성](studio-updated-local-get-started.md#studio-updated-local-rootless)을 활성화하면 온프레미스 리포지토리 및 퍼블릭 레지스트리를 포함하여 VPC 구성을 통해 추가 Docker 레지스트리에도 액세스할 수 있습니다. | 
|  [ImageList](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageList)  |   | 
|  [ImageInspect](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageInspect)  |   | 
|  [ImageGet](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageGet)  |   | 
|  [ImageDelete](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageDelete)  |   | 
|  [ImageBuild](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageBuild)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/sagemaker/latest/dg/studio-updated-local.html)  | 

**Topics**
+ [Docker 지원](#studio-updated-local-docker)
+ [로컬 모드 시작하기](studio-updated-local-get-started.md)