도메인 또는 사용자 프로필에 사용자 지정 파일 시스템 연결 - Amazon SageMaker

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

도메인 또는 사용자 프로필에 사용자 지정 파일 시스템 연결

도메인을 생성하면 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 파일 시스템을 도메인에 연결하려면 먼저 다음 요구 사항을 충족해야 합니다.

를 사용하여 사용자 지정 파일 시스템 연결 AWS CLI

를 사용하여 도메인 또는 사용자 프로필에 사용자 지정 파일 시스템을 연결하려면 다음 명령 중 하나를 사용할 때 CustomFileSystemConfigs정의를 AWS CLI전달합니다.

예 사용자 지정 파일 시스템을 사용한 create-domain 명령

다음 예제에서는 파일 시스템을 새 도메인에 연결합니다.

aws sagemaker create-domain --domain-name domain-name \ --vpc-id vpc-id --subnet-ids subnet-ids --auth-mode IAM \ --default-user-settings file://default-user-settings.json \ --default-space-settings "ExecutionRole=execution-role-arn"

이 예제에서는 파일에 CustomPosixUserConfigCustomFileSystemConfigs 키를 포함하는 다음 설정이 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-domaincreate-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-id domain-id \ --ownership-settings "OwnerUserProfileName=user-profile-name" \ --space-sharing-settings "SharingType=Private" \ --space-settings file://space-settings.json

이 예제에서 파일에space-settings.jsonFileSystemId 키가 있는 CustomFileSystems 구성을 포함하는 다음 설정이 있습니다.

{ "AppType": "JupyterLab", "JupyterLabAppSettings": { "DefaultResourceSpec": { "InstanceType": "ml.t3.xlarge" } }, "CustomFileSystems": [ { "EFSFileSystem": { "FileSystemId": "file-system-id" } } ] }