기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
도메인 또는 사용자 프로필에 사용자 지정 파일 시스템 연결
도메인을 생성하면 Amazon은 SageMaker 자동으로 도메인을 SageMaker 에서 생성하는 Amazon Elastic File System (AmazonEFS) 볼륨과 연결합니다. 도메인을 에서 생성한 사용자 지정 Amazon EFS 파일 시스템과 연결할 수도 있습니다 AWS 계정. 이 파일 시스템은 Amazon SageMaker Studio를 사용할 때 도메인에 속한 모든 사용자가 사용할 수 있습니다. 사용자는 지원되는 애플리케이션 JupyterLab 및 Code Editor에 대해 생성한 모든 공간에 파일 시스템을 연결할 수 있습니다. 그런 다음 공간을 실행하고 애플리케이션을 시작한 후 파일 시스템에 포함된 모든 데이터, 코드 또는 기타 아티팩트에 액세스할 수 있습니다.
도메인의 모든 사용자가 파일 시스템에 액세스하도록 허용하지 않으려면 대신 특정 사용자 프로필에 연결할 수 있습니다. 이렇게 하면 파일 시스템은 연결된 사용자가 생성한 공백에서만 사용할 수 있습니다.
Amazon SageMaker API, AWS SDKs또는 를 사용하여 사용자 지정 파일 시스템을 연결할 수 있습니다 AWS CLI. SageMaker 콘솔을 사용하여 사용자 지정 파일 시스템을 연결할 수 없습니다.
사전 조건
사용자 지정 Amazon EFS 파일 시스템을 도메인에 연결하려면 먼저 다음 요구 사항을 충족해야 합니다.
-
에 Amazon EFS 파일 시스템이 있습니다 AWS 계정. 생성 단계는 Amazon Elastic EFS File System 사용 설명서의 Amazon 파일 시스템 생성을 참조하세요. Amazon Elastic File System
-
Studio가 파일 시스템에 액세스하려면 먼저 도메인과 연결하는 각 서브넷에 탑재 대상이 있어야 합니다. 서브넷에 탑재 대상을 할당하는 방법에 대한 자세한 내용은 Amazon Elastic File System 사용 설명서의 탑재 대상 및 보안 그룹 생성 및 관리를 참조하세요.
-
각 탑재 대상에 대해 도메인을 SageMaker 생성할 AWS 계정 때 Amazon이 에서 생성한 보안 그룹을 추가해야 합니다. 보안 그룹 이름의 형식은 입니다
security-group-for-inbound-nfs-
.domain-id
-
IAM 권한을 통해
elasticfilesystem:DescribeMountTargets
작업을 사용할 수 있어야 합니다. 이 작업에 대한 자세한 내용은 서비스 승인 참조의 Amazon Elastic File System에 대한 작업, 리소스 및 조건 키를 참조하세요.
를 사용하여 사용자 지정 파일 시스템 연결 AWS CLI
를 사용하여 도메인 또는 사용자 프로필에 사용자 지정 파일 시스템을 연결하려면 다음 명령 중 하나를 사용할 때 CustomFileSystemConfigs
정의를 AWS CLI전달합니다.
예 사용자 지정 파일 시스템을 사용한 create-domain 명령
다음 예제에서는 파일 시스템을 새 도메인에 연결합니다.
aws sagemaker create-domain --domain-name
domain-name
\ --vpc-idvpc-id
--subnet-idssubnet-ids
--auth-mode IAM \ --default-user-settings file://default-user-settings.json \ --default-space-settings "ExecutionRole=execution-role-arn
"
이 예제에서는 파일에 CustomPosixUserConfig
및 CustomFileSystemConfigs
키를 포함하는 다음 설정이 default-user-settings.json
있습니다.
{ "ExecutionRole": "
execution-role-arn
", "CustomPosixUserConfig": { "Uid":UID
, "Gid":GID
}, "CustomFileSystemConfigs": [ { "EFSFileSystemConfig": { "FileSystemId": "file-system-id
", "FileSystemPath": "/
" } } ] }
이 예제 구성에는 다음 키가 있습니다.
ExecutionRole
-
도메인 사용자의 기본 실행 역할입니다.
CustomPosixUserConfig
-
파일 시스템 작업에 사용되는 기본 POSIX 자격 증명입니다. 이러한 설정을 사용하여 사용자 지정 파일 시스템에 액세스하는 사용자 프로필에 기존 POSIX 권한 구조를 적용할 수 있습니다. POSIX 권한 수준에서 파일 시스템에 액세스할 수 있는 사용자와 액세스할 수 있는 파일 또는 데이터를 제어할 수 있습니다.
create-user-profile
명령을 사용하여 사용자 프로필을 생성할 때CustomPosixUserConfig
설정을 적용할 수도 있습니다. 사용자 프로필에 적용하는 설정은 연결된 도메인에 적용하는 설정을 재정의합니다.참고
create-domain
및create-user-profile
명령을 사용할 때CustomPosixUserConfig
설정을 적용할 수 있습니다. 그러나 다음과 같은 경우에는 이러한 설정을 적용할 수 없습니다.-
사용자 프로필과 이미 연결된 도메인에 대해
update-domain
명령을 사용합니다. 이러한 설정은 사용자 프로필이 없는 도메인에만 적용할 수 있습니다. -
update-user-profile
명령을 사용합니다. 이미 생성한 프로필에 이러한 설정을 적용하려면 프로필을 삭제하고 업데이트된 설정이 있는 새 설정을 생성합니다.
-
Uid
-
POSIX 사용자 ID입니다. 기본값은 200001입니다.
Gid
-
POSIX 그룹 ID입니다. 기본값은 1001입니다.
CustomFileSystemConfigs
-
사용자 지정 파일 시스템 설정(Amazon EFS 파일 시스템만 지원됨).
create-user-profile
또는update-user-profile
명령을 사용할 때 사용자 프로필에CustomFileSystemConfigs
설정을 적용할 수도 있습니다. 사용자 프로필은 해당 파일 시스템과 도메인에 연결하는 모든 에 액세스할 수 있습니다. EFSFileSystemConfig
-
사용자 지정 Amazon EFS 파일 시스템의 설정입니다.
FileSystemId
-
Amazon EFS 파일 시스템의 ID입니다.
FileSystemPath
-
Studio의 해당 공간에 있는 도메인 사용자가 액세스할 수 있는 파일 시스템 디렉터리의 경로입니다. 허용된 사용자는 이 디렉터리 이하에만 액세스할 수 있습니다. 기본 경로는 파일 시스템 루트: 입니다
/
.
SageMaker 는 다음 경로에 심볼 링크를 생성합니다/home/sagemaker-user/custom-file-systems/
. 이를 통해 도메인 사용자는 홈 디렉터리 에서 사용자 지정 파일 시스템으로 이동할 수 있습니다file-system-type
/file-system-id
/home/sagemaker-user
.
사용자 지정 파일 시스템을 도메인에 연결한 후 도메인 사용자는 create-space 명령을 사용할 때 파일 시스템을 공간에 연결할 수 있습니다.
예 사용자 지정 파일 시스템을 사용한 create-space
명령
다음 예제에서는 파일 시스템을 새 공간에 연결합니다.
aws sagemaker create-space \ --space-name
space-name
\ --domain-iddomain-id
\ --ownership-settings "OwnerUserProfileName=user-profile-name
" \ --space-sharing-settings "SharingType=Private" \ --space-settings file://space-settings.json
이 예제에서 파일에space-settings.json
는 FileSystemId
키가 있는 CustomFileSystems
구성을 포함하는 다음 설정이 있습니다.
{ "AppType": "JupyterLab", "JupyterLabAppSettings": { "DefaultResourceSpec": { "InstanceType": "
ml.t3.xlarge
" } }, "CustomFileSystems": [ { "EFSFileSystem": { "FileSystemId": "file-system-id
" } } ] }