사용자에게 사용자 지정 이미지에 대한 액세스 권한 제공

이 설명서에서는 사용자에게 코드 편집기 환경의 사용자 지정 이미지에 대한 액세스 권한을 제공하는 단계별 지침을 제공합니다. 이 페이지의 정보를 사용하여 사용자의 워크플로에 대한 사용자 지정 환경을 생성할 수 있습니다. 이 프로세스에는 다음을 활용하는 것이 포함됩니다.

• Docker

• AWS Command Line Interface

• Amazon Elastic 컨테이너 레지스트리

• Amazon SageMaker AI AWS Management Console

이 페이지의 지침에 따라 Amazon SageMaker AI 도메인의 코드 편집기 사용자는 코드 편집기 공간에서 사용자 지정 이미지 및 환경에 액세스하여 기계 학습 워크플로를 강화할 수 있습니다.

중요

이 페이지에서는 로컬 시스템에 AWS Command Line Interface 및가 Docker 설치되어 있다고 가정합니다.

사용자가 코드 편집기에서 이미지를 성공적으로 실행하도록 하려면 다음을 수행해야 합니다.

사용자가 이미지를 성공적으로 실행하도록 하려면

1. Dockerfile을 생성합니다

2. Dockerfile로부터 이미지를 빌드합니다

3. Amazon Elastic 컨테이너 등록으로 이미지를 업로드합니다

4. Amazon SageMaker AI 도메인에 이미지 연결

5. 사용자가 코드 편집기 공간에서 이미지에 액세스하도록 합니다.

1단계: Dockerfile 생성

Dockerfile을 생성하여 사용자 컨테이너에서 애플리케이션을 실행하는 데 필요한 환경을 생성하는 데 필요한 단계를 정의합니다.

중요

Dockerfile은 Dockerfile 사양에 제공된 사양을 충족해야 합니다.

올바른 형식의 샘플 Dockerfiles는 Dockerfile 샘플 섹션을 참조하세요.

2단계: 이미지 빌드

Dockerfile과 동일한 디렉터리에서 다음 명령을 사용하여 이미지를 빌드합니다.

docker build -t username/imagename:tag your-account-id.dkr.ecr.AWS 리전.amazonaws.com/your-repository-name:tag                                  

중요

이미지에는 123456789012.dkr.ecr.your-region.amazonaws.com/your-repository-name:tag 형식의 태그가 지정되어야 합니다

그렇지 않으면 Amazon Elastic Container Registry 리포지토리로 푸시할 수 없습니다.

3단계: 이미지를 Amazon Elastic Container Registry 리포지토리로 푸시

이미지를 빌드한 후 다음 명령을 사용하여 Amazon ECR 리포지토리에 로그인합니다.

aws ecr get-login-password --region AWS 리전 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.AWS 리전.amazonaws.com                                  

로그인한 후 다음 명령을 사용하여 Dockerfile을 푸시합니다.

docker push 123456789012.dkr.ecr.AWS 리전.amazonaws.com/your-repository-name:tag                

4단계: 사용자의 Amazon SageMaker AI 도메인에 이미지 연결

이미지를 푸시한 후에는 Amazon SageMaker SageMaker AI 도메인에서 이미지에 액세스해야 합니다 AWS CLI.

SageMaker AI 콘솔을 사용하여 이미지 연결

다음 절차에 따라 SageMaker AI 콘솔을 통해 이미지를 SageMaker 도메인에 연결합니다.

1. SageMaker AI 콘솔을 엽니다.

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

3. 도메인 목록에서 도메인을 선택합니다.

4. 환경 탭을 엽니다.

5. 개인 Studio 앱용 사용자 지정 이미지에서 이미지 첨부를 선택합니다.

6. 이미지 소스를 지정합니다. 새 이미지를 생성하거나 기존 이미지를 선택할 수 있습니다.

7. 다음을 선택합니다.

8. 애플리케이션 유형으로 코드 편집기를 선택합니다.

9. 제출을 선택합니다.

를 사용하여 이미지 연결 AWS CLI

다음 절차에 따라 AWS CLI 를 통해 이미지를 SageMaker 도메인에 연결합니다.

1. SageMaker AI 이미지를 생성합니다. 다음 AWS CLI 명령을 사용할 때 AmazonSageMakerFullAccess 정책을 역할에 연결해야 합니다.

   aws sagemaker create-image \
       --image-name code-editor-custom-image \
       --role-arn arn:aws:iam::account-id:role/service-role/execution-role

2. 이미지에서 SageMaker AI 이미지 버전을 생성합니다. 이미지를 Amazon ECR로 푸시할 때 선택한 고유 태그 값을 전달합니다.

   aws sagemaker create-image-version \
       --image-name code-editor-custom-image \
       --base-image repository-uri:tag

3. app-image-config-input.json라는 이름으로 구성 파일을 만듭니다. 애플리케이션 이미지 구성은 SageMaker AI 이미지를 코드 편집기 애플리케이션으로 실행하기 위한 구성으로 사용됩니다. 여기에서 ContainerConfig 인수를 지정할 수도 있습니다.

   {
       "AppImageConfigName": "code-editor-app-image-config",
       "CodeEditorAppImageConfig":
       {
           "ContainerConfig":
           {}
       }
   }

4. 앞서 만든 애플리케이션 이미지 구성 파일을 사용하여 AppImageConfig를 생성합니다.

   aws sagemaker create-app-image-config \
       --cli-input-json file://app-image-config-input.json

5. 구성 파일을 만들고 이름을 updateDomain.json로 지정합니다. 도메인 ID를 지정해야 합니다.

   {
       "DomainId": "domain-id",
       "DefaultUserSettings": {
           "CodeEditorAppSettings": {
               "CustomImages": [
                   {
                       "ImageName": "code-editor-custom-image",
                       "AppImageConfigName": "code-editor-app-image-config"
                   }
               ]
           }
       }
   }

6. 구성 파일을 입력으로 사용하여 UpdateDomain 명령을 호출합니다.

   참고

   도메인을 새 이미지 버전으로 업데이트하기 전에 먼저 도메인의 모든 애플리케이션을 삭제해야 합니다. 애플리케이션을 삭제하기만 하면 됩니다. 사용자 프로필이나 공유 공간을 삭제할 필요는 없습니다. 애플리케이션 삭제에 대한 지침은 다음 옵션 중 하나를 선택합니다.

   • SageMaker AI 콘솔을 사용하는 경우 도메인 삭제(콘솔) 섹션의 1~5d단계와 6~7d단계를 실행합니다.

   • 를 사용하는 경우 도메인 삭제(AWS CLI) 섹션의 1~3단계를 AWS CLI실행합니다.

   aws sagemaker update-domain --cli-input-json file://updateDomain.json

5단계: 사용자가 코드 편집기 공간에서 이미지에 액세스하도록 합니다.

이제 사용자는 코드 편집기 공간에서 도메인에 연결한 이미지를 선택할 수 있습니다.

사용자 지정 이미지를 선택하기에 대한 자세한 내용은 Studio에서 코드 편집기 애플리케이션 시작를 참조하세요.