사용 가능한 옵션 - Amazon SageMaker

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

사용 가능한 옵션

다음 표에는 Studio에서 노트북 작업을 실행하든, 로컬 Jupyter 환경을 실행하든, SageMaker Python을 사용하든 관계없이 노트북 작업을 사용자 지정하는 데 사용할 수 있는 모든 옵션이 표시됩니다SDK. 테이블에는 사용자 지정 옵션 유형, 설명, 옵션 사용 방법에 대한 추가 지침, Studio의 옵션 필드 이름(사용 가능한 경우) 및 SageMaker Python의 노트북 작업 단계의 파라미터 이름SDK(사용 가능한 경우)이 포함되어 있습니다.

일부 옵션의 경우 노트북 작업을 설정할 때마다 사용자 지정 기본값을 지정할 필요가 없도록 사용자 지정 기본값을 미리 설정할 수도 있습니다. Studio의 경우 이러한 옵션은 역할 , 입력 폴더 , 출력 폴더 및 KMS 키 ID 이며 다음 표에 지정되어 있습니다. 이러한 옵션에 대한 사용자 지정 기본값을 미리 설정하면 노트북 작업을 생성할 때 작업 생성 양식에 이러한 필드가 미리 채워집니다. Studio 및 로컬 Jupyter 환경에서 사용자 지정 기본값을 생성하는 방법에 대한 자세한 내용은 섹션을 참조하세요로컬 노트북 기본 옵션 설정.

또한 는 SageMaker SDK 를 생성할 때 이러한 파라미터를 지정할 필요가 없도록 지능형 기본값을 설정하는 옵션을 제공합니다NotebookJobStep. 이러한 파라미터는 role, , s3_root_uri, s3_kms_keyvolume_kms_key, security_group_ids, subnets, 이며 다음 표에 지정되어 있습니다. 지능형 기본값을 설정하는 방법에 대한 자세한 내용은 섹션을 참조하세요기본 옵션 설정.

