도메인에 SageMaker 이미지 연결 공유 공간에 SageMaker 이미지를 첨부합니다.첨부된 이미지 보기

사용자 지정 SageMaker 이미지 첨부

중요

2023년 11월 30일부터 이전 아마존 SageMaker 스튜디오 익스피리언스는 이제 아마존 SageMaker 스튜디오 클래식으로 명명되었습니다. 다음 섹션은 스튜디오 클래식 애플리케이션 사용에 대한 내용입니다. 업데이트된 Studio 환경 사용에 대한 자세한 내용은 을 참조하십시오아마존 SageMaker 스튜디오.

사용자 지정 SageMaker 이미지를 사용하려면 도메인 또는 공유 공간에 이미지 버전을 첨부해야 합니다. 이미지 버전을 첨부하면 SageMaker Studio Classic Launcher에 나타나고 이미지 선택 드롭다운 목록에서도 사용할 수 있습니다. 이 목록에서 사용자가 활동을 시작하거나 노트북에서 사용하는 이미지를 변경하는 데 사용합니다.

도메인 내 모든 사용자가 사용자 지정 SageMaker 이미지를 사용할 수 있게 하려면 이미지를 도메인에 연결합니다. 공유 스페이스 내의 모든 사용자가 이미지를 사용할 수 있게 하려면 공유 스페이스에 이미지를 첨부하면 됩니다. 단일 사용자가 이미지를 사용할 수 있게 하려면 이미지를 사용자 프로필에 첨부합니다. 이미지를 첨부할 때 는 기본적으로 최신 이미지 버전을 SageMaker 사용합니다. 특정 이미지 버전을 첨부할 수도 있습니다. 버전을 연결한 후 노트북을 실행할 때 SageMaker 런처 또는 이미지 선택기에서 버전을 선택할 수 있습니다.

특정 시점에 첨부할 수 있는 이미지 버전 수에는 제한이 있습니다. 한도에 도달한 후 다른 버전의 이미지를 연결하려면 버전을 분리해야 합니다.

다음 섹션에서는 SageMaker 콘솔 또는 를 사용하여 도메인에 사용자 지정 SageMaker 이미지를 첨부하는 방법을 보여줍니다. AWS CLI AWS CLI를 사용하여 공유 스페이스에만 사용자 지정 이미지를 첨부할 수 있습니다.

도메인에 SageMaker 이미지 연결

콘솔을 사용하여 SageMaker 이미지 첨부

이 항목에서는 SageMaker 제어판을 사용하여 기존 사용자 지정 SageMaker 이미지 버전을 도메인에 연결하는 방법을 설명합니다. 사용자 지정 SageMaker 이미지 및 이미지 버전을 만든 다음 해당 버전을 도메인에 연결할 수도 있습니다. 이미지 및 이미지 버전을 생성하는 절차는 커스텀 SageMaker 이미지 만들기을 참조하십시오.

기존 이미지를 첨부하려면

https://console.aws.amazon.com/sagemaker/ 에서 아마존 SageMaker 콘솔을 엽니다.
왼쪽 탐색 창에서 관리자 구성을 선택합니다.
관리자 구성에서 도메인을 선택합니다.
도메인 페이지에서 이미지를 첨부할 도메인을 선택합니다.
도메인 세부 정보 페이지에서 환경 탭을 선택합니다.
환경 탭의 도메인에 연결된 Custom SageMaker Studio Classic 이미지에서 이미지 첨부를 선택합니다.
이미지 소스의 경우 기존 이미지를 선택합니다.
목록에서 기존 이미지를 선택합니다.
목록에서 이미지 버전을 선택합니다.
다음을 선택합니다.
이미지 이름, 이미지 표시 이름, 설명의 값을 확인합니다.
IAM 역할을 선택합니다. 자세한 내용은 커스텀 SageMaker 이미지 만들기을 참조하십시오.
(선택 사항) 이미지에 태그를 추가합니다.
EFS 마운트 경로를 지정합니다. 사용자의 Amazon Elastic File System(EFS) 홈 디렉터리를 마운트할 이미지 내의 경로입니다.
이미지 유형에서 SageMaker 스튜디오 이미지를 선택합니다.
커널 이름의 경우 이미지에 있는 기존 커널의 이름을 입력합니다. 이미지에서 커널 정보를 가져오는 방법에 대한 자세한 내용은 SageMaker Studio Classic 사용자 지정 이미지 샘플 저장소의 개발을 참조하십시오. 자세한 내용은 사용자 지정 SageMaker 이미지 사양의 커널 검색 및 사용자 데이터 섹션을 참조하십시오.
(선택 사항) 커널 표시 이름에 커널의 표시 이름을 입력합니다.
커널 추가를 선택합니다.
제출을 선택합니다.
1. 이미지 버전이 도메인에 연결될 때까지 기다립니다. 첨부하면 버전이 사용자 지정 이미지 목록에 표시되고 간략하게 강조 표시됩니다.

