View a markdown version of this page

작업에 대한 후크, 이벤트 및 통합 지점 - 기한 클라우드
워크스테이션에서 사용자 지정 로직 실행작업자에서 사용자 지정 로직 실행클라우드의 이벤트에 대응통합 지점 선택추가 리소스

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

작업에 대한 후크, 이벤트 및 통합 지점

Deadline Cloud는 작업에 대한 자체 로직을 실행할 수 있는 여러 통합 지점을 제공합니다. 통합 지점은 Deadline Cloud가 작업자를 준비하는 스크립트 또는 작업 이벤트에 반응하는 규칙과 같이 사용자가 구성하는 서비스에 대해 사용자 지정 코드 또는 핸드 컨트롤을 실행하는 작업 수명 주기의 위치입니다. 통합 지점을 사용하여 Deadline Cloud를 프로덕션 파이프라인에 맞게 조정합니다. 즉, 소프트웨어를 설치하거나, 환경 변수를 설정하거나, 작업을 검증 또는 변경하거나, 출력을 처리하거나, 다운스트림 자동화를 트리거할 수 있습니다.

통합 지점은 다음 세 가지 질문에 따라 다릅니다.

  • 코드가 실행되는 위치 - 워크스테이션, 작업자 또는 AWS 클라우드.

  • 실행 시 - 제출 시, 작업 전후 또는 이벤트에 대한 응답으로 실행됩니다.

  • 구성 위치 - 워크스테이션 설정, 작업 번들, 대기열 또는 플릿 속성 또는 자체 AWS 계정.

다음 다이어그램은 작업 수명 주기 동안 각 통합 지점이 실행되는 위치를 보여줍니다. 워크스테이션에서 제출부터 작업자 실행, AWS 계정의 이벤트 기반 자동화에 이르기까지 흐름을 제어합니다.

  • 워크스테이션 - 제출자 후크 및 호스트 구성 스크립트는 한 번 실행됩니다.

  • 작업자 - 대기열, 작업 및 단계 환경은 세션 범위의 입력 및 종료 작업을 사용합니다. 작업 실행은 작업을 실행합니다. 종속 단계는 작업이 완료된 후 실행됩니다.

  • AWS 계정 - EventBridge 이벤트와 CloudWatch 지표 및 경보는 상태 변경에 비동기적으로 응답합니다.

워크스테이션, 작업자 및 클라우드 전반의 작업 수명 주기 통합 지점.

다음 표에는 통합 지점이 요약되어 있습니다. 이전 질문에 대한 답변을 기반으로 하나를 선택합니다. 표 뒤의 섹션에서는 각 옵션과 자세한 지침에 대한 링크를 설명합니다.

통합 지점 에서 실행 에서 구성됨 실행 시 에 사용

제출자 후크

워크스테이션

워크스테이션 구성(모든 작업) 또는 작업 번들

제출 중, 작업이 생성되기 전

환경 변수 주입 또는 재정의, 작업 번들 검증 또는 재작성, 제출 시 프로덕션 추적 소프트웨어와 동기화

호스트 구성 스크립트

작업자

플릿 속성(서비스 관리형 플릿)

관리자 권한이 있는 작업자당, 시작 시 1회

네트워크 구성, 승격된 권한이 필요한 소프트웨어 설치

대기열 환경

작업자

대기열 속성

세션이 들어오거나 나갈 때 대기열의 모든 작업에 대해

프로젝트 수준 구성: 관리자가 아닌 소프트웨어 설치, 공유 환경 변수, 라이선스 또는 데몬 설정

작업 환경

작업자

작업 번들 또는 작업 템플릿

작업 전후

작업별 설정 및 해체

단계 환경

작업자

작업 번들 또는 단계 템플릿

단계 전과 후

단계별 설정 및 해체

종속 단계

작업자

작업 번들 또는 단계 템플릿(dependsOn)

동일한 작업의 이전 단계가 성공한 후

프레임을 영화로 인코딩하거나 썸네일을 생성하는 등 로컬에서 출력 파일이 필요한 렌더링 후 작업

Amazon EventBridge(EventBridge) 이벤트

AWS 클라우드

AWS 계정(규칙 및 대상)

작업, 단계, 작업, 플릿 또는 예산 상태 변경

프로덕션 추적, 알림, 클라우드 자동화, 대기열 간 작업 연결

Amazon CloudWatch(CloudWatch) 지표 및 경보

AWS 클라우드

내 AWS 계정

임계값에 대해 지속적으로

라이선스 가용성(LicensesInUse) 및 플릿 용량과 같이 이벤트가 없는 조건

워크스테이션에서 사용자 지정 로직 실행

제출자 후크는 작업이 서비스에 도달하기 전에 제출 중에 실행됩니다. 워크스테이션에서 제출된 모든 작업에 적용되는 워크스테이션별로 또는 해당 번들에 적용되는 작업 번들 내에서 구성합니다. 제출자 후크는 제출 흐름의 여러 지점에서 번들을 변경할 수 있습니다. 이를 사용하여 환경 변수를 주입하거나, 제출을 검증하거나, 제출 시 프로덕션 추적 소프트웨어와 동기화할 수 있습니다.

