View a markdown version of this page

トラブルシューティング - AWS Deadline クラウド
ユーザーがファーム、フリート、またはキューを表示できないのはなぜですか?ワーカーがジョブを取得しないのはなぜですか?ワーカーが停止しているのはなぜですか?ジョブのトラブルシューティングDeadline Cloud Monitor デスクトップアプリケーションログその他のリソース

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トラブルシューティング

以下の手順とヒントは、Deadline Cloud AWS ファームとリソースに関する問題のトラブルシューティングに役立ちます。

ユーザーがファーム、フリート、またはキューを表示できないのはなぜですか?

ユーザーアクセス

Deadline Cloud モニターにファーム、フリート、またはキューが表示されない場合、ファームとリソースへのアクセスに問題がある可能性があります。

ファームにアクセスできないユーザーは、Deadline Cloud Monitor で「利用可能なファームはありません」というメッセージを受け取ります。

ファーム、フリート、またはキューに正しいユーザーまたはグループが割り当てられていることを確認するには

  1. AWS Deadline Cloud コンソールで、ファーム、フリート、またはキューを検索し、アクセス管理を選択します。

  2. グループタブはデフォルトで選択されています。グループごとにアクセス許可を割り当てる場合は、グループがリストに表示され、アクセスレベルが割り当てられます。

    グループがリストにない場合は、グループの追加を選択して、グループに許可を割り当てます。

  3. ユーザーごとにアクセス許可を割り当てる場合は、ユーザータブを選択します。ユーザーがリストに表示され、アクセスレベルが割り当てられている必要があります。

    ユーザーがリストにない場合は、ユーザーを追加 を選択してユーザーに許可を割り当てます。

ユーザーが グループに割り当てられていることを確認するには

  1. AWS Deadline Cloud コンソールで、ファーム、フリート、またはキューを検索し、アクセス管理を選択します。

  2. グループタブはデフォルトで選択されています。メンバーを表示するグループ名を選択します。

  3. ユーザーがグループにリストされていない場合は、追加する必要があります。

    デフォルトの ID 設定を使用している場合は、Identity Center コンソールでユーザーをグループに直接追加できます。Okta や などの外部 ID プロバイダーに接続されている場合はGoogle Workspace、ID プロバイダーのグループにユーザーを追加できます。

    注記

    一部の外部 ID プロバイダーはユーザーを同期しますが、グループを Identity Center に同期しません。この場合、グループではなくユーザーに直接アクセス許可を割り当てることを検討してください。

Deadline Cloud へのユーザーアクセスの管理の詳細については、「」を参照してくださいDeadline Cloud でのユーザーの管理。

ワーカーがジョブを取得しないのはなぜですか?

フリートロールの設定

ワーカーが作成されても初期化が完了しず、ジョブの処理を開始しない場合、フリートロールが正しく設定されていないことが原因です。

この原因を確認するには、アクセス拒否エラーがないか CloudTrail ログを確認します。アクセス拒否の問題を確認したら、フリートに移動し、ロール設定を正しいアクセス許可に更新します。詳細については、Deadline CloudTrail ログ」を参照してください。

ワーカーが停止しているのはなぜですか?

OpenJD 環境からのワーカーのスタック

ワーカーは長時間実行されるenvExitセッションアクションで停止する可能性があります。この問題は、OpenJD テンプレートを上書きし、環境終了アクションのタイムアウトを 5 分以上に設定するジョブテンプレートを使用する場合に発生する可能性があります。Deadline Cloud モニターは、この状況でスタックしているワーカーをある程度可視化しますが、関連するキューで使用可能な作業とRUNNINGワーカーを相互参照する必要があります。

スタックしたワーカーを見つけるには、Deadline Cloud モニターのすべてのフリートを確認し、次の手順を実行します。

  1. ワーカーステータス列で、RUNNINGワーカーを検索します。

  2. フリートの詳細セクションから、関連する各キューに移動します。

  3. 関連付けられた各キューで、RUNNING、、READYまたは のジョブを検索しますPENDING。関連付けられたすべてのキューにそれらの状態のジョブがない場合、ワーカーは環境の終了を実行しています。