사용자 지정 옵션 설명 스튜디오별 가이드라인 로컬 Jupyter 환경 가이드라인 SageMaker Python SDK 지침
작업 이름 노트북 작업 대시보드에 표시될 작업 이름입니다. 필드 작업 이름 . Studio와 동일합니다. 파라미터 notebook_job_name. 기본값은 None입니다.
이미지 선택한 컴퓨팅 유형에서 노트북을 비대화형 방식으로 실행하는 데 사용되는 컨테이너 이미지입니다. 필드 이미지 . 이 필드의 기본값은 노트북의 현재 이미지입니다. 필요한 경우 이 필드를 기본값에서 사용자 지정 값으로 변경하세요. Studio에서 이 값을 추론할 수 없는 경우 양식에 유효성 검사 오류가 표시되어 값을 지정해야 합니다. 이 이미지는 사용자 지정 이미지, bring-your-own 이미지 또는 사용 가능한 Amazon SageMaker 이미지일 수 있습니다. 노트북 스케줄러에서 지원하는 사용 가능한 SageMaker 이미지 목록은 섹션을 참조하세요Studio Classic과 함께 사용할 수 있는 Amazon SageMaker 이미지. 필드 이미지 . 이 필드에는 선택한 컴퓨팅 유형에서 제공된 노트북을 실행할 수 있는 도커 이미지 ECR URI 중 가 필요합니다. 기본적으로 스케줄러 확장은 미리 빌드된 SageMaker Docker 이미지인 기본 Python 2.0을 사용합니다. 이는 boto3 및 Python 3 커널을 DockerHub 사용한 AWS CLI의 공식 Python 3.8 이미지입니다. 노트북 사용자 지정 이미지 사양을 ECR URI 충족하는 를 제공할 수도 있습니다. 세부 정보는 사용자 지정 SageMaker 이미지 사양을 참조하세요. 이 이미지에는 노트북 실행에 필요한 모든 커널과 라이브러리가 있어야 합니다. 필수 여부. 파라미터 image_uri. URI 에서 Docker 이미지의 위치입니다ECR. 이러한 이미지를 기반으로 특정 SageMaker 배포 이미지 또는 사용자 지정 이미지를 사용하거나 추가 요구 사항을 충족하는 노트북 작업 종속성이 사전 설치된 자체 이미지를 사용할 수 있습니다. 세부 정보는 Python SDK 노트북 작업에 대한 SageMaker 이미지 제약 조건을 참조하세요.
인스턴스 유형 노트북 작업을 실행하는 데 사용할 EC2 인스턴스 유형입니다. 노트북 작업은 SageMaker 훈련 작업을 컴퓨팅 계층으로 사용하므로 지정된 인스턴스 유형은 SageMaker 훈련 지원 인스턴스 유형이어야 합니다. 필드 컴퓨팅 유형 . 기본값은 ml.m5.large입니다. Studio와 동일합니다. 파라미터 instance_type. 기본값은 ml.m5.large입니다.
커널 노트북 작업을 실행하는 데 사용되는 Jupyter 커널입니다. 필드 커널 . 이 필드의 기본값은 노트북의 현재 커널입니다. 필요한 경우 이 필드를 기본값에서 사용자 지정 값으로 변경하세요. Studio에서 이 값을 추론할 수 없는 경우 양식에 유효성 검사 오류가 표시되어 값을 지정해야 합니다. 필드 커널 . 이 커널은 이미지에 나타나야 하며 Jupyter 커널 사양을 따라야 합니다. 이 필드는 기본 Python 2.0이미지에 있는 Python3 커널로 기본 설정됩니다. SageMaker 필요한 경우 이 필드를 사용자 지정 값으로 변경하세요. 필수 여부. 파라미터 kernel_name. 이 커널은 이미지에 나타나야 하며 Jupyter 커널 사양을 따라야 합니다. 이미지의 커널 식별자를 보려면 ()를 참조하세요LINK.
SageMaker 세션 SageMaker 서비스 호출이 위임되는 기본 SageMaker 세션입니다. N/A N/A 파라미터 sagemaker_session. 지정되지 않은 경우 기본 구성 체인을 사용하여 생성됩니다.
역할 ARN 노트북 작업에 사용되는 역할의 Amazon 리소스 이름(ARN)입니다. 필드 역할 ARN. 이 필드의 기본값은 Studio 실행 역할입니다. 필요한 경우 이 필드를 사용자 지정 값으로 변경하세요.
참고

Studio가 이 값을 추론할 수 없는 경우 역할 ARN 필드는 비어 있습니다. 이 경우 사용ARN하려는 를 삽입합니다.

 필드 역할 ARN. 이 필드의 기본값은 SagemakerJupyterScheduler접두사가 붙은 모든 역할입니다. 접두사가 붙은 역할이 여러 개 있는 경우 확장 프로그램은 하나를 선택합니다. 필요한 경우 이 필드를 사용자 지정 값으로 변경하세요. 이 필드에는 새 작업 정의를 만들 때마다 미리 채워지는 사용자 기본값을 설정할 수 있습니다. 세부 정보는 로컬 노트북 기본 옵션 설정을 참조하세요. 파라미터 role. SDK 가 SageMaker 노트북 또는 SageMaker Studio 노트북에서 실행 중인 경우 SageMaker 기본 IAM 역할로 기본 설정됩니다. 그렇지 않으면 가 발생합니다ValueError. 지능형 기본값을 허용합니다.