를 사용하여 SageMaker 이미지를 첨부하십시오. AWS CLI

다음 섹션에서는 를 사용하여 새 도메인을 만들거나 기존 도메인을 업데이트할 때 사용자 지정 SageMaker 이미지를 첨부하는 방법을 보여줍니다AWS CLI.

SageMaker 이미지를 새 도메인에 연결합니다.

다음 섹션에서는 버전이 첨부된 새 도메인을 생성하는 방법을 보여줍니다. 이러한 단계를 수행하려면 도메인을 생성하는 데 필요한 Amazon Virtual Private Cloud(VPC) 정보와 실행 역할을 지정해야 합니다. 다음 단계를 수행하여 도메인을 만들고 사용자 지정 SageMaker 이미지를 첨부합니다.

기본 VPC ID 및 서브넷 ID를 가져옵니다.
이미지를 지정하는 도메인의 구성 파일을 생성합니다.
구성 파일로 도메인을 생성합니다.

도메인에 커스텀 SageMaker 이미지를 추가하려면

기본 VPC ID를 가져옵니다.


aws ec2 describe-vpcs \
    --filters Name=isDefault,Values=true \
    --query "Vpcs[0].VpcId" --output text

응답은 다음과 유사하게 보여야 합니다.


vpc-xxxxxxxx

이전 단계의 VPC ID를 사용하여 기본 서브넷 ID를 가져옵니다.


aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

응답은 다음과 유사하게 보여야 합니다.


[
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

create-domain-input.json라는 이름으로 구성 파일을 만듭니다. VPC ID, 서브넷 ID, ImageName, AppImageConfigName및 이전 단계의 VPC ID를 삽입합니다. ImageVersionNumber가 지정되지 않았으므로 이미지의 최신 버전이 사용되며, 이 경우에는 유일한 버전입니다.


{
    "DomainName": "domain-with-custom-image",
    "VpcId": "<vpc-id>",
    "SubnetIds": [
        "<subnet-ids>"
    ],
    "DefaultUserSettings": {
        "ExecutionRole": "<execution-role>",
        "KernelGatewayAppSettings": {
            "CustomImages": [
                {
                    "ImageName": "custom-image",
                    "AppImageConfigName": "custom-image-config"
                }
            ]
        }
    },
    "AuthMode": "IAM"
}

첨부된 사용자 지정 SageMaker 이미지를 사용하여 도메인을 생성합니다.


aws sagemaker create-domain \
    --cli-input-json file://create-domain-input.json

응답은 다음과 유사하게 보여야 합니다.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx",
    "Url": "https://d-xxxxxxxxxxxx.studio.us-east-2.sagemaker.aws/..."
}

SageMaker 이미지를 현재 도메인에 연결합니다.

도메인에 온보딩한 경우 사용자 지정 이미지를 현재 SageMaker 도메인에 첨부할 수 있습니다. SageMaker 도메인 온보딩에 대한 자세한 내용은 을 참조하십시오. 아마존 SageMaker 도메인 개요 현재 도메인에 사용자 지정 이미지를 첨부할 때 VPC 정보 및 실행 역할을 지정할 필요가 없습니다. 버전을 연결한 후에는 도메인의 모든 앱을 삭제하고 Studio Classic을 다시 열어야 합니다. 앱 삭제에 대한 정보는 아마존 SageMaker 도메인 삭제를 참조하십시오.

다음 단계를 수행하여 현재 도메인에 SageMaker 이미지를 추가합니다.

