View a markdown version of this page

자동 다운로드 - AWS 기한 클라우드

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

자동 다운로드

Deadline CLI는 동일한 명령이 마지막으로 실행된 이후 완료된 대기열에 있는 모든 작업의 출력을 다운로드하는 명령을 제공합니다. 반복적으로 실행되도록 cron 작업 또는 예약된 작업으로 구성할 수 있습니다. 이 구성은 출력의 자동 다운로드를 지속적으로 설정합니다.

자동 다운로드를 설정하기 전에 작업 연결을 위한 스토리지 프로필의 단계에 따라 업로드 및 다운로드를 위한 자산 데이터의 모든 경로를 구성합니다. 작업이 스토리지 프로파일에 없는 출력 경로를 사용하는 경우 자동 다운로드는 해당 출력 다운로드를 건너뛰고 경고 메시지를 인쇄하여 다운로드하지 않은 파일을 요약합니다. 마찬가지로 스토리지 프로파일 없이 작업이 제출되면 자동 다운로드는 해당 작업을 건너뛰고 경고 메시지를 인쇄합니다. 기본적으로 Deadline Cloud 제출자는 올바른 구성을 보장하기 위해 스토리지 프로파일 외부에 있는 경로에 대한 경고 메시지를 표시합니다.

AWS 자격 증명 구성

자동 다운로드는 Deadline CLI를 사용하여 작업 출력을 지속적으로 다운로드합니다. 이러한 다운로드를 인증하려면 장기 IAM 자격 증명이 필요합니다. Deadline Cloud Monitor 자격 증명은 만료되므로이 용도로 사용할 수 없습니다.

아래 단계에 따라 장기 자격 증명을 설정합니다.

중요

다음 경고에 주의하세요.

  • 계정의 루트 자격 증명을 사용하여 AWS 리소스에 액세스하지 마십시오. 이 보안 인증은 계정 액세스에 제한이 없고 취소하기 어렵습니다.

  • 금지 사항. 애플리케이션 파일에 리터럴 액세스 키나 보안 인증 정보를 넣으면 안 됩니다. 이를 어기는 경우, 예를 들어 프로젝트를 퍼블릭 리포지토리에 업로드하면 뜻하지 않게 보안 인증이 노출될 위험이 있습니다.

  • 금지 사항. 프로젝트 영역에 보안 인증이 포함된 파일을 포함하지 마세요.

  • 액세스 키를 보호합니다. 계정 식별자를 찾는 데 도움이 되더라도 액세스 키를 권한 없는 당사자에게 제공하지 마세요. 이렇게 하면 다른 사람에게 계정에 대한 영구 액세스 권한을 부여할 수 있습니다.

  • 공유 AWS 자격 증명 파일에 저장된 모든 자격 증명은 일반 텍스트로 저장됩니다.

자세한 내용은 AWS 일반 참조의 AWS 액세스 키 관리 모범 사례를 참조하세요.

IAM 사용자를 생성합니다.
  1. IAM 콘솔(https://console.aws.amazon.com/iam/)을 엽니다.

  2. 탐색 창에서 사용자사용자 생성을 차례로 선택합니다.

  3. 사용자 이름을 로 지정합니다deadline-output-downloader. 에 대한 사용자 액세스 제공 AWS Management Console 확인란의 선택을 취소한 후 다음을 선택합니다.

  4. 정책 직접 연결을 선택합니다.

  5. 정책 생성을 선택하여 최소 필수 권한이 있는 사용자 지정 정책을 생성합니다.

  6. JSON 편집기에서 다음 권한을 지정합니다.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "DeadlineCloudOutputDownload", "Effect": "Allow", "Action": [ "deadline:AssumeQueueRoleForUser", "deadline:ListQueueEnvironments", "deadline:ListSessions", "deadline:ListSessionActions", "deadline:SearchJobs", "deadline:GetJob", "deadline:GetQueue", "deadline:GetStorageProfileForQueue" ], "Resource": "*" } ] }
  7. 정책의 이름을 지정DeadlineCloudOutputDownloadPolicy하고 정책 생성을 선택합니다.

  8. 사용자 생성 페이지로 돌아가서 정책 목록을 새로 고치고 방금 생성한 DeadlineCloudOutputDownloadPolicy를 선택한 후 다음을 선택합니다.

  9. 사용자 세부 정보를 검토한 다음 사용자 생성을 선택합니다.

