CLI Packager: 명령 및 복구

포함된 CLI 열기#

Package Content에서 Windows Suite 전체를 내려받아 압축 해제하고 해당 폴더에서 PowerShell을 여세요. 다음 명령은 FFmpeg, FFprobe, Shaka 실행 파일이 drmx-packager-cli.exe 옆에 있다고 가정합니다.

.\drmx-packager-cli.exe version
.\drmx-packager-cli.exe help
.\drmx-packager-cli.exe credentials list
.\drmx-packager-cli.exe credentials test --profile "Production"

먼저 Desktop Packager에 Production 프로필을 만들거나 이름을 저장한 프로필명으로 바꾸세요. CLI 1.0.0-beta.1과 대응하는 Suite를 사용합니다. 저장된 프로필로 업로드를 재개하면 임시 업로드 권한을 갱신할 수 있습니다.

1080p 원본 파일 패키징#

아래 소스 경로, Content ID, 출력 경로를 교체하세요. 출력 폴더는 새 폴더이거나 비어 있어야 합니다. PowerShell 연속 줄 끝의 백틱 뒤에 공백을 넣지 마세요.

.\drmx-packager-cli.exe package `
  --profile "Production" `
  --content_id "training-2026-001" `
  --content_title "Training session" `
  --input_source "D:\Sources\training.mp4" `
  --encoding_ladder "sd,hd,full-hd" `
  --video_codec h264 --encoding_preset fast `
  --rate_control smart-quality-vbr --max_frame_rate 24 `
  --audio_bitrate_kbps 128 --segment_duration 6 `
  --packaging_profile maximum-compatibility `
  --key_protection shaka-standard --encrypt_audio `
  --drm_systems "widevine,fairplay,playready,wiseplay" `
  --ffmpeg ".\ffmpeg.exe" --ffprobe ".\ffprobe.exe" `
  --shaka ".\packager-win-x64.exe" `
  --upload-concurrency 8 `
  -o "D:\Protected\training-2026-001"

소스를 분석하고 선택한 화질을 한 번 인코딩한 뒤 암호화·매니페스트 검증·임시 평문 제거·업로드를 수행합니다. 소스보다 큰 화질로 확대하지 않습니다. UHD는 4K, 8K 및 긴 비디오를 보세요.

로컬 보호 출력만 보관하려면 --no-upload을 추가하세요. 검증된 고객 저장소를 사용하려면 --storage_connection_id "YOUR-STORAGE-CONNECTION-ID"을 추가합니다. 생략하면 설정된 기본 대상을 사용합니다.

진행 상황과 완료 상태 확인#

업로드 성공 시 검증한 객체 수, 총 바이트, 인벤토리 SHA-256, 등록된 매니페스트 URL을 표시합니다. 마지막에 서버가 크기, 경로, 패키지 KIDs를 검증합니다. 복구 시 같은 패키지를 식별하는 Packaging Session ID를 보관하세요.

Desktop은 구조화된 CLI 진행 정보를 읽습니다. 직접 연동할 때 --progress-format ndjson을 추가하고 줄마다 JSON 객체 하나를 파싱하세요. percent 같은 선택 필드는 null일 수 있습니다. 이전 단계가 끝났어도 종료 코드가 0이 아니면 실패나 취소입니다.

다시 인코딩하지 않고 업로드 재개#

로컬 암호화가 끝나면 upload을 사용하세요. 컴퓨터 재시작이나 원래 Packaging Access Token 만료 후에도 가능합니다. 저장 프로필과 완료 패키지는 같은 Site ID여야 합니다. 세션 UUID와 폴더는 로그의 실제 값으로 바꾸세요.

.\drmx-packager-cli.exe upload `
  --profile "Production" `
  --session "11111111-2222-4333-8444-555555555555" `
  --input "D:\Protected\training-2026-001" `
  --upload-concurrency 4

출력 루트 전체를 보관하세요. Maximum Compatibility가 두 형식을 만들었다면 두 폴더가 모두 필요합니다. 1AICLOUD에서는 CLI가 원격 바이트 길이와 SHA-256을 비교해 일치 객체를 건너뛰고 나머지를 계속합니다. 미완성 멀티파트 객체는 그 객체만 다시 시작하며 완료 객체는 재사용합니다. 고객 소유 사전 서명 저장소는 수동 재개 시 재전송할 수 있습니다.

업로더는 속도 제한이나 일시적인 네트워크 오류가 발생하면 대기 시간을 늘려 재시도하며, 같은 대상과 패키지 접두사를 유지하면서 임시 1AICLOUD 인증 정보를 갱신합니다. 실패한 대용량 객체의 부분은 개별적으로 재시도합니다. 동시 업로드 수는 4~8개로 시작하세요. 동시성을 높인다고 항상 빨라지는 것은 아닙니다. 재개하기 전에 같은 폴더를 업로드하는 다른 프로세스를 중지하세요.

.\drmx-packager-cli.exe upload `
  --session "11111111-2222-4333-8444-555555555555" `
  --input "D:\Protected\training-2026-001" --dry-run

이 사전 확인은 로컬 파일 수와 크기만 읽습니다. 저장소에 접속하거나 서버 권한 및 암호화를 검증하지 않습니다. 세션 UUID 형식은 유효해야 합니다. 기존 세션 방식은 유효한 DRMX_PACKAGING_TOKEN을 사용할 수 있으며, 만료 후에는 저장 프로필 복구가 더 간단합니다.

보호된 환경 자격 증명으로 자동화#

무인 작업은 비밀 저장소로 DRMX_PACKAGER_SITE_ID, DRMX_PACKAGER_ACCESS_KEY, DRMX_PACKAGER_KMS_TOKEN를 제공하고 필요하면 DRMX_PACKAGER_SERVER도 설정합니다. 이 모드에서 --profile는 생략하세요. 실제 인증 정보를 스크립트, 소스 관리, 명령 인수, 로그에 쓰지 마세요.

소스마다 고유 Content ID와 빈 대상을 지정해 패키지 명령을 한 번 실행합니다. 다음 작업 전에 종료 코드를 확인하세요. 업로드만 실패했다면 package을 반복하지 말고 upload으로 복구합니다. Windows는 위 번들 실행 파일을 사용합니다. 승인된 Linux CLI 설치에서는 ./drmx-packager, ./ffmpeg, ./ffprobe, ./packager-linux-x64와 해당 셸의 줄 이어쓰기를 사용하세요.

문제 해결#

게시 결과를 테스트한 뒤 통합#

DRM-X Web Player에서 로그인하고 동일한 환경과 Published Content ID를 선택한 뒤 Play를 누릅니다. 탐색, 화질, 소리, 추가한 각 언어를 확인하세요. 이후 Web SDK 가이드와 백엔드 통합 키트로 웹사이트에 재생을 추가합니다. 패키징과 재생 API 인증 정보는 분리하세요.