View a markdown version of this page

Studio에서 Amazon EFS 생성 및 자동 탑재 - Amazon SageMaker AI

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

Studio에서 Amazon EFS 생성 및 자동 탑재

Amazon SageMaker AI는 도메인에 대한 Amazon EFS 볼륨을 생성하고 각 사용자에 대해 홈 디렉터리 폴더를 자동으로 탑재할 수 있도록 지원합니다. 이 폴더를 사용하면 사용자는 자신의 프라이빗 스페이스 간에 데이터를 공유할 수 있습니다. 그러나 사용자는 도메인의 다른 사용자와 데이터를 공유할 수 없습니다. 사용자는 자신의 폴더에만 액세스할 수 있습니다.

중요

2026년 6월 1일 이후에 생성된 도메인의 경우 도메인 생성 중에 EFS가 기본적으로 생성되지 않습니다(빠른 설정용). 자동 탑재를 활성화하려면 먼저 EFS 생성을 활성화해야 합니다.

EFS 생성 및 자동 탑재 설정

Amazon SageMaker Studio의 EFS에는 두 가지 설정이 함께 작동합니다.

  • HomeEFSCreation - 도메인에 대해 SageMaker AI에서 EFS 파일 시스템을 생성하고 관리할지 여부를 제어합니다.

    빠른 설정을 통해 생성된 새 도메인의 기본값: 비활성화됨

    활성화된 경우:이 도메인에 대해 SageMaker AI에서 관리하는 새 EFS 파일 시스템을 생성합니다.

  • AutoMountHomeEFS - EFS 스토리지가 사용자에게 자동으로 마운트되는지 여부를 제어합니다.

    기본값: 활성화됨(HomeEFSCreation가 활성화된 경우)

    설명: 각 사용자가 노트북, 데이터 및 코드를 프라이빗 스페이스에서 공유할 수 있도록 홈 디렉터리를 자동으로 탑재합니다.

    이 설정은가 활성화된 경우에만 편집할 수 HomeEFSCreation 있습니다.

    사용자 프로필 수준에서이 값은 기본적으로 DefaultAsDomain(도메인 수준 설정 상속)으로 설정됩니다.

주요 동작:

  • 에 값을 설정하지 않으면 AutoMountHomeEFS자동 탑재 EFS가 기본적으로 활성화됩니다.

  • 기존 공간이 있는 경우 공간을 다시 시작하여 EFS를 탑재합니다.

  • 자동 탑재 EFS는 프라이빗 스페이스에만 사용할 수 있습니다.

EFS 생성 및 자동 탑재 활성화

도메인 생성 후(빠른 설정):

  1. SageMaker AI 콘솔을 엽니다.

  2. 왼쪽 탐색 창의 관리자 구성에서 도메인을 선택합니다.

  3. 도메인을 선택한 다음 도메인 설정 탭을 선택합니다.

  4. 스토리지 구성 섹션에서 편집을 선택합니다.

  5. EFS 스토리지 및 암호화에서 켜기HomeEFSCreation로 전환합니다. 이렇게 하면이 도메인에 대해 SageMaker AI에서 관리하는 새 EFS 파일 시스템이 생성됩니다.

  6. AutoMountHomeEFS가 켜져 있는지 확인합니다(HomeEFSCreation가 켜져 있을 때 기본적으로 활성화됨). 이렇게 하면 각 사용자가 노트북, 데이터 및 코드를 프라이빗 공간에서 공유할 수 있도록 홈 디렉터리가 자동으로 마운트됩니다.

  7. 제출을 선택합니다.

  8. 기존 공백이 있는 경우 다시 시작하여 EFS 데이터에 액세스합니다.

사용자 지정 설정의 경우 EFS 생성 및 자동 탑재가 기본적으로 활성화됩니다.

사용자의 폴더는 user-default-efs라는 폴더를 통해 액세스할 수 있습니다. 이 폴더는 Studio 애플리케이션의 $HOME 디렉터리에 있습니다.

Amazon EFS 자동 탑재 옵트아웃에 대한 자세한 내용은 Amazon EFS 자동 탑재 옵트아웃 섹션을 참조하세요.

Amazon EFS 자동 탑재를 사용하면 Studio Classic에서 Studio로 데이터를 쉽게 마이그레이션할 수 있습니다. 자세한 내용은 (선택 사항) Studio Classic에서 Studio로 데이터 마이그레이션 섹션을 참조하세요.

액세스 포인트 정보

자동 탑재가 활성화되면 SageMaker AI는 Amazon EFS 액세스 포인트를 사용하여 Amazon EFS 볼륨의 데이터에 대한 액세스를 용이하게 합니다. 액세스 포인트에 대한 자세한 내용은 Working with Amazon EFS access points를 참조하세요. SageMaker AI는 사용자 프로필 생성 중 또는 기존 사용자 프로필에 대한 애플리케이션 생성 중에 도메인의 각 사용자 프로필에 대한 고유한 액세스 포인트를 생성합니다. 액세스 포인트의 POSIX 사용자 값은 SageMaker AI가 액세스 포인트를 생성하는 사용자 프로필의 HomeEfsFileSystemUid 값과 일치합니다. 사용자의 값을 가져오려면 DescribeUserProfile 참조하세요. 루트 디렉터리 경로도 POSIX 사용자 값과 동일한 값으로 설정됩니다. 

SageMaker AI는 새 디렉터리의 권한을 다음 값으로 설정합니다.

  • 소유자 사용자 ID: POSIX user value

  • 소유자 그룹 ID: 0

  • 권한 700

Amazon EFS 볼륨에 액세스하려면 액세스 포인트가 필요합니다. 따라서 Amazon EFS 볼륨에 대한 액세스 권한을 잃지 않고 액세스 포인트를 삭제하거나 업데이트할 수 없습니다.

오류 해결

애플리케이션 생성 중에 Amazon EFS 사용자 폴더를 자동 탑재할 때 SageMaker AI에 문제가 발생하면 애플리케이션이 계속 생성됩니다. 그러나 이 경우 SageMaker AI는 Amazon EFS 폴더를 탑재하는 대신 error.txt라는 파일을 생성합니다. 이 파일은 발생한 오류와 이를 해결하는 단계를 설명합니다. SageMaker AI는 애플리케이션의 $HOME 디렉터리에 있는 user-default-efs 폴더에 error.txt 파일을 생성합니다.