この状態でワーカーがスタックするのを停止するには、次の AWS CLI コマンドを使用します。

aws deadline update-worker \
    --farm-id $FARM_ID     \
    --fleet-id $FLEET_ID   \
    --worker-id $WORKER_ID \
    --status STOPPED

コマンドを実行すると、プログラムが終了するとワーカーエージェントは再起動します。その後、ワーカーはオンラインに戻り、関連付けられたキューからより多くのジョブを実行します。キューに環境終了アクションのタイムアウトが 5 分を超えるジョブがさらに含まれている場合、ワーカーは再びスタックします。この場合、ワーカーが終了しなくなるまでこのプロセスを繰り返す必要があります。

この問題を回避するには、ジョブテンプレートを使用するときにタイムアウトオプションを 5 分以内に設定します。

Deadline Cloud ジョブのトラブルシューティング

AWS Deadline Cloud のジョブに関する一般的な問題については、以下のトピックを参照してください。

ジョブの作成が失敗したのはなぜですか?

クォータの検証

ジョブが検証チェックに失敗する理由には、次のようなものがあります。

  • ジョブテンプレートが OpenJD 仕様に従っていない。

  • ジョブに含まれるステップが多すぎます。

  • ジョブの合計タスクが多すぎます。

  • ジョブの作成を妨げる内部サービスエラーが発生しました。

ジョブ内のステップとタスクの最大数のクォータを確認するには、Service Quotas コンソールを使用します。詳細については、「のサービスクォータとスロットリング Deadline Cloud」を参照してください。

CHUNK[INT] タスクパラメータエラー

ジョブの作成に失敗し、次のエラーメッセージが表示された場合は、ジョブテンプレートに TASK_CHUNKING拡張機能を追加する必要があります。

The CHUNK[INT] task parameter requires the TASK_CHUNKING extension.

この問題を解決するには、ジョブテンプレートに以下を追加します。

extensions:
  - TASK_CHUNKING

詳細については、AWS 「Deadline Cloud Developer Guide」の「Add task chunking to a job template」を参照してください。

ジョブに互換性がないのはなぜですか?

ジョブがキューと互換性がない一般的な理由は次のとおりです。

  • ジョブが送信されたキューに関連付けられたフリートはありません。Deadline Cloud モニターを開き、キューにフリートが関連付けられていることを確認します。キューを表示する方法の詳細については、「」を参照してくださいDeadline Cloud でキューとフリートの詳細を表示する。

  • ジョブには、キューに関連付けられているフリートによって満たされないホスト要件があります。確認するには、ジョブテンプレートのhostRequirementsエントリをファーム内のフリートの設定と比較します。いずれかのフリートがホスト要件を満たしていることを確認します。フリートの互換性の詳細については、「フリートの互換性を確認する」を参照してください。フリート設定を表示するには、「」を参照してくださいDeadline Cloud でキューとフリートの詳細を表示する。

Deadline Cloud は、ジョブの送信時に互換性をチェックします。互換性のあるフリートを後でキューに関連付けると、既存のNOT_COMPATIBLEジョブは自動的に再起動されません。これらのジョブを実行するには、それらを再キューに入れます。詳細については、「ジョブをキューに入れる」を参照してください。

ジョブの準備が整うのはなぜですか?

ジョブが READY状態でスタックしているように見える理由には、次のようなものがあります。

ジョブが失敗したのはなぜですか?

ジョブは、さまざまな理由で失敗する可能性があります。問題を検索するには、Deadline Cloud モニターを開き、失敗したジョブを選択します。失敗したタスクを選択し、タスクのログを表示します。手順については、「Deadline Cloud でセッションログとワーカーログを表示する」を参照してください。

  • ライセンスエラーが発生した場合、またはソフトウェアに有効なライセンスがないためにウォーターマークが表示された場合は、ワーカーが必要なライセンスサーバーに接続できることを確認してください。詳細については、「Deadline Cloud Developer Guide」の「Connect customer-managed fleets to a license endpoint」を参照してください。

  • 最後のセッションアクションメッセージまたはプロセス終了コードは、ジョブが失敗した理由に関する情報を提供する場合があります。を使用してWindowsいて、終了コードが負の場合は、終了コードの署名なしバージョンを検索してみてください。

    2,147,483,647 - |your exit code|