액세스 키 생성
  1. 사용자 세부 정보 페이지에서 보안 자격 증명 탭을 선택합니다. 액세스 키 섹션에서 액세스 키 생성을 선택합니다.

  2. 기타에 키를 사용할 것인지 표시한 다음 다음을 선택하고 액세스 키 생성을 선택합니다.

  3. 액세스 키 검색 페이지에서 표시를 선택하여 사용자의 보안 액세스 키 값을 표시합니다. 자격 증명을 복사하거나 .csv 파일을 다운로드할 수 있습니다.

사용자 액세스 키 저장
  • 사용자 액세스 키를 시스템의 AWS 자격 증명 파일에 저장합니다.

    • Linux에서 파일은에 있습니다. ~/.aws/credentials

    • Windows에서 파일은에 있습니다. %USERPROFILE%\.aws\credentials

    다음 키를 바꿉니다.

    [deadline-downloader] aws_access_key_id=ACCESS_KEY_ID aws_secret_access_key=SECRET_ACCESS_KEY region=YOUR_AWS_REGION
중요

이 IAM 사용자가 더 이상 필요하지 않은 경우 AWS 보안 모범 사례에 맞게 제거하는 것이 좋습니다. 에 액세스할 AWS IAM Identity Center 때를 통해 인간 사용자에게 임시 자격 증명을 사용하도록 요구하는 것이 좋습니다 AWS.

사전 조건

자동 다운로드를 위해 cron 작업 또는 예약된 작업을 생성하기 전에 다음 단계를 완료합니다.

  1. 아직 설치하지 않았다면 Python 웹 사이트에서 Python을 설치합니다.

  2. 다음을 실행하여 Deadline CLI를 설치합니다.

    python -m pip install deadline
  3. 다음 명령을 사용하여 Deadline CLI의 버전이 0.52.1 이상인지 확인합니다.

    $ deadline --version deadline, version 0.52.1

    Deadline Cloud 모니터에서 다운로드 상태를 보려면 버전 0.60.4 이상을 사용합니다. 해당 버전은 모니터가 읽는 다운로드 상태를 기록하기 시작했습니다. 자세한 내용은 Deadline Cloud에서 출력 다운로드 상태 보기 단원을 참조하십시오.

출력 다운로드 명령 테스트

명령이 환경에서 작동하는지 확인하려면
  1. 기한 경로 가져오기

    Linux and macOS
    $ which deadline
    Windows
    C:\> where deadline
    PowerShell
    PS C:\> Get-Command deadline
  2. 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 \
  3. 다운로드 머신이 제출 머신과 동일한 경우에만이 단계를 수행하면 됩니다. --storage-profile-id YOUR_PROFILE_ID \ 위의를 로 바꿉니다--ignore-storage-profiles.

  4. 테스트 작업을 제출합니다.

    1. GitHub에서 .zip 파일을 다운로드합니다.

      1. GitHub 웹 사이트에서 deadline-cloud-samples 리포지토리를 엽니다.

      2. 코드를 선택한 다음 드롭다운 메뉴에서 ZIP 다운로드를 선택합니다.

      3. 다운로드한 아카이브의 압축을 로컬 디렉터리로 풉니다.

    2. 실행

      cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output
    3. 실행

      deadline bundle submit .
      1. 기본 기한 구성 설정이 없는 경우 명령줄에 다음을 제공해야 할 수 있습니다.

        --farm-id YOUR-FARM-ID --queue-id YOUR-QUEUE-ID
    4. 다음 단계로 넘어가기 전에 작업이 완료될 때까지 기다립니다.

  5. 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
  6. 다음을 확인합니다.

    • 테스트 작업의 출력이 대상 디렉터리에 나타납니다.

    • 지정된 체크포인트 디렉터리에 체크포인트 파일이 생성됩니다.

예약된 다운로드 설정

운영 체제의 탭을 선택하여 5분마다 자동 다운로드를 구성하는 방법을 알아봅니다.

