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

# 도메인에 사용자 지정 이미지 연결
<a name="studio-updated-byoi-how-to-attach-to-domain"></a>

이 페이지에서는 사용자 지정 이미지를 도메인에 연결하는 방법에 대한 지침을 제공합니다. 다음 절차에 따라 Amazon SageMaker AI 콘솔을 사용하여 도메인으로 이동하고 **이미지 연결** 프로세스를 시작합니다.

다음 지침에서는 도메인 AWS 리전 과 동일한의 Amazon ECR 리포지토리에 이미지를 푸시했다고 가정합니다. 아직 이 작업을 수행하지 않았다면 [사용자 지정 이미지를 생성하고 Amazon ECR로 푸시](studio-updated-byoi-how-to-prepare-image.md) 섹션을 참조하세요.

이미지를 연결할 때는 두 가지 옵션이 있습니다.
+ **새 이미지** 연결: 이 옵션은 SageMaker AI 이미지 저장소에 이미지 및 이미지 버전을 생성한 다음 도메인에 연결합니다.
**참고**  
BYOI 프로세스를 계속하는 경우 [사용자 지정 이미지를 생성하고 Amazon ECR로 푸시](studio-updated-byoi-how-to-prepare-image.md)에서 **새 이미지** 옵션을 사용합니다.
+ **기존 이미지** 연결: SageMaker AI 이미지 저장소에서 의도한 사용자 지정 이미지를 이미 생성한 경우 이 옵션을 사용합니다. 이 옵션은 기존 사용자 지정 이미지를 도메인에 연결합니다. SageMaker AI 이미지 저장소에서 사용자 지정 이미지를 보려면 [사용자 지정 이미지 세부 정보 보기(콘솔)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console) 섹션을 참조하세요.

------
#### [ New image ]

**도메인에 새 이미지를 연결하는 방법**

1. [SageMaker AI 콘솔](https://console.aws.amazon.com/sagemaker)을 엽니다.

1. 아직 확장하지 않았으면 **관리자 구성** 섹션을 확장합니다.

1. **관리자 구성**에서 **도메인**을 선택합니다.

1. **도메인** 목록에서 이미지를 연결할 도메인을 선택합니다.
**참고**  
이미지를 SageMaker Unified Studio 프로젝트에 연결하고 사용할 도메인에 대한 설명이 필요한 경우 [프로젝트와 연결된 SageMaker AI 도메인 세부 정보 보기를 참조하세요](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain).

1. **환경** 탭을 엽니다.

1. **개인 Studio 앱용 사용자 지정 이미지**에서 **이미지 연결**을 선택합니다.

1. **이미지 소스**에서 **새 이미지**를 선택합니다.

1. Amazon ECR 이미지 URI를 포함합니다. 형식은 다음과 같습니다.

   ```
   account-id.dkr.ecr.aws-region.amazonaws.com/repository-name:tag
   ```

   1. Amazon ECR 이미지 URI를 가져오려면 [Amazon ECR 프라이빗 리포지토리](https://console.aws.amazon.com/ecr/private-registry/repositories) 페이지로 이동합니다.

   1. 리포지토리 이름 링크를 선택합니다.

   1. 이미지 버전(**이미지 태그**)에 해당하는 **URI 복사** 아이콘을 선택합니다.

1. 나머지 지침에 따라 사용자 지정 이미지를 연결합니다.
**참고**  
`Dockerfile`과 일관적인 애플리케이션 유형을 사용하고 있는지 확인합니다. 자세한 내용은 [Dockerfile 샘플](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates) 단원을 참조하십시오.

이미지가 도메인에 성공적으로 연결되면 **환경** 탭에서 볼 수 있습니다.

------
#### [ Existing image ]

**도메인에 기존 이미지를 연결하는 방법**

1. [SageMaker AI 콘솔](https://console.aws.amazon.com/sagemaker)을 엽니다.

1. 아직 확장하지 않았으면 **관리자 구성** 섹션을 확장합니다.

1. **관리자 구성**에서 **도메인**을 선택합니다.

1. **도메인** 목록에서 이미지를 연결할 도메인을 선택합니다.
**참고**  
이미지를 SageMaker Unified Studio 프로젝트에 연결하고 사용할 도메인에 대한 설명이 필요한 경우 [프로젝트와 연결된 SageMaker AI 도메인 세부 정보 보기를 참조하세요](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain).

1. **환경** 탭을 엽니다.

1. **개인 Studio 앱용 사용자 지정 이미지**에서 **이미지 연결**을 선택합니다.

1. **이미지 소스**에서 **기존 이미지**를 선택합니다.

1. SageMaker AI 이미지 저장소에서 기존 이미지 및 이미지 버전을 선택합니다.

   이미지 버전을 볼 수 없는 경우 이미지 버전을 생성해야 할 수 있습니다. 자세한 내용은 [사용자 지정 이미지 세부 정보 보기(콘솔)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console) 단원을 참조하십시오.

1. 나머지 지침에 따라 사용자 지정 이미지를 연결합니다.
**참고**  
`Dockerfile`과 일관적인 애플리케이션 유형을 사용하고 있는지 확인합니다. 자세한 내용은 [Dockerfile 샘플](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates) 단원을 참조하십시오.

이미지가 도메인에 성공적으로 연결되면 **환경** 탭에서 볼 수 있습니다.

------

이미지가 도메인에 성공적으로 연결되면 도메인 사용자는 애플리케이션에서 해당 이미지를 선택할 수 있습니다. 자세한 내용은 [Studio에서 사용자 지정 이미지 시작](studio-updated-byoi-how-to-launch.md) 단원을 참조하십시오.

**참고**  
SageMaker Unified Studio 프로젝트에 사용자 지정 이미지를 연결한 경우 SageMaker Unified Studio 내에서 애플리케이션을 시작해야 합니다. 자세한 내용은 *Amazon SageMaker Unified Studio 사용 설명서*의 [Launch your custom image](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html)를 참조하세요.