입력 노트북 실행을 예약하는 노트북의 이름입니다. 필수 여부. 필드 입력 파일 . Studio와 동일합니다. 필수 .Parameter input_notebook.
입력 폴더 입력이 포함된 폴더입니다. 입력 노트북과 선택적 시작 또는 초기화 스크립트를 포함한 작업 입력이 이 폴더에 저장됩니다. 필드 입력 폴더 . 폴더를 제공하지 않으면 스케줄러가 입력에 대한 기본 Amazon S3 버킷을 생성합니다. Studio와 동일합니다. 이 필드에는 새 작업 정의를 만들 때마다 미리 채워지는 사용자 기본값을 설정할 수 있습니다. 세부 정보는 로컬 노트북 기본 옵션 설정을 참조하세요. 해당 없음. 입력 폴더는 파라미터 에 지정된 위치 내에 배치됩니다s3_root_uri.
출력 폴더 출력이 포함된 폴더입니다. 출력 노트북과 로그를 포함한 작업 출력이 이 폴더에 저장됩니다. 필드 출력 폴더 . 폴더를 지정하지 않으면 스케줄러가 출력에 대한 기본 Amazon S3 버킷을 생성합니다. Studio와 동일합니다. 이 필드에는 새 작업 정의를 만들 때마다 미리 채워지는 사용자 기본값을 설정할 수 있습니다. 세부 정보는 로컬 노트북 기본 옵션 설정을 참조하세요. 해당 없음. 출력 폴더는 파라미터 에 지정된 위치 내에 배치됩니다s3_root_uri.
파라미터 노트북 작업에 전달할 변수 및 값의 사전입니다. 필드 파라미터 . 파라미터를 수락하려면 노트북을 파라미터화해야 합니다. Studio와 동일합니다. 파라미터 parameters. 파라미터를 수락하려면 노트북을 파라미터화해야 합니다.
추가(파일 또는 폴더) 종속성 노트북 작업이 s3 스테이징된 폴더에 업로드하는 파일 또는 폴더 종속성 목록입니다. 지원하지 않음. 지원하지 않음. 파라미터 additional_dependencies. 노트북 작업은 이러한 종속성을 S3 스테이지 폴더에 업로드하여 실행 중에 사용할 수 있도록 합니다.
S3 루트 URI 입력이 포함된 폴더입니다. 입력 노트북과 선택적 시작 또는 초기화 스크립트를 포함한 작업 입력이 이 폴더에 저장됩니다. 해당 없음. 입력 폴더 및 출력 폴더 를 사용합니다. Studio와 동일합니다. 파라미터 s3_root_uri. 기본값은 기본 S3 버킷입니다. 지능형 기본값을 허용합니다.
환경 변수 재정의하려는 기존 환경 변수 또는 노트북에 도입하여 사용하려는 새 환경 변수입니다. 필드 환경 변수 . Studio와 동일합니다. 파라미터 environment_variables. 기본값은 None입니다.
Tags 작업에 연결된 태그 목록입니다. N/A N/A 파라미터 tags. 기본값은 None입니다. 태그는 Studio UI가 파이프라인에서 생성된 작업을 캡처하고 표시하는 방법을 제어합니다. 세부 정보는 Studio UI 대시보드에서 노트북 작업 보기을 참조하세요.
시작 스크립트 노트북 시작 메뉴에 미리 로드된 스크립트로, 노트북을 실행하기 전에 실행하도록 선택할 수 있습니다. 필드 시작 스크립트 . 시작 시 이미지에서 실행되는 수명 주기 구성(LCC) 스크립트를 선택합니다.
참고

시작 스크립트는 Studio 환경 외부의 쉘에서 실행됩니다. 따라서 이 스크립트는 Studio 로컬 스토리지, 환경 변수 또는 앱 메타데이터(/opt/ml/metadata 내)에 종속될 수 없습니다. 또한 시작 스크립트와 초기화 스크립트를 사용하는 경우 시작 스크립트가 먼저 실행됩니다.

 지원하지 않음. 지원하지 않음.
초기화 스크립트 노트북을 시작할 때 실행할 수 있는 로컬 스크립트 경로입니다. 필드 초기화 스크립트 . 로컬 스크립트 또는 수명 주기 구성(LCC) 스크립트가 있는 EFS 파일 경로를 입력합니다. 시작 스크립트와 초기화 스크립트를 사용하는 경우 시작 스크립트가 먼저 실행됩니다.
참고