Linux
  1. 기한 CLI 설치 확인

    기한 실행 파일의 정확한 경로를 가져옵니다.

    $ which deadline

    plist 파일에 사용할 수 있도록이 경로(예: /opt/homebrew/bin/deadline)를 기록해 둡니다.

  2. 체크포인트 디렉터리 생성

    체크포인트 파일이 저장될 디렉터리를 생성합니다. 사용자가 명령을 실행할 수 있는 적절한 권한이 있는지 확인합니다.

    $ mkdir -p /path/to/checkpoint/directory
  3. 로그 디렉터리 생성

    cron 작업 로그용 디렉터리를 생성합니다.

    $ mkdir -p /path/to/logs

    https://www.redhat.com/en/blog/setting-logrotate 사용하여 로그 파일에 로그 교체를 설정하는 것이 좋습니다.

  4. 현재 Crontab 확인

    현재 crontab을 보고 기존 작업을 확인합니다.

    $ crontab -l
  5. Crontab 편집

    편집을 위해 crontab 파일을 엽니다.

    $ crontab -e

    명령을 처음 실행할 때 편집기(nano, vim 등)를 선택하라는 메시지가 표시될 수 있습니다.

  6. Cron 작업 항목 추가

    다음 줄을 추가하여 5분마다 작업을 실행합니다(경로를 1단계와 2단계의 실제 값으로 바꿉니다).

    */5 * * * * /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 >> /path/to/logs/deadline_sync.log 2>&1
  7. Cron 작업 설치 확인

    편집기를 저장하고 종료한 후 cron 작업이 추가되었는지 확인합니다.

    $ crontab -l

    새 작업이 나열됩니다.

  8. Cron 서비스 상태 확인

    cron 서비스가 실행 중인지 확인합니다.

    # For systemd systems (most modern Linux distributions) $ sudo systemctl status cron # or $ sudo systemctl status crond # For older systems $ sudo service cron status

    실행 중이 아니면 시작합니다.

    $ sudo systemctl start cron $ sudo systemctl enable cron # Enable auto-start on boot
macOS
  1. 기한 CLI 설치 확인

    기한 실행 파일의 정확한 경로를 가져옵니다.

    $ which deadline

    plist 파일에 사용할 수 있도록이 경로(예: /opt/homebrew/bin/deadline)를 기록해 둡니다.

  2. 체크포인트 디렉터리 및 로그 디렉터리 생성

    체크포인트 파일이 저장될 디렉터리를 생성합니다.

    $ mkdir -p /path/to/checkpoint/directory $ mkdir -p /path/to/logs

    https://formulae.brew.sh/formula/logrotate 사용하여 로그 파일에 로그 교체를 설정하는 것이 좋습니다.

  3. Plist 파일 생성

    다음 콘텐츠를 ~/Library/LaunchAgents/com.user.deadlinesync.plist 사용하여에서 구성 파일을 생성합니다(1단계의 실제 경로/path/to/deadline로 대체).

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.user.deadlinesync</string> <key>ProgramArguments</key> <array> <string>/path/to/deadline</string> <string>queue</string> <string>sync-output</string> <string>--profile</string> <string>deadline-downloader</string> <string>--farm-id</string> <string>YOUR_FARM_ID</string> <string>--queue-id</string> <string>YOUR_QUEUE_ID</string> <string>--storage-profile-id</string> <string>YOUR STORAGE PROFILE ID</string> <string>--checkpoint-dir</string> <string>/path/to/checkpoint/dir</string> </array> <key>RunAtLoad</key> <true/> <key>UserName</key> <string>YOUR_USER_NAME</string> <key>StandardOutPath</key> <string>/path/to/logs/deadline_sync.log</string> <key>StartInterval</key> <integer>300</integer> </dict> </plist>

    다운로드 머신이 제출 머신과 동일한 --ignore-storage-profiles 경우 --storage-profile-id YOUR_PROFILE_ID 위의를 로 바꿉니다.

  4. Plist 파일 검증

    plist 파일의 XML 구문을 검증합니다.

    $ plutil -lint ~/Library/LaunchAgents/com.user.deadlinesync.plist

    파일이 유효한 경우 명령은 "OK"를 반환합니다.

  5. 기존 시작 에이전트 또는 시작 데몬 확인

    시작 에이전트가 이미 로드되었는지 확인합니다.

    $ launchctl list | grep deadlinesync OR $ sudo launchctl list | grep deadlinesync

    존재하는 경우 먼저 언로드합니다.

    $ launchctl bootout gui/$(id -u)/com.user.deadlinesync OR $ sudo launchctl bootout system/com.user.deadlinesync
  6. 생성 및 부트스트랩

    사용자가 로그인한 상태에서이 작업을 실행하려면 LaunchAgent로 실행합니다. 시스템을 실행할 때마다 사용자가 로그인하지 않고이 작업을 실행하려면 LaunchDaemon으로 실행합니다.

    1. LaunchAgent로를 실행하려면

      1. 아래에 생성된 구성 사용 ~/Library/LaunchAgents/com.user.deadlinesync.plist

      2. 그런 다음 부트스트랩 명령을 사용하여 구성을 로드합니다.

        $ launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.user.deadlinesync.plist
    2. LaunchDaemon으로를 실행하려면:

      1. 다음을 실행하여 Pilst 파일을 이동하고 권한을 변경합니다.

        $ sudo mv ~/Library/LaunchAgents/com.user.deadlinesync.plist /Library/LaunchDaemons/ $ sudo chown root:wheel /Library/LaunchDaemons/com.user.deadlinesync.plist $ sudo chmod 644 /Library/LaunchDaemons/com.user.deadlinesync.plist
      2. 최신 부트스트랩 명령을 사용하여 시작 에이전트를 로드합니다.

        $ sudo launchctl bootstrap system /Library/LaunchDaemons/com.user.deadlinesync.plist
  7. 상태 확인

    LaunchAgent를 부트스트래핑한 경우 다음을 실행하여 로드되었는지 확인합니다.

    $ launchctl list | grep deadlinesync

    LaunchDaemon을 부트스트래핑한 경우 다음을 실행하여 로드되었는지 확인합니다.

    $ sudo launchctl list | grep deadlinesync

    출력은 다음과 같아야 합니다.

    SOME_PID_NUMBER 0 com.user.deadlinesync

    자세한 상태 정보는 다음과 같습니다.

    $ launchctl print gui/$(id -u)/com.user.deadlinesync

    현재 상태, 프로그램 인수, 환경 변수, 실행 간격 및 실행 기록이 표시됩니다.