자세한 내용은 제출 후크 단원을 참조하십시오.

작업자에서 사용자 지정 로직 실행

다음 통합 지점은 렌더링 호스트에서 실행됩니다. 가장 광범위한 범위에서 가장 좁은 범위로 중첩됩니다.

  • 호스트 구성 스크립트는 작업자가 시작할 때 관리자 권한으로 한 번 실행됩니다. 호스트 구성 스크립트는 서비스 관리형 플릿(SMFs. 고객 관리형 플릿(CMF)에서는 대신 자체 이미지를 베이크합니다. 네트워크 설정 및 관리자 수준 소프트웨어 설치에 호스트 구성 스크립트를 사용합니다.

  • 대기열, 작업 및 단계 환경은 각각 onEnter 및 onExit 작업을 정의합니다. 작업은 작업자의 세션이 범위에 들어가고 세션이 범위를 벗어날 때 역순으로 실행됩니다. 대기열 환경은 공유 소프트웨어, 환경 변수, 라이선스 또는 데몬 설정과 같은 대기열의 모든 작업에 적용되는 프로젝트 수준 구성에 적합한 곳입니다. 작업 및 단계 환경은 범위를 단일 작업 또는 단계로 좁힙니다.

  • 종속 단계는가 렌더링 단계에 의존하는 dependsOn 데 사용하는 두 번째 단계를 추가합니다. 예를 들어 영화를 렌더링한 다음 인코딩하거나 썸네일을 렌더링한 다음 생성할 수 있습니다. 단계는 동일한 작업을 유지하므로 출력은 이미 로컬입니다. 종속 단계에는 사용자 지정 제출자 또는 수기 작업 번들이 필요합니다. Job-to-job 종속성은 네이티브가 아닙니다. 별도의 작업을 연결하려면 다음 섹션에 설명된 대로 클라우드에서 이벤트를 사용합니다.

참고

환경은 작업당이 아닌 세션 범위입니다. onExit 작업은 모든 작업 후가 아니라 세션 중단 시 실행됩니다. Deadline 10 포스트 태스크 콜백을 마이그레이션하는 경우 환경 onExit 작업 대신 종속 단계를 사용합니다.

자세한 내용은 다음을 참조하세요.

클라우드의 이벤트에 대응

EventBridge와 CloudWatch를 사용하면 팜 용량을 소비하지 않고도 작업 활동에 대응할 수 있습니다. 로직이 작업의 일부로 실행되지 않고 작업 결과에 응답할 때 사용합니다.

  • Deadline Cloud는 소스가 있는 이벤트를 AWS 계정aws.deadline의 기본 이벤트 버스로 전송합니다. 이벤트는 작업, 단계 및 작업 상태 변경, 플릿 크기 권장 사항 및 예산 임계값을 다룹니다. 규칙, AWS Lambda (Lambda) 함수 및 DLQ(Dead Letter Queue)를 소유합니다. 알림, 자산 등록 또는 대기열 간에 작업을 연결하기 위해 Lambda 함수에 규칙을 연결합니다(이벤트에서 Lambda로 또는 ()에서 로CreateJob). 전송은 최선이며 이벤트가 순서에 맞지 않게 도착할 수 있으므로 소비자를 멱등성으로 만들고 재시도 및 DLQ를 구성합니다.

  • CloudWatch 지표 및 경보는 EventBridge가 지원하지 않는 조건, 특히 라이선스 가용성 및 플릿 용량을 다룹니다. 라이선스 가용성에 대한 이벤트가 없으므로 LicensesInUse 지표 및 제한 수에 대해 경보를 보냅니다. Fleet Size Recommendation Change 이벤트와 지표는 고객 관리형 RecommendedFleetSize 플릿 오토 스케일링도 구동합니다.

자세한 내용은 다음을 참조하세요.

통합 지점 선택

다음 지침에 따라 일반적인 요구 사항에 맞는 통합 지점을 선택합니다.

  • 작업을 제출하기 전에 변경하려면 제출자 후크를 사용합니다.

  • 작업 주변의 렌더 호스트에서 로직을 실행하려면 호스트 구성 스크립트 또는 대기열, 작업 또는 단계 환경을 사용합니다. 가장 광범위한 범위를 선택하고 프로젝트 수준 구성에 대기열 환경을 사용합니다.

  • 작업 출력이 여전히 로컬인 동안 처리하려면 종속 단계를 사용합니다.

  • 팜 용량을 소비하지 않고 작업 결과에 대응하려면 Lambda 함수와 함께 EventBridge 규칙을 사용합니다.

  • 라이선스 또는 용량 제한과 같이 이벤트가 없는 조건의 경우 CloudWatch 경보를 사용합니다.

추가 리소스

관련 개념 및 참조 자료는 다음을 참조하세요.