초기화 스크립트는 노트북 작업과 동일한 쉘에서 제공됩니다. 앞서 설명한 시작 스크립트에는 해당되지 않습니다. 또한 시작 스크립트와 초기화 스크립트를 사용하는 경우 시작 스크립트가 먼저 실행됩니다.

 필드 초기화 스크립트 . 로컬 스크립트 또는 수명 주기 구성(LCC) 스크립트가 있는 로컬 파일 경로를 입력합니다. 파라미터 initialization_script. 기본값은 None입니다.
최대 재시도 횟수 Studio가 실패한 작업 실행을 다시 실행하려고 시도하는 횟수입니다. 필드 최대 재시도는 를 시도합니다. 기본값은 1입니다. Studio와 동일합니다. 파라미터 max_retry_attempts. 기본값은 1입니다.
최대 실행 시간(초) 중지되기 전까지 노트북 작업을 실행할 수 있는 최대 시간(초)입니다. 최대 실행 시간과 최대 재시도 횟수를 모두 구성한 경우 실행 시간이 각 재시도에 적용됩니다. 이 시간에 작업이 완료되지 않으면 Failed상태로 설정됩니다. 필드 최대 실행 시간(초) 기본값은 172800 seconds (2 days)입니다. Studio와 동일합니다. 파라미터 max_runtime_in_seconds. 기본값은 172800 seconds (2 days)입니다.
재시도 정책 실패 시 취해야 할 작업을 관리하는 재시도 정책 목록입니다. 지원하지 않음. 지원하지 않음. 파라미터 retry_policies. 기본값은 None입니다.
Step 또는 StepCollection 종속성 추가 작업이 종속되는 Step 또는 StepCollection 이름 또는 인스턴스의 목록입니다. 지원하지 않음. 지원하지 않음. 파라미터 depends_on. 기본값은 None입니다. 이를 사용하여 파이프라인 그래프의 단계 간에 명시적 종속성을 정의합니다.
볼륨 크기 훈련 중 입력 및 출력 데이터를 저장하기 위한 스토리지 볼륨의 GB 단위 크기입니다. 지원하지 않음. 지원하지 않음. 파라미터 volume_size. 기본값은 30GB 입니다.
컨테이너 간 트래픽 암호화 훈련 컨테이너 간의 트래픽이 훈련 작업에 대해 암호화되는지 여부를 지정하는 플래그입니다. 해당 없음. 기본적으로 활성화됩니다. 해당 없음. 기본적으로 활성화됩니다. 파라미터 encrypt_inter_container_traffic. 기본값은 True입니다.
작업 구성 암호화 노트북 작업 출력, 작업 인스턴스 볼륨 또는 둘 다를 암호화하려는 표시기입니다. 필드 작업 암호화 구성. 암호화를 선택하려면 이 확인란을 선택하세요. 선택하지 않으면 작업 출력이 계정의 기본 KMS 키로 암호화되고 작업 인스턴스 볼륨은 암호화되지 않습니다. Studio와 동일합니다. 지원하지 않음.
출력 암호화 KMS 키 노트북 작업 출력에 사용되는 암호화 KMS 키를 사용자 지정하려는 경우 사용할 키입니다. 이 필드는 작업 구성 암호화를 선택한 경우에만 적용됩니다. 필드 출력 암호화 KMS 키 . 이 필드를 지정하지 않으면 노트북 작업 출력이 기본 Amazon S3 KMS 키를 사용하여 SSE로KMS 암호화됩니다. 또한 Amazon S3 버킷을 직접 생성하고 암호화를 사용하는 경우 암호화 방법이 보존됩니다. Studio와 동일합니다. 이 필드에는 새 작업 정의를 만들 때마다 미리 채워지는 사용자 기본값을 설정할 수 있습니다. 세부 정보는 로컬 노트북 기본 옵션 설정을 참조하세요. 파라미터 s3_kms_key. 기본값은 None입니다. 지능형 기본값을 허용합니다.
작업 인스턴스 볼륨 암호화 KMS 키 작업 인스턴스 볼륨을 암호화하려는 경우 사용할 KMS 키입니다. 이 필드는 작업 구성 암호화를 선택한 경우에만 적용됩니다. 필드 작업 인스턴스 볼륨 암호화 KMS 키 . 필드 작업 인스턴스 볼륨 암호화 KMS 키 . 이 필드에는 새 작업 정의를 만들 때마다 미리 채워지는 사용자 기본값을 설정할 수 있습니다. 세부 정보는 로컬 노트북 기본 옵션 설정을 참조하세요. 파라미터 volume_kms_key. 기본값은 None입니다. 지능형 기본값을 허용합니다.
Virtual Private Cloud를 사용하여 이 작업 실행(VPC사용자용) Virtual Private Cloud()에서 이 작업을 실행하려는 지표입니다VPC. 보안을 강화하려면 프라이빗 를 사용하는 것이 좋습니다VPC. 필드 Virtual Private Cloud를 사용하여 이 작업을 실행합니다. 를 사용하려면 이 상자를 선택합니다VPC. 노트북 작업이 해당 AWS 리소스에 비공개로 연결할 수 있도록 하려면 최소한 다음 VPC 엔드포인트를 생성합니다.
를 사용하도록 선택한 경우 다음 옵션에서 하나 이상의 프라이빗 서브넷과 하나 이상의 보안 그룹을 지정VPC해야 합니다. 프라이빗 서브넷을 사용하지 않는 경우 다른 구성 옵션을 고려해야 합니다. 자세한 내용은 에서 지원되지 않는 퍼블릭 VPC 서브넷을 참조하세요제약 조건 및 고려 사항.		 Studio와 동일합니다. N/A
서브넷(들)(VPC사용자용) 사용자 서브넷입니다. 이 필드는 최소 1개에서 최대 5개를 포함해야 하며 제공하는 모든 서브넷은 사설이어야 합니다. 자세한 내용은 에서 지원되지 않는 퍼블릭 VPC 서브넷을 참조하세요제약 조건 및 고려 사항. 필드 서브넷(들) 이 필드는 기본적으로 Studio 도메인과 연결된 서브넷으로 설정되지만 필요한 경우 이 필드를 변경할 수 있습니다. 필드 서브넷(들) 스케줄러가 서브넷을 감지할 수 없으므로 에 대해 구성한 서브넷을 입력해야 합니다VPC. 파라미터 subnets. 기본값은 None입니다. 지능형 기본값을 허용합니다.
보안 그룹(들)(VPC사용자용) 사용자 보안 그룹입니다. 이 필드는 최소 1개, 최대 15개를 포함해야 합니다. 자세한 내용은 에서 지원되지 않는 퍼블릭 VPC 서브넷을 참조하세요제약 조건 및 고려 사항. 필드 보안 그룹 . 이 필드는 기본적으로 도메인 과 연결된 보안 그룹으로 설정VPC되지만 필요한 경우 이 필드를 변경할 수 있습니다. 필드 보안 그룹 . 스케줄러는 보안 그룹을 감지할 수 없으므로 에 대해 구성한 보안 그룹을 입력해야 합니다VPC. 파라미터 security_group_ids. 기본값은 None입니다. 지능형 기본값을 허용합니다.
명칭 노트북 작업 단계의 이름입니다. N/A N/A 파라미터 name. 지정되지 않은 경우 노트북 파일 이름에서 파생됩니다.
표시 명칭 파이프라인 실행 목록에 표시될 작업 이름입니다. N/A N/A 파라미터 display_name. 기본값은 None입니다.
설명 작업에 대한 설명입니다. N/A N/A 파라미터 description.