Job Management 사용 가이드
Job 생성
VOD Transcoder의 Job management를 통해 미디어 파일을 변환하는 작업을 만들 수 있습니다.
Job 생성 과정은 총 5 단계로 나뉩니다.
Step 1. VOD Transcoder 콘솔 접속
네이버 클라우드 플랫폼 VOD Transcoder 상품 콘솔에 접속해 Job Management 탭을 클릭합니다.
① Job 생성을 클릭합니다.
Step 2. Job 생성
① 생성할 Job 이름을 입력합니다.
- 영문, 숫자, "-", "_" 허용, 3자 이상 20자까지 입력 가능하며, 공백은 허용하지 않습니다.
② 입력 파일을 선택하기 위해 선택을 클릭합니다.
③ Object Storage 버킷에서 Input file을 선택합니다.
만약 2Gbyte 이상 대용량 파일을 VOD Transcoder로 변환하고 싶다면,
Object Storage 사용 가이드의 대용량 파일 업로드 예제를 참고해 주세요.
보유한 Object Storage 버킷이 없다면,
버킷 생성을 클릭하여 버킷 생성 후 변환할 영상을 업로드해야만 VOD Transcoder 상품을 이용하실 수 있습니다.
Object Storage 상품은 반드시 상품 이용 신청 이후 사용할 수 있습니다.
이용 신청 버튼을 클릭해 Object Storage 상품을 신청 후 VOD Transcoder를 사용할 수 있습니다.
Step 3. Output 설정
① Input file을 변환할 Preset의 설정 수를 선택합니다. 선택한 Preset의 수 만큼 Media file이 변환됩니다.
② 각 Preset의 상세 설정을 선택합니다.
- 기본으로 제공하는 System preset과, Preset management를 통해 생성할 수 있는 Custom preset 중 선택할 수 있습니다.
- 다만, Input file 확장자가 gif일 경우 Audio preset은 선택할 수 없습니다.
- Output 버킷에 저장 될 출력 영상의 파일 확장자를 제외한 Output 파일명을 입력합니다.
- 영문, 숫자, "-", "_" 허용, 3자 이상 20자까지 입력 가능하며, 공백은 허용하지 않습니다.
- 예: 1080p, mp3-320k, aac-256k
③ 변환 및 추출 완료된 Thumbnail을 버킷에 저장할지 선택할 수 있습니다.
- Thumbnail을 설정할 경우, 순차적으로 추출된 10개의 이미지가 선택한 Object Storage 버킷 내 저장됩니다.
- 다만, Input file 확장자가 mp3일 경우 Thumbnail 추출이 불가능합니다.
④ 변환 및 추출 완료된 Thumbnail과 Media file의 Output 경로를 지정합니다.
- ④-① Thumbnail과 Media file의 파일을 저장할 버킷을 선택합니다.
- ④-② 출력물을 저장할 output 상세 경로를 입력합니다.
- ”/“로 시작, 영문, 숫자, "-", "_", "/" 허용, 1자 이상 20자까지 입력 가능하며, 공백은 허용하지 않습니다.
Step 4. 기타 설정
특정 Job status 이벤트 발생 시 알람을 받도록 설정할 수 있습니다.
① 이벤트 설정 여부를 선택합니다.
② Progressing, Cancel, Successful, Fail 이벤트 중 알람을 받을 이벤트를 On/Off 설정할 수 있습니다.
③ 알람을 받을 통보 대상자를 지정합니다.
③-① 알람을 받을 담당자를 담당자 이름 목록에서 선택합니다.
③-② 통보 방법을 선택합니다.
③-③ 지정한 담당자를 추가합니다.
③-④ 통보 대상 설정을 등록합니다.
등록해 둔 통보 대상 관리자가 없다면, 통보 대상 관리를 클릭하여 담당자를 등록 및 추가할 수 있습니다.
- 대상자 추가 클릭
- 대상자 정보 입력 및 등록
Step 5. 설정 확인
앞서 설정한 사항들을 확인한 후 Job 생성을 클릭해 Job을 생성합니다.
Job 취소
Submitted 상태인 Job에 대해서만 Job 생성을 취소할 수 있습니다.
① SUBMITTED 상태인 Job을 선택해 생성취소를 클릭합니다.
- 만약 Submitted 상태임에도 불구하고 에러 문구가 지속적으로 노출된다면 고객지원 > 문의하기로 문의 부탁드립니다.
Job 목록
Job 생성 후 자동으로 Job이 수행되며, 각 Preset별로 상세 진행 상태를 확인할 수 있습니다.
① 상태별 Job 개수
- 총 5개의 Job 상태를 가집니다.
- Submitted: Job 수행 대기 중
- Progressing: Job 수행 중
- Successful: 정상적으로 Job 수행 완료
- Fail: 정상적으로 Job이 수행되지 않음
- Cancel: Submitted 상태였던 Job 수행 취소
② Job Overview: Job의 진행 시간을 확인할 수 있습니다.
- SUBMITTED TIME: Job 수행 전 준비 작업 시작 시점의 시간
- START TIME: Job 수행(progressing) 시작 시점의 시간
- FINISHED TIME: Job이 완료(successful)된 시점의 시간
③ Job 진행 상황: 선택한 Preset별 Output 상세 진행 상황을 확인할 수 있으며, 상태는 다음과 같습니다.
- Submitted -> Progressing -> Done
④ Input: Job 생성 시 선택한 Input file의 정보이며, Input file클릭 시 메타 데이터를 확인할 수 있습니다.
Job 완료
Job이 성공적으로 완료되었다면, Job 생성 시 지정한 Object storage 버킷에 Output이 저장됩니다.
저장 경로는 Job 목록 > Output > Output VOD / Output Thumbnail에서 확인할 수 있습니다.
① 수행 완료된 Preset별 Output 상세 메타 데이터를 확인할 수 있습니다.
② 각 Preset별 상태와 Job의 상태를 확인할 수 있습니다.
만약 Output이 저장된 버킷이 삭제되었다면 해당 Job은 복구할 수 없습니다.
Object Storage에 저장된 Output
Thumbnail 예시
Thumbnail 전체 예시
완료된 Output VOD 예시
완료된 VOD는 보유하고 있는 네이버 클라우드 플랫폼 Object Storage에서 확인할 수 있습니다.
Job 실패
Job 수행이 정상적이지 않을 경우, Job 상태가 Fail로 변경되면서 사유를 확인할 수 있습니다.
Job 실패 시 나타날 수 있는 문구는 다음과 같으며, 지속적으로 Fail 상태가 확인된다면 고객지원 > 문의하기로 문의 부탁드립니다.
- UPLOAD_ERROR : 인코딩이 완료된 출력 비디오 파일을 출력 Object Storage 버킷에 업로드하는 도중에 발생한 오류입니다.
- DOWNLOAD_ERROR : VOD Transcoder 가 Object Storage로 부터 원본 비디오 파일을 다운로드하는 도중에 발생한 오류입니다. Job 이 수행되는 도중에 원본 비디오 파일이 변경 혹은 삭제될 경우 발생합니다.
- FILE_NOT_FOUND: 선택한 원본 비디오 파일이 Object Storage 내에 존재하지 않을 경우 발생하는 오류입니다.
- FILE_ALREADY_EXISTS : 같은 이름의 출력 비디오 파일이 출력 Object Storage 내에 이미 존재할 경우 발생하는 오류입니다.
- WRONG_INPUT_FILE : 선택한 원본 비디오 파일이 VOD Transcoder 에서 지원하는 비디오 파일이 형식 아닐 경우 발생하는 오류입니다.
- TRANSCODING_ERROR: VOD Transcoder 의 인코딩을 수행하는 도중에 발생한 오류입니다. 원본 비디오 파일 속성이 일반적이지 않아 VOD Transcoder 의 인코더가 변환을 할 수 없을 경우 발생합니다.
- 다양한 이유로 발생하지만 원본 비디오 파일 헤더 추출 실패 혹은 재생 시간(Duration)이 정상적이지 않은 경우로 발생하는 케이스가 있습니다.
- mediainfo와 같은 비디오 파일 속성을 확인할 수 있는 프로그램으로 비디오/오디오 포맷이 VOD Transcoder에서 지원하는 포맷인지, 헤더의 재생시간과 비디오/오디오 재생 시간이 동일한지 확인해볼 수 있습니다.
- 원인 확인이 어려우신경우 고객지원 > 문의하기로 문의 부탁드립니다.
