기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
사용자 지정 SageMaker 이미지 첨부
중요
Amazon SageMaker Studio 또는 Amazon Studio Classic에서 Amazon SageMaker SageMaker 리소스를 생성할 수 있도록 허용하는 사용자 지정 IAM 정책은 해당 리소스에 태그를 추가할 수 있는 권한도 부여해야 합니다. Studio 및 Studio Classic은 생성한 모든 리소스에 자동으로 태그를 지정하므로 리소스에 태그를 추가할 수 있는 권한이 필요합니다. IAM 정책에 따라 Studio 및 Studio Classic에서는 리소스를 생성할 수 있지만 태깅은 허용하지 않는 경우 AccessDenied "“리소스를 생성하려고 할 때 오류가 발생할 수 있습니다. 자세한 정보는 리소스에 태그를 지정할 SageMaker 수 있는 권한 제공을 참조하세요.
AWS Amazon용 관리형 정책 SageMaker리소스 생성 권한을 부여하는 내용에는 해당 SageMaker 리소스를 생성할 때 태그를 추가할 수 있는 권한이 이미 포함되어 있습니다.
이 가이드에서는 SageMaker 콘솔 또는 AWS Command Line Interface (AWS CLI) 를 사용하여 Amazon SageMaker 도메인에 사용자 지정 RStudio 이미지를 연결하는 방법을 보여줍니다.
사용자 지정 SageMaker 이미지를 사용하려면 사용자 지정 RStudio 이미지를 도메인에 연결해야 합니다. 이미지 버전을 첨부하면 RStudio Launcher에 표시되며 이미지 선택 드롭다운 목록에서 사용할 수 있습니다. 드롭다운을 사용하여 RStudio에서 사용하는 이미지를 변경할 수 있습니다.
사용자가 첨부할 수 있는 이미지 버전 수에는 제한이 있습니다. 한도에 도달하면 사용자는 먼저 버전을 분리해야 이미지의 다른 버전을 첨부할 수 있습니다.
콘솔을 사용하여 도메인에 이미지 버전을 연결합니다.
SageMaker 콘솔의 제어판을 사용하여 사용자 지정 SageMaker 이미지 버전을 도메인에 연결할 수 있습니다. 사용자 지정 SageMaker 이미지와 이미지 버전을 만든 다음 해당 버전을 도메인에 연결할 수도 있습니다.
기존 이미지를 첨부하려면
-
https://console.aws.amazon.com/sagemaker/
에서 아마존 SageMaker 콘솔을 엽니다. -
왼쪽 탐색 창에서 관리자 구성을 선택합니다.
-
관리자 구성에서 도메인을 선택합니다.
-
원하는 도메인을 선택합니다.
-
환경을 선택합니다.
-
도메인에 연결된 커스텀 SageMaker 스튜디오 클래식 이미지에서 이미지 첨부를 선택합니다.
-
이미지 소스의 경우 기존 이미지 또는 새 이미지를 선택합니다.
기존 이미지를 선택하는 경우 Amazon 이미지 스토어에서 SageMaker 이미지를 선택합니다.
새 이미지를 선택하는 경우 Docker 이미지의 Amazon ECR 레지스트리 경로를 제공하세요. 경로는 도메인과 AWS 리전 같아야 합니다. Amazon ECR 리포지토리는 도메인과 동일한 계정에 있어야 합니다. 그렇지 않으면 에 대한 교차 계정 권한이 활성화되어 SageMaker 있어야 합니다.
-
목록에서 기존 이미지를 선택합니다.
-
목록에서 이미지 버전을 선택합니다.
-
다음을 선택합니다.
-
이미지 이름, 이미지 표시 이름, 설명에 값을 입력합니다.
-
IAM 역할을 선택합니다. 자세한 정보는 사용자 지정 RStudio 이미지 만들기을 참조하세요.
-
(선택 사항) 이미지에 태그를 추가합니다.
-
(선택 사항) 새 태그 추가를 선택한 다음, 구성 태그를 추가합니다.
-
이미지 유형에서 RStudio 이미지를 선택합니다.
-
제출을 선택합니다.
이미지 버전이 도메인에 연결될 때까지 기다립니다. 버전이 첨부되면 사용자 지정 이미지 목록에 나타나고 잠시 강조 표시됩니다.
를 사용하여 기존 이미지 버전을 도메인에 연결합니다. AWS CLI
를 사용하여 도메인에 이미지 버전을 연결하는 두 가지 방법이 AWS CLI있습니다. 첫 번째 방법에서는 버전이 첨부된 새 도메인을 생성합니다. 이 방법은 더 간단하지만 도메인을 생성하는 데 필요한 Amazon VPC (가상 사설 클라우드) 정보와 실행 역할을 지정해야 합니다.
이미 도메인에 온보딩한 경우 두 번째 방법을 사용하여 이미지 버전을 현재 도메인에 연결할 수 있습니다. 이 경우 Amazon VPC 정보와 실행 역할을 지정하지 않아도 됩니다. 버전을 연결한 후 도메인의 모든 애플리케이션을 삭제하고 RStudio를 다시 시작하십시오.
SageMaker 이미지를 새 도메인에 연결합니다.
이 방법을 사용하려면 AmazonSageMakerFullAccess
다음 단계를 사용하여 도메인을 생성하고 사용자 지정 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
을 삽입합니다.ImageVersionNumber
는 지정되지 않았으므로 이미지의 최신 버전이 사용되며, 이 경우에는 유일한 버전입니다. 실행 역할은 사전 조건 완료의 요구 사항을 충족해야 합니다.{ "DomainName": "domain-with-custom-r-image", "VpcId": "
<vpc-id>
", "SubnetIds": [ "<subnet-ids>
" ], "DomainSettings": { "RStudioServerProDomainSettings": { "DomainExecutionRoleArn": "<execution-role>
" } }, "DefaultUserSettings": { "ExecutionRole": "<execution-role>
", "RSessionAppSettings": { "CustomImages": [ { "AppImageConfigName": "rstudio-custom-config", "ImageName": "rstudio-custom-image" } ] } }, "AuthMode": "IAM" } -
첨부된 사용자 지정 SageMaker 이미지를 사용하여 도메인을 생성합니다.
aws sagemaker create-domain \ --cli-input-json file://create-domain-input.json
응답:
{ "DomainArn": "arn:aws:sagemaker:
region
:acct-id:domain/domain-id
", "Url": "https://domain-id
.studio.region
.sagemaker.aws/..." }
SageMaker 이미지를 기존 도메인에 연결합니다.
이 방법은 이미 도메인에 온보딩했다고 가정합니다. 자세한 정보는 Amazon SageMaker 도메인 개요을 참조하세요.
참고
도메인을 새 이미지 버전으로 업데이트하려면 도메인의 모든 애플리케이션을 삭제해야 합니다. 이러한 응용 프로그램을 삭제하는 방법에 대한 자세한 내용은 Amazon SageMaker 도메인 삭제을 참고하세요.
다음 단계를 사용하여 현재 도메인에 SageMaker 이미지를 추가합니다.
DomainID
SageMaker 콘솔에서 가져오세요.DomainID
를 사용하여 도메인의DefaultUserSettings
를 가져옵니다.ImageName
와AppImageConfig
을CustomImage
로DefaultUserSettings
에 추가합니다.사용자 지정 이미지를 포함하도록 도메인을 업데이트합니다.
도메인에 커스텀 SageMaker 이미지를 추가하려면
-
https://console.aws.amazon.com/sagemaker/
에서 아마존 SageMaker 콘솔을 엽니다. -
왼쪽 탐색 창에서 관리자 구성을 선택합니다.
-
관리자 구성에서 도메인을 선택합니다.
-
원하는 도메인을 선택합니다.
-
도메인 설정을 선택합니다.
-
일반 설정에서 도메인 ID를 찾습니다. ID의 형식은
d-xxxxxxxxxxxx
입니다. -
도메인 ID를 사용하여 도메인에 대한 설명을 가져옵니다.
aws sagemaker describe-domain \ --domain-id
<d-xxxxxxxxxxxx>
응답:
{ "DomainId": "
d-xxxxxxxxxxxx
", "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } } -
DefaultUserSettings
이라는 파일에 대한 응답의update-domain-input.json
섹션을 저장합니다. -
이전 단계의
ImageName
및AppImageConfigName
을 사용자 지정 이미지로 삽입합니다.ImageVersionNumber
는 지정되지 않았으므로 이미지의 최신 버전이 사용되며, 이 경우에는 유일한 버전입니다.{ "DefaultUserSettings": { "RSessionAppSettings": { "CustomImages": [ { "ImageName": "rstudio-custom-image", "AppImageConfigName": "rstudio-custom-config" } ] } } }
-
도메인 ID 및 기본 사용자 설정 파일을 사용하여 도메인을 업데이트합니다.
aws sagemaker update-domain \ --domain-id
<d-xxxxxxxxxxxx>
\ --cli-input-json file://update-domain-input.json응답:
{ "DomainArn": "arn:aws:sagemaker:
region
:acct-id:domain/domain-id
" } -
RStudioServerPro
애플리케이션을 삭제합니다. 최신 변경 내용을 적용하려면 먼저 RStudio Launcher UI에서RStudioServerPro
도메인 공유 애플리케이션을 다시 시작해야 합니다.aws sagemaker delete-app \ --domain-id
<d-xxxxxxxxxxxx>
--user-profile-name domain-shared \ --app-type RStudioServerPro --app-name default -
새로운
RStudioServerPro
애플리케이션을 생성합니다. 먼저 AWS CLI를 사용하여 이 애플리케이션을 만들어야 합니다.aws sagemaker create-app \ --domain-id
<d-xxxxxxxxxxxx>
--user-profile-name domain-shared \ --app-type RStudioServerPro --app-name default