DomainID SageMaker 제어판에서 가져오세요.
DomainID를 사용하여 도메인의 DefaultUserSettings를 가져옵니다.
ImageName와 AppImageConfig를 DefaultUserSettings에 CustomImage로 추가합니다.
사용자 지정 이미지를 포함하도록 도메인을 업데이트합니다.

도메인에 사용자 지정 SageMaker 이미지를 추가하려면

https://console.aws.amazon.com/sagemaker/ 에서 아마존 SageMaker 콘솔을 엽니다.
왼쪽 탐색 창에서 관리자 구성을 선택합니다.
관리자 구성에서 도메인을 선택합니다.
도메인 페이지에서 이미지를 첨부할 도메인을 선택합니다.
도메인 세부정보 페이지에서 도메인 설정 탭을 선택합니다.
도메인 설정 탭의 일반 설정에서 DomainId을 찾을 수 있습니다. ID의 형식은 d-xxxxxxxxxxxx입니다.

도메인 ID를 사용하여 도메인에 대한 설명을 가져옵니다.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

응답은 다음과 유사하게 보여야 합니다.


{
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

default-user-settings.json라는 파일에 대한 응답의 기본 사용자 설정 섹션을 저장합니다.

이전 단계의 ImageName및 AppImageConfigName를 사용자 지정 이미지로 삽입합니다. ImageVersionNumber가 지정되지 않았으므로 이미지의 최신 버전이 사용되며, 이 경우에는 이 버전만 사용됩니다.


{
    "DefaultUserSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

도메인 ID 및 기본 사용자 설정 파일을 사용하여 도메인을 업데이트합니다.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-user-settings.json

응답은 다음과 유사하게 보여야 합니다.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

공유 공간에 SageMaker 이미지를 첨부합니다.

를 사용하여 공유 공간에만 SageMaker 이미지를 첨부할 수 AWS CLI 있습니다. 버전을 연결한 후에는 공유 공간에서 모든 애플리케이션을 삭제하고 Studio Classic을 다시 열어야 합니다. 앱 삭제에 대한 정보는 아마존 SageMaker 도메인 삭제를 참조하십시오.

다음 단계를 수행하여 공유 공간에 SageMaker 이미지를 추가합니다.

DomainID SageMaker 제어판에서 가져오세요.
DomainID를 사용하여 도메인의 DefaultSpaceSettings를 가져옵니다.
ImageName와 AppImageConfig를 DefaultSpaceSettings에 CustomImage로 추가합니다.
공유 스페이스에 대한 사용자 지정 이미지를 포함하도록 도메인을 업데이트합니다.

공유 공간에 사용자 지정 SageMaker 이미지를 추가하려면

https://console.aws.amazon.com/sagemaker/ 에서 아마존 SageMaker 콘솔을 엽니다.
왼쪽 탐색 창에서 관리자 구성을 선택합니다.
관리자 구성에서 도메인을 선택합니다.
도메인 페이지에서 이미지를 첨부할 도메인을 선택합니다.
도메인 세부정보 페이지에서 도메인 설정 탭을 선택합니다.
도메인 설정 탭의 일반 설정에서 DomainId을 찾을 수 있습니다. ID의 형식은 d-xxxxxxxxxxxx입니다.

도메인 ID를 사용하여 도메인에 대한 설명을 가져옵니다.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

응답은 다음과 유사하게 보여야 합니다.


{
    "DomainId": "d-xxxxxxxxxxxx",
    ...
    "DefaultSpaceSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

default-space-settings.json라는 파일에 대한 응답의 기본 스페이스 설정 섹션을 저장합니다.


{
    "DefaultSpaceSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

도메인 ID 및 기본 스페이스 설정 파일을 사용하여 도메인을 업데이트합니다.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-space-settings.json

응답은 다음과 유사하게 보여야 합니다.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

첨부된 이미지는 에서 볼 수 있습니다. SageMaker

사용자 지정 SageMaker 이미지를 생성하여 도메인에 연결하면 도메인의 환경 탭에 이미지가 나타납니다. 다음 명령을 사용하여 AWS CLI를 통해 공유 스페이스에 대한 첨부된 이미지만 볼 수 있습니다.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

SageMaker 이미지 만들기

사용자 지정 이미지 실행