기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
자동 다운로드
Deadline CLI는 동일한 명령이 마지막으로 실행된 이후 완료된 대기열에 있는 모든 작업의 출력을 다운로드하는 명령을 제공합니다. 반복적으로 실행되도록 cron 작업 또는 예약된 작업으로 구성할 수 있습니다. 이 구성은 출력의 자동 다운로드를 지속적으로 설정합니다.
자동 다운로드를 설정하기 전에 작업 연결을 위한 스토리지 프로필의 단계에 따라 업로드 및 다운로드를 위한 자산 데이터의 모든 경로를 구성합니다. 작업이 스토리지 프로파일에 없는 출력 경로를 사용하는 경우 자동 다운로드는 해당 출력 다운로드를 건너뛰고 경고 메시지를 인쇄하여 다운로드하지 않은 파일을 요약합니다. 마찬가지로 스토리지 프로파일 없이 작업이 제출되면 자동 다운로드는 해당 작업을 건너뛰고 경고 메시지를 인쇄합니다. 기본적으로 Deadline Cloud 제출자는 올바른 구성을 보장하기 위해 스토리지 프로파일 외부에 있는 경로에 대한 경고 메시지를 표시합니다.
AWS 자격 증명 구성
자동 다운로드는 Deadline CLI를 사용하여 작업 출력을 지속적으로 다운로드합니다. 이러한 다운로드를 인증하려면 장기 IAM 자격 증명이 필요합니다. Deadline Cloud Monitor 자격 증명은 만료되므로이 용도로 사용할 수 없습니다.
아래 단계에 따라 장기 자격 증명을 설정합니다.
중요
다음 경고에 주의하세요.
-
계정의 루트 자격 증명을 사용하여 AWS 리소스에 액세스하지 마십시오. 이 보안 인증은 계정 액세스에 제한이 없고 취소하기 어렵습니다.
-
금지 사항. 애플리케이션 파일에 리터럴 액세스 키나 보안 인증 정보를 넣으면 안 됩니다. 이를 어기는 경우, 예를 들어 프로젝트를 퍼블릭 리포지토리에 업로드하면 뜻하지 않게 보안 인증이 노출될 위험이 있습니다.
-
금지 사항. 프로젝트 영역에 보안 인증이 포함된 파일을 포함하지 마세요.
-
액세스 키를 보호합니다. 계정 식별자를 찾는 데 도움이 되더라도 액세스 키를 권한 없는 당사자에게 제공하지 마세요. 이렇게 하면 다른 사람에게 계정에 대한 영구 액세스 권한을 부여할 수 있습니다.
-
공유 AWS 자격 증명 파일에 저장된 모든 자격 증명은 일반 텍스트로 저장됩니다.
IAM 사용자를 생성합니다.
IAM 콘솔(https://console.aws.amazon.com/iam/
)을 엽니다. -
탐색 창에서 사용자와 사용자 생성을 차례로 선택합니다.
-
사용자 이름을 로 지정합니다
deadline-output-downloader. 에 대한 사용자 액세스 제공 AWS Management Console 확인란의 선택을 취소한 후 다음을 선택합니다. -
정책 직접 연결을 선택합니다.
-
정책 생성을 선택하여 최소 필수 권한이 있는 사용자 지정 정책을 생성합니다.
-
JSON 편집기에서 다음 권한을 지정합니다.
-
정책의 이름을 지정
DeadlineCloudOutputDownloadPolicy하고 정책 생성을 선택합니다. -
사용자 생성 페이지로 돌아가서 정책 목록을 새로 고치고 방금 생성한 DeadlineCloudOutputDownloadPolicy를 선택한 후 다음을 선택합니다.
-
사용자 세부 정보를 검토한 다음 사용자 생성을 선택합니다.
액세스 키 생성
-
사용자 세부 정보 페이지에서 보안 자격 증명 탭을 선택합니다. 액세스 키 섹션에서 액세스 키 생성을 선택합니다.
-
기타에 키를 사용할 것인지 표시한 다음 다음을 선택하고 액세스 키 생성을 선택합니다.
-
액세스 키 검색 페이지에서 표시를 선택하여 사용자의 보안 액세스 키 값을 표시합니다. 자격 증명을 복사하거나 .csv 파일을 다운로드할 수 있습니다.
사용자 액세스 키 저장
-
사용자 액세스 키를 시스템의 AWS 자격 증명 파일에 저장합니다.
-
Linux에서 파일은에 있습니다.
~/.aws/credentials -
Windows에서 파일은에 있습니다.
%USERPROFILE%\.aws\credentials
다음 키를 바꿉니다.
[deadline-downloader] aws_access_key_id=ACCESS_KEY_IDaws_secret_access_key=SECRET_ACCESS_KEYregion=YOUR_AWS_REGION -
중요
이 IAM 사용자가 더 이상 필요하지 않은 경우 AWS 보안 모범 사례에 맞게 제거하는 것이 좋습니다. 에 액세스할 AWS IAM Identity Center 때를 통해 인간 사용자에게 임시 자격 증명을 사용하도록 요구하는 것이 좋습니다 AWS.
사전 조건
자동 다운로드를 위해 cron 작업 또는 예약된 작업을 생성하기 전에 다음 단계를 완료합니다.
-
아직 설치하지 않았다면 Python
웹 사이트에서 Python을 설치합니다. -
다음을 실행하여 Deadline CLI를 설치합니다.
python -m pip install deadline -
다음 명령을 사용하여 Deadline CLI의 버전이 0.52.1 이상인지 확인합니다.
$ deadline --version deadline, version 0.52.1Deadline Cloud 모니터에서 다운로드 상태를 보려면 버전 0.60.4 이상을 사용합니다. 해당 버전은 모니터가 읽는 다운로드 상태를 기록하기 시작했습니다. 자세한 내용은 Deadline Cloud에서 출력 다운로드 상태 보기 단원을 참조하십시오.
출력 다운로드 명령 테스트
명령이 환경에서 작동하는지 확인하려면
-
기한 경로 가져오기
-
sync-output 명령을 실행하여 부트스트랩합니다.
/path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory \ -
다운로드 머신이 제출 머신과 동일한 경우에만이 단계를 수행하면 됩니다.
--storage-profile-id YOUR_PROFILE_ID \위의를 로 바꿉니다--ignore-storage-profiles. -
테스트 작업을 제출합니다.
-
GitHub에서 .zip 파일을 다운로드합니다.
-
GitHub 웹 사이트에서 deadline-cloud-samples 리포지토리
를 엽니다. -
코드를 선택한 다음 드롭다운 메뉴에서 ZIP 다운로드를 선택합니다.
-
다운로드한 아카이브의 압축을 로컬 디렉터리로 풉니다.
-
-
실행
cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output -
실행
deadline bundle submit .-
기본 기한 구성 설정이 없는 경우 명령줄에 다음을 제공해야 할 수 있습니다.
--farm-idYOUR-FARM-ID--queue-idYOUR-QUEUE-ID
-
-
다음 단계로 넘어가기 전에 작업이 완료될 때까지 기다립니다.
-
-
sync-output 명령을 다시 실행합니다.
/path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory -
다음을 확인합니다.
-
테스트 작업의 출력이 대상 디렉터리에 나타납니다.
-
지정된 체크포인트 디렉터리에 체크포인트 파일이 생성됩니다.
-
예약된 다운로드 설정
운영 체제의 탭을 선택하여 5분마다 자동 다운로드를 구성하는 방법을 알아봅니다.
설정 확인
자동 다운로드 설정이 성공했는지 확인하려면 다음 단계를 완료하세요.
-
새 테스트 작업을 제출합니다.
-
한 스케줄러 간격이 완료될 때까지 기다립니다.이 경우 5분입니다.
-
새 출력이 자동으로 다운로드되는지 확인합니다.
출력이 다운로드되지 않는 경우 문제 해결 섹션에서 프로세스 로그를 확인합니다.
자동 다운로드 문제 해결
자동 다운로드에 문제가 발생하면 다음을 확인하세요.
오류 코드 다운로드
다운로드가 실패하면 Deadline Cloud 모니터의 다운로드 상태 열에 이유가 지정되고 deadline queue sync-output 명령은 다음 오류 코드 중 하나를 기록합니다. 이러한 오류는 대부분 다운로드 명령을 실행하는 시스템에서 해결됩니다. 다운로드 명령은 모니터를 보는 시스템과 다른 시스템인 경우가 많습니다.
PERMISSION_DENIED(권한 거부됨)-
다운로더가 출력 위치에 쓸 수 없거나 자격 AWS 증명에 대한 액세스가 거부되었습니다. 다운로드 명령을 실행하는 사용자에게 출력 위치에 대한 쓰기 액세스 권한을 부여하고 명령의 AWS 프로파일이 대기열에 액세스할 수 있는지 확인한 다음 명령을 다시 실행합니다.
DISK_FULL(디스크 가득 참)-
다운로드를 실행하는 시스템에 디스크 공간이 부족합니다. 출력 위치를 유지하는 드라이브의 공간을 확보한 다음 명령을 다시 실행합니다.
PATH_NOT_FOUND(경로를 찾을 수 없음)-
출력 대상이 존재하지 않거나 다운로드를 실행하는 시스템에 탑재되지 않았습니다. 디렉터리를 생성하거나 공유 드라이브를 탑재한 다음 명령을 다시 실행합니다.
NETWORK_ERROR(네트워크 오류)-
네트워크 중단으로 인해 전송이 중지되었습니다. 네트워크 오류는 일반적으로 일시적입니다. 명령을 다시 실행하고 오류가 반복되면 시스템의 연결을 확인합니다.
UNKNOWN(실패)-
다운로더가 특정 원인을 식별할 수 없습니다. 모니터에이 코드와 인식하지 못하는 코드에 대해 실패가 표시됩니다.
deadline queue sync-output명령의 로그 출력에서 기본 오류를 확인합니다.
다운로드에 실패한 작업은 나중에 실행할 때마다 자동으로 재시도됩니다. 5번의 시도가 실패하면 다운로더가 작업 재시도를 중지하고 경고를 출력합니다. 원인을 해결한 후 작업이 완료된 시점을 포함하는 룩백 창과 함께 다운로드 명령을 실행하여 작업을 복구합니다.
deadline queue sync-output --farm-idFARM_ID--queue-idQUEUE_ID\ --storage-profile-idSTORAGE_PROFILE_ID\ --force-bootstrap --bootstrap-lookback-minutes1440
두 플래그를 함께 전달합니다. --bootstrap-lookback-minutes 옵션은 기본적으로 0이므로 자체--force-bootstrap적으로 아무것도 복구하지 않습니다.
내 작업을 건너뛰었던 이유는 무엇입니까?
다운로더가 작업을 건너뛰면 다운로드 상태 열에 셀에서 직접 사유의 이름이 지정됩니다.
- 첨부 파일 없음(
no_attachments) -
작업이 작업 첨부 파일과 함께 제출되지 않았으므로 다운로드할 기록된 출력 파일이 없습니다. 일부 작업은 다운로드 가능한 출력을 생성하지 않으므로 첨부 파일이 없는 건너뛴 작업은 일반적으로 작업이 필요하지 않습니다.
- 스토리지 프로파일 누락(
missing_storage_profile) -
다운로드 명령이 스토리지 프로파일을 사용하는 동안 작업이 스토리지 프로파일 없이 제출되었으므로 다운로더는 각 시스템에서 작업의 파일이 어디에 속하는지 알지 못합니다. 스토리지 프로파일이 구성될 때까지 작업에 대한 다운로드가 없습니다. 작업의 스토리지 프로필은 작업이 제출될 때 설정되므로 스토리지 프로필과 함께 작업을 제출하고 동일한 프로필을 다운로드 명령에 전달합니다. 작업 테이블에서 스토리지 프로파일 누락 상태는 설명, 설명서 링크 및 AI를 사용한 문제 해결 버튼을 여는 링크입니다. 자세한 내용은 작업 첨부 파일의 스토리지 프로필을 참조하세요.
사유가 표시되지 않은 건너뛴 작업은 출력을 생성하기 전에 취소되거나 중지되었습니다. 아무 작업도 필요하지 않습니다.
다운로드 문제입니까? 아니면 렌더링 문제입니까?
작업의 다운로드 상태 열에 있는 문제는 두 가지를 의미할 수 있으며 수정 사항이 다릅니다. 상태 텍스트는 어떤 텍스트가 있는지 알려줍니다.
-
실행 상태가 인 작업에 대한 출력이 없으면 작업이
FAILED팜에서 렌더링되지 못한 것입니다. 파일이 생성되지 않았으므로 다운로드할 파일이 없었습니다. 드라이브와 네트워크는 정상입니다. 작업의 로그를 확인하여 렌더링 오류를 찾아 수정한 다음 작업을 다시 대기열에 넣습니다. 작업은 파일을 작성하지 않고 성공적으로 완료된 후 출력 없음을 표시할 수도 있습니다. 이는 정상이며 작업이 필요하지 않습니다. -
권한 거부와 같은 오류 이름은 렌더링된 작업과 해당 출력이 존재하고 파일을 파일 시스템에 복사하는 데 실패했음을 의미합니다. 를 사용하여 오류를 해결합니다오류 코드 다운로드.
작업 테이블에서 두 문제 모두 작업의 다운로드 진행률 표시줄에 빨간색 세그먼트로 표시됩니다. 작업의 작업 테이블을 열어 따로 알려줍니다. 작업이 출력을 생성하지 않았기 때문에 모든 작업이 실패한 작업에는 다운로드 오류 대신 대시가 표시됩니다. 작업의 자체 상태 열은 해당 실패를 보고합니다. 이러한 렌더링 실패 사례에서 다운로드를 진단하면 시간이 낭비되므로 항상 작업의 실행 상태를 먼저 확인합니다.
AI를 사용한 문제 해결
빨간색 출력 동기화 실패 표시기를 포함하여 Deadline Cloud 모니터의 다운로드 실패 메시지에는 AI로 문제 해결 버튼이 포함됩니다. 버튼을 누르면 Deadline Cloud 어시스턴트가 열립니다.이 어시스턴트는 대기열의 다운로드 상태 레코드를 읽고 이를 수정하기 위해 실행할 명령을 포함하여 특정 실패를 안내합니다.
오류 코드에 대한 수정을 시도한 후에도 다운로드가 계속 실패하거나, 인식할 수 없는 오류가 발생하거나, 문제가 발생한 시스템을 잘 모르는 경우이 문제를 해결합니다. 모니터에 Deadline Cloud 어시스턴트가 활성화되면 버튼이 나타납니다. 자세한 내용은 Deadline Cloud 어시스턴트 단원을 참조하십시오.
스토리지 프로필 문제
-
[Errno 13] Permission denied로그 파일의[Errno 2] No such file or directory또는와 같은 오류는 누락되거나 잘못 구성된 스토리지 프로필과 관련이 있을 수 있습니다. -
다운로드 머신이 제출 머신과 다를 때 스토리지 프로파일을 설정하는 방법에 대한 자세한 내용은 스토리지 프로파일을 참조하세요.
-
동일한 시스템 다운로드의 경우
--ignore-storage-profiles플래그를 사용해 보세요.
디렉터리 권한
-
스케줄러 서비스 사용자에게 다음이 있는지 확인합니다.
-
체크포인트 디렉터리에 대한 읽기/쓰기 액세스
-
출력 대상 디렉터리에 대한 쓰기 액세스 권한
-
-
Linux 및의 경우
ls -la를 macOS사용하여 권한을 확인합니다. -
의 경우 속성 폴더에서 보안 설정을 Windows검토합니다.