Windows
참고

이러한 지침을 사용하여 생성된 예약된 작업은 사용자가 로그인한 경우에만 작동합니다.

사용자 로그인 없이 시스템 시작 시 설정하려면 Microsoft 웹 사이트의 공식 Windows 설명서를 참조하세요.

아래 모든 단계에서 명령 프롬프트 - 관리자로 실행을 사용합니다.

  1. 기한 CLI 설치 확인

    기한 실행 파일을 찾습니다.

    C:\> where deadline

    작업에 사용할 전체 경로(예: C:\Program Files\Amazon\DeadlineCloud\deadline.exe)를 기록해 둡니다.

  2. 체크포인트 디렉터리 생성

    체크포인트 파일이 저장될 디렉터리를 생성합니다.

    C:\> mkdir "path\to\checkpoint\directory"
  3. 로그 디렉터리 생성

    작업 로그용 디렉터리를 생성합니다.

    C:\> mkdir "path\to\logs"
  4. 배치 파일 래퍼 생성

    다음 콘텐츠로 배치 파일을 생성합니다.

    C:\> notepad C:\path\to\deadline_sync.bat
    YOUR_PATH_TO_DEADLINE.EXE 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\checkpoints > path\to\logs\deadline.log 2>&1
  5. 배치 파일 테스트

    배치 파일을 수동으로 테스트합니다.

    C:\> .\path\to\deadline_sync.bat

    로그 파일이 생성되었는지 확인합니다.

    C:\> notepad path\to\logs\deadline_sync.log
  6. 작업 스케줄러 서비스 확인

    Task Scheduler 서비스가 실행 중인지 확인합니다.

    C:\> sc query "Schedule"

    서비스가 없는 경우 대체 이름을 시도해 보세요.

    C:\> sc query "TaskScheduler" C:\> sc query "Task Scheduler"

    실행 중이 아니면 시작합니다.

    C:\> sc start "Schedule"
  7. 예약된 작업 생성

    5분마다 실행할 작업을 생성합니다.

    C:\> schtasks /create /tn "DeadlineOutputSync" /tr "C:\path\to\deadline_sync.bat" /sc minute /mo 5

    명령 분석:

    • /tn - 작업 이름

    • /tr - 실행할 작업(배치 파일)

    • /sc minute /mo 5 - 일정: 5분마다

  8. 작업 생성 확인

    작업이 성공적으로 생성되었는지 확인합니다.

    schtasks /query /tn "DeadlineOutputSync" /v /fo LIST

    다음과 같은 사항이 있는지 찾습니다.

    • 실행할 작업: 배치 파일 경로를 표시해야 합니다.

    • 다음 실행 시간: 5분 이내에 시간을 표시해야 합니다.

  9. 테스트 작업 실행

    작업을 수동으로 실행하여 다음을 테스트합니다.

    schtasks /run /tn "DeadlineOutputSync"

    작업 상태 확인:

    schtasks /query /tn "DeadlineOutputSync"