ファイルパスが長いWindowsとジョブが失敗するのはなぜですか?

同じファイルがワークステーションでレンダリングされていても、プロジェクトで長いパスを使用すると、Windowsワーカーのジョブが失敗する可能性があります。ファイルが正しく転送され、レンダリングアプリケーションがファイルを開くと失敗が発生します。症状には以下が含まれます。

  • レンダリングアプリケーションは、ファイルがジョブとともにアップロードされた場合でも、シーンファイルまたはその依存関係の 1 つを見つけることができません。

  • タスクログにはFileNotFoundError、、または長いパスという名前の[WinError 3] The system cannot find the path specifiedメッセージが含まれます。

  • シーンファイル名を短くし、他に何も変更しないと、ジョブは成功します。

Windows は、ほとんどのファイルパスを 260 文字に制限します。次の 2 つの機能により、レンダーファームではワークステーションよりも制限に到達しやすくなります。

  • ロングパスのサポートは、マシンごとではなくアプリケーションごとです。 は、アプリケーションマニフェストlongPathAwareで宣言するアプリケーションに対してのみLongPathsEnabledレジストリ設定Windowsを尊重します。したがって、ワーカーホストで有効にしても、宣言しないアプリケーションの制限は解除されません。

  • macOS と は最大 1,024 文字Linuxまで使用できるため、これらのワークステーションの 1 つからWindowsフリートに送信すると、作成した場所とレンダリングする場所が長すぎる有効なパスが生成されます。

Deadline Cloud はWindows、拡張長パスプレフィックスを独自のファイルオペレーションに適用するため、転送とアップロードには影響しません。独自のコードでファイルを開くレンダリングアプリケーション内でそのプレフィックスを適用できないため、レンダリング時に障害が表示されます。セッションおよびジョブアタッチメントのディレクトリ名も 260 文字の一部を使用します。

失敗を解決するには、最も信頼性の高い方法から始めて、次の 1 つ以上の方法を使用します。

  1. プロジェクトのパスを短くします。このアプローチは、すべてのアプリケーションで機能する唯一のアプローチです。これは、制限を回避するのではなく、制限を回避するためです。

  2. アプリケーションに表示されるパスを短縮するキュー環境を使用します。Deadline Cloud は、ジョブアタッチメントディレクトリを短いパスにジャンクションし、一致するパスマッピングルールを提供するサンプルを発行します。GitHub ウェブサイトのdeadline-cloud-samplesリポジトリの Windows_path_limit_junction_fix.yaml を参照してください。これは、これらのルールを読み取る統合に対してのみ有効になります。

  3. ソフトウェアが利用可能な場合は、Linuxフリートでレンダリングします。 Linux は制限の対象ではありません。

注記

これらのアプローチでは、260 文字の制限を削除するのではなく、プロジェクトで使用できるパス予算を拡大します。十分な長さのパスは失敗します。

ステップが保留になっているのはなぜですか?

ステップは、1 つ以上の依存関係が完了していない場合、 PENDING状態のままになることがあります。Deadline Cloud モニターを使用して、依存関係の状態を確認できます。手順については、「Deadline Cloud でステップを表示する」を参照してください。

Deadline Cloud Monitor デスクトップアプリケーションログ

Deadline Cloud モニターデスクトップアプリケーションは、クラッシュやその他の予期しない動作を調査するために使用できる診断ログを書き込みます。デスクトップアプリケーションに関する問題を報告するときは、診断に役立つ関連ログファイルを含めます。

ログファイルの場所は、オペレーティングシステムによって異なります。

Windows
%APPDATA%\com.amazonaws.deadline.monitor\logs
macOS
~/Library/Logs/com.amazonaws.deadline.monitor/
Linux
~/.config/com.amazonaws.deadline.monitor/logs

その他のリソース

追加情報とリソースは、GitHub ウェブサイトの aws-deadline リポジトリにあります。