翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
自動ダウンロード
Deadline CLI は、同じコマンドが最後に実行されてから完了したキュー内のすべてのタスクの出力をダウンロードするコマンドを提供します。これは、繰り返し実行する cron ジョブまたはスケジュールされたタスクとして設定できます。この設定では、出力の自動ダウンロードが継続的に設定されます。
自動ダウンロードを設定する前に、ジョブアタッチメントのストレージプロファイルの手順に従って、アップロードとダウンロードのためにアセットデータのすべてのパスを設定します。ジョブがストレージプロファイルにない出力パスを使用する場合、自動ダウンロードはその出力のダウンロードをスキップし、警告メッセージを出力して、ダウンロードしなかったファイルを要約します。同様に、ストレージプロファイルなしでジョブが送信された場合、自動ダウンロードはそのジョブをスキップし、警告メッセージを出力します。デフォルトでは、Deadline Cloud 送信者は、正しい設定を保証するために、ストレージプロファイルの外部にあるパスの警告メッセージを表示します。
AWS 認証情報の設定
自動ダウンロードでは、Deadline CLI を使用してジョブ出力を継続的にダウンロードします。これらのダウンロードを認証するには、長期的な IAM 認証情報が必要です。Deadline Cloud モニターの認証情報の有効期限が切れるため、この目的で使用することはできません。
長期認証情報を設定するには、次の手順に従います。
重要
次の警告に注意してください。
-
アカウントのルート認証情報を使用して AWS リソースにアクセスしないでください。これらの認証情報は無制限のアカウントアクセスを提供し、取り消すのが困難です。
-
アプリケーションファイルにリテラルアクセスキーや認証情報を配置しないでください。これを行うと、パブリックリポジトリにプロジェクトをアップロードするなど、誤って認証情報が公開されるリスクが発生します。
-
プロジェクト領域に認証情報を含むファイルを含めないでください。
-
アクセスキーを保護します。アカウント識別子を確認するためであっても、アクセスキーを認可されていない当事者に提供しないでください。提供すると、第三者がアカウントへの永続的なアクセスを取得する場合があります。
-
共有 AWS 認証情報ファイルに保存されている認証情報はすべてプレーンテキストで保存されることに注意してください。
詳細については、 AWS 全般のリファレンスの AWS 「アクセスキーを管理するためのベストプラクティス」を参照してください。
IAM ユーザーの作成
IAM コンソール (https://console.aws.amazon.com/iam/
) を開きます。 -
ナビゲーションペインで [ユーザー]、[ユーザーの作成] の順に選択します。
-
ユーザー に名前を付けます
deadline-output-downloader。へのユーザーアクセスを許可する AWS マネジメントコンソールのチェックボックスをオフにし、次へを選択します。 -
[ポリシーを直接アタッチ] を選択します。
-
ポリシーの作成 を選択して、最低限必要なアクセス許可を持つカスタムポリシーを作成します。
-
JSON エディタで、次のアクセス許可を指定します。
-
ポリシーに名前を付け
DeadlineCloudOutputDownloadPolicy、ポリシーの作成を選択します。 -
ユーザー作成ページに戻り、ポリシーリストを更新して、先ほど作成した DeadlineCloudOutputDownloadPolicy を選択し、次へを選択します。
-
ユーザーの詳細を確認し、ユーザーの作成を選択します。
アクセスキーの作成
-
ユーザーの詳細ページから、セキュリティ認証情報タブを選択します。[Access keys (アクセスキー)] セクションで、[Create access key (アクセスキーを作成)] を選択します。
-
Other に キーを使用するように指定し、Next を選択し、Create access key を選択します。
-
アクセスキーの取得ページで、表示を選択してユーザーのシークレットアクセスキーの値を表示します。認証情報をコピーするか、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 アイデンティティセンターときは、 を通じて一時的な認証情報を使用することを人間のユーザーに要求することをお勧めします 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 で出力ダウンロードステータスを表示する」を参照してください。
出力ダウンロードコマンドをテストする
環境でコマンドが動作することを検証するには
-
Deadline へのパスを取得する
-
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 リポジトリ
を開きます。 -
Code を選択し、ドロップダウンメニューから Download 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 分ごとに自動ダウンロードを設定する方法がわかります。
セットアップを確認する
自動ダウンロードの設定が成功したことを確認するには、次の手順を実行します。
-
新しいテストジョブを送信します。
-
1 つのスケジューラ間隔が完了するまで待ちます。この場合は 5 分です。
-
新しい出力が自動的にダウンロードされることを確認します。
出力がダウンロードされない場合は、プロセスログのトラブルシューティングセクションを確認してください。
自動ダウンロードのトラブルシューティング
自動ダウンロードで問題が発生した場合は、以下を確認してください。
エラーコードのダウンロード
ダウンロードが失敗すると、Deadline Cloud モニターのダウンロードステータス列に理由が付けられ、deadline queue sync-outputコマンドは次のいずれかのエラーコードを記録します。これらのエラーのほとんどは、ダウンロードコマンドを実行するマシンで解決されます。これは、多くの場合、モニタを表示するマシンとは異なるマシンです。
PERMISSION_DENIED(アクセス許可が拒否されました)-
ダウンローダーは出力場所に書き込むことが許可されていないか、 AWS 認証情報がアクセスを拒否されました。ダウンロードコマンドを実行するユーザーに出力場所への書き込みアクセス権を付与し、コマンドの AWS プロファイルがキューにアクセスできることを確認し、コマンドを再度実行します。
DISK_FULL(ディスクがいっぱい)-
ダウンロードを実行しているマシンのディスク容量が不足しました。出力場所を保持するドライブのスペースを解放し、コマンドを再度実行します。
PATH_NOT_FOUND(パスが見つかりません)-
出力先が存在しないか、ダウンロードを実行しているマシンにマウントされていません。ディレクトリを作成するか、共有ドライブをマウントしてから、 コマンドを再度実行します。
NETWORK_ERROR(ネットワークエラー)-
ネットワーク中断により転送が停止しました。通常、ネットワークエラーは一時的なものです。コマンドを再度実行し、エラーが繰り返された場合はマシンの接続を確認します。
UNKNOWN(失敗)-
ダウンローダーが特定の原因を特定できませんでした。モニターには、このコードと認識されないコードの失敗が表示されます。
deadline queue sync-outputコマンドのログ出力で、基になるエラーを確認します。
ダウンロードに失敗したジョブは、後で実行されるたびに自動的に再試行されます。5 回失敗すると、ダウンローダーはジョブの再試行を停止し、警告を表示します。原因を修正したら、ジョブが終了した時点をカバーするルックバックウィンドウで download コマンドを実行して、ジョブを復旧します。
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単独では何も復旧しません。
ジョブがスキップされたのはなぜですか?
ダウンローダーがジョブをスキップすると、Download ステータス列はセル内で直接理由に名前を付けます。
- アタッチメントなし (
no_attachments) -
ジョブはジョブアタッチメントで送信されなかったため、ダウンロードする出力ファイルが記録されていません。一部のジョブはダウンロード可能な出力を生成しないため、アタッチメントのないスキップされたジョブには通常アクションは必要ありません。
- ストレージプロファイルがありません (
missing_storage_profile) -
ダウンロードコマンドがそれを使用している間、ジョブはストレージプロファイルなしで送信されたため、ダウンローダーはジョブのファイルが各マシンのどこに属しているかを知りません。ストレージプロファイルが設定されるまで、ジョブのダウンロードはありません。ジョブのストレージプロファイルはジョブの送信時に設定されるため、ストレージプロファイルを使用してジョブを送信し、同じプロファイルをダウンロードコマンドに渡します。タスクテーブルの欠落ストレージプロファイルのステータスは、説明、ドキュメントリンク、AI によるトラブルシューティングボタンを開くリンクです。詳細については、「ジョブアタッチメントのストレージプロファイル」を参照してください。
理由が表示されないスキップされたジョブは、出力を生成する前にキャンセルまたは停止されました。アクションは必要ありません。
ダウンロードの問題ですか、レンダリングの問題ですか。
タスクのダウンロードステータス列の問題は、2 つの異なるモノを意味し、それらには異なる修正があります。ステータステキストには、持っているものが表示されます。
-
実行ステータスが であるタスクの出力は、タスクがファームでレンダリングに失敗した
FAILEDことを意味します。ファイルが生成されなかったため、ダウンロードするものはありませんでした。ドライブとネットワークは問題ありません。タスクのログを確認して、レンダリングエラーを見つけて修正し、タスクを再キューに入れます。タスクは、ファイルを記述せずに正常に終了した後に出力なしを表示することもできます。これは正常であり、アクションは必要ありません。 -
アクセス許可の拒否などのエラー名は、レンダリングされたタスクとその出力が存在し、ファイルシステムへのファイルのコピーが失敗したことを意味します。を使用してエラーを解決しますエラーコードのダウンロード。
ジョブテーブルでは、両方の問題がジョブのダウンロードの進行状況バーに赤いセグメントとして表示されます。ジョブのタスクテーブルを開いて、それらを区別します。すべてのタスクが失敗したジョブは出力を生成しなかったため、ダウンロードエラーの代わりにダッシュが表示されます。ジョブ独自のステータス列は、その失敗を報告します。これらのレンダリング失敗ケースでダウンロードを診断すると時間が浪費されるため、必ず最初にタスクの実行ステータスを確認してください。
AI を使用したトラブルシューティング
赤色の出力同期失敗インジケータを含む Deadline Cloud モニターのダウンロード失敗メッセージには、AI によるトラブルシューティングボタンが含まれています。ボタンで Deadline Cloud Assistant が開き、キューのダウンロードステータスレコードが読み取られ、修正のために実行するコマンドなど、特定の障害について説明します。
エラーコードの修正を試みた後にダウンロードが失敗し続ける場合、認識できないエラーが表示される場合、または問題がどのマシンにあるかわからない場合に、 に到達します。モニタで Deadline Cloud Assistant が有効になっている場合、ボタンが表示されます。詳細については、「Deadline クラウドアシスタント」を参照してください。
ストレージプロファイルの問題
-
ログファイル
[Errno 13] Permission deniedの[Errno 2] No such file or directoryや などのエラーは、ストレージプロファイルの欠落や設定ミスに関連している可能性があります。 -
ダウンロードマシンが送信マシンと異なる場合にストレージプロファイルを設定する方法については、「ストレージプロファイル」を参照してください。
-
同じマシンのダウンロードの場合は、
--ignore-storage-profilesフラグを試してください。
ディレクトリ権限
-
スケジューラサービスユーザーに以下があることを確認します。
-
チェックポイントディレクトリへの読み取り/書き込みアクセス
-
出力先ディレクトリへの書き込みアクセス
-
-
Linux および の場合macOS、
ls -laを使用してアクセス許可を確認します。 -
についてはWindows、「プロパティ」フォルダのセキュリティ設定を確認してください。