설정 확인

자동 다운로드 설정이 성공했는지 확인하려면 다음 단계를 완료하세요.

  1. 새 테스트 작업을 제출합니다.

  2. 한 스케줄러 간격이 완료될 때까지 기다립니다.이 경우 5분입니다.

  3. 새 출력이 자동으로 다운로드되는지 확인합니다.

출력이 다운로드되지 않는 경우 문제 해결 섹션에서 프로세스 로그를 확인합니다.

자동 다운로드 문제 해결

자동 다운로드에 문제가 발생하면 다음을 확인하세요.

오류 코드 다운로드

다운로드가 실패하면 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-id FARM_ID --queue-id QUEUE_ID \ --storage-profile-id STORAGE_PROFILE_ID \ --force-bootstrap --bootstrap-lookback-minutes 1440

두 플래그를 함께 전달합니다. --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검토합니다.

스케줄러 로그 확인

Linux
  1. cron 서비스가 실행 중인지 확인합니다.

    # For systemd systems $ sudo systemctl status cron # or $ sudo systemctl status crond # Check if your user has cron job correctly configured $ crontab -l
  2. cron 실행 로그 보기:

    # Check system logs for cron activity (most common locations) $ sudo tail -f /var/log/syslog | grep CRON $ sudo tail -f /var/log/cron.log | grep deadline # View recent cron logs $ sudo journalctl -u cron -f $ sudo journalctl -u crond -f # On some systems
  3. 특정 cron 작업 로그를 확인합니다.

    # View the log file specified in your cron job $ tail -100f /path/to/logs/deadline_sync.log
  4. 시스템 로그에서 cron 작업 실행을 검색합니다.

    # Look for your specific cron job executions $ sudo grep "deadline.*sync-output" /var/log/syslog # Check for cron job starts and completions $ sudo grep "$(whoami).*CMD.*deadline" /var/log/syslog
  5. 체크포인트 파일 업데이트 확인:

    # List checkpoint files with timestamps $ ls -la /path/to/checkpoint/directory/ # Check when checkpoint was last modified $ stat /path/to/checkpoint/directory/queue-*_download_checkpoint.json
  6. 로그 파일을 확인합니다.

    $ ls -la /path/to/log/deadline_sync.log
macOS

시작 에이전트 실행 로그 보기:

  1. 시작 에이전트가 실행 중인지 확인합니다.

    $ sudo launchctl list | grep deadlinesync

    출력 표시: PID Status Label (PID는 현재 실행되지 않을 - 때 이며 간격 작업의 경우 정상임)

  2. 자세한 시작 에이전트 상태 보기:

    $ sudo launchctl print system/com.user.deadlinesync

    실행 기록, 마지막 종료 코드, 실행 횟수 및 현재 상태가 표시됩니다.

  3. 시작 에이전트 실행 로그 보기:

    # View recent logs (last hour) log show --predicate 'subsystem contains "com.user.deadlinesync"' --last 1h # View logs from a specific time period log show --predicate 'subsystem contains "com.user.deadlinesync"' --start '2024-08-27 09:00:00'
  4. 즉시 테스트를 위해 시작 에이전트를 강제 실행합니다.

    $ sudo launchctl kickstart gui/$(id -u)/com.user.deadlinesync

    이렇게 하면 일정에 관계없이 작업이 즉시 트리거되어 테스트에 유용합니다.

  5. 체크포인트 파일 업데이트 확인:

    # List checkpoint files with timestamps $ ls -la /path/to/checkpoint/directory/
  6. 로그 파일을 확인합니다.

    $ ls -la /path/to/log/deadline_sync.log
Windows
  1. Task Scheduler 서비스가 실행 중인지 확인합니다.

    C:\> sc query "Schedule"

    서비스가 존재하지 않는 경우 대체 이름을 시도해 보세요.

    C:\> sc query "TaskScheduler" C:\> sc query "Task Scheduler"
  2. 예약된 작업 보기:

    C:> schtasks /query /tn "DeadlineOutputSync"
  3. 작업의 로그 파일을 확인합니다.

    # View the log file created by your batch script C:> notepad C:\path\to\logs\deadline_sync.log
  4. 체크포인트 파일 업데이트 확인:

    # List checkpoint files with timestamps C:> dir "C:\path\to\checkpoint\directory" /od