翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # トラブルシューティング 次の手順とヒントは、Deadline Cloud AWS ファームとリソースに関する問題のトラブルシューティングに役立ちます。 **Topics** + [ユーザーがファーム、フリート、またはキューを表示できないのはなぜですか?](#troubleshooting_user_not_seeing_farm) + [ワーカーがジョブを取得しないのはなぜですか?](#troubleshooting_workers_not_picking_jobs) + [ワーカーが停止しているのはなぜですか?](#troubleshooting_worker_stuck_running) + [Deadline Cloud ジョブのトラブルシューティング](#jobs-troubleshooting) + [Deadline Cloud Monitor デスクトップアプリケーションログ](#troubleshooting-desktop-logs) + [その他のリソース](#troubleshooting_additional_resources) ## ユーザーがファーム、フリート、またはキューを表示できないのはなぜですか? ### ユーザーアクセス Deadline Cloud モニターにファーム、フリート、またはキューが表示されない場合、ファームとリソースへのアクセスに問題がある可能性があります。 ファームにアクセスできないユーザーは、Deadline Cloud モニターで「利用可能なファームはありません」というメッセージを受け取ります。 **ファーム、フリート、またはキューに正しいユーザーまたはグループが割り当てられていることを確認するには** 1. AWS Deadline Cloud コンソールで、ファーム、フリート、またはキューを検索し、**アクセス管理**を選択します。 1. グループタブはデフォルトで選択されています。グループごとにアクセス許可を割り当てる場合は、グループがリストに表示され、アクセスレベルが割り当てられます。 グループがリストにない場合は、**グループの追加**を選択して、グループに許可を割り当てます。 1. ユーザーごとにアクセス許可を割り当てる場合は、**ユーザー**タブを選択します。ユーザーがリストに表示され、アクセスレベルが割り当てられている必要があります。 ユーザーがリストにない場合は、**ユーザーを追加** を選択してユーザーに許可を割り当てます。 **ユーザーがグループに割り当てられていることを確認するには** 1. AWS Deadline Cloud コンソールで、ファーム、フリート、またはキューを検索し、**アクセス管理**を選択します。 1. グループタブはデフォルトで選択されています。メンバーを表示するグループ名を選択します。 1. ユーザーがグループにリストされていない場合は、追加する必要があります。 デフォルトの ID 設定を使用している場合は、Identity Center コンソールでユーザーをグループに直接追加できます。Okta や などの外部 ID プロバイダーに接続されている場合はGoogle Workspace、ID プロバイダーのグループにユーザーを追加できます。 **注記** 一部の外部 ID プロバイダーはユーザーを同期しますが、グループを Identity Center に同期しません。この場合、グループではなくユーザーに直接アクセス許可を割り当てることを検討してください。 Deadline Cloud へのユーザーアクセスの管理の詳細については、「」を参照してください[Deadline Cloud でのユーザーの管理](managing-users.md)。 ## ワーカーがジョブを取得しないのはなぜですか? ### フリートロールの設定 ワーカーが作成されても初期化が完了しず、ジョブの処理を開始しない場合、フリートロールが正しく設定されていないことが原因です。 この原因を確認するには、アクセス拒否エラーがないか CloudTrail ログを確認します。アクセス拒否の問題を確認したら、フリートに移動し、ロール設定を正しいアクセス許可に更新します。詳細については、Deadline [CloudTrail ログ](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/logging-using-cloudtrail.html)」を参照してください。 ## ワーカーが停止しているのはなぜですか? ### OpenJD 環境からワーカーが停止する ワーカーは長時間実行される`envExit`セッションアクションで停止する可能性があります。この問題は、OpenJD テンプレートを上書きし、環境終了アクションのタイムアウトを 5 分以上に設定するジョブテンプレートを使用する場合に発生する可能性があります。Deadline Cloud モニターは、この状況でスタックしているワーカーをある程度可視化しますが、関連するキューで使用可能な作業と`RUNNING`ワーカーを相互参照する必要があります。 スタックしたワーカーを見つけるには、Deadline Cloud モニターのすべてのフリートを確認し、次の手順を実行します。 1. ワーカーステータス列で、`RUNNING`ワーカーを検索します。 1. フリートの詳細セクションから、関連する各キューに移動します。 1. 関連付けられた各キューで、`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](deadline-cloud-quotas.md)」を参照してください。 #### 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](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/build-job-bundle-chunking-add.html)」を参照してください。 ### ジョブに互換性がないのはなぜですか? ジョブがキューと互換性がない一般的な理由は次のとおりです。 + ジョブが送信されたキューに関連付けられているフリートはありません。Deadline Cloud モニターを開き、キューにフリートが関連付けられていることを確認します。キューを表示する方法の詳細については、「」を参照してください[Deadline Cloud でキューとフリートの詳細を表示する](view-queue-and-fleet.md)。 + ジョブには、キューに関連付けられているフリートによって満たされないホスト要件があります。確認するには、ジョブテンプレートの`hostRequirements`エントリをファーム内のフリートの設定と比較します。いずれかのフリートがホスト要件を満たしていることを確認します。フリートの互換性の詳細については、[「フリートの互換性の確認](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/build-jobs-scheduling.html#jobs-scheduling-compatibility)」を参照してください。フリート設定を表示するには、「」を参照してください[Deadline Cloud でキューとフリートの詳細を表示する](view-queue-and-fleet.md)。 Deadline Cloud は、ジョブの送信時に互換性をチェックします。互換性のあるフリートを後でキューに関連付けると、既存の`NOT_COMPATIBLE`ジョブは自動的に再起動されません。これらのジョブを実行するには、再度キューに入れます。詳細については、「[ジョブをキューに入れる](view-a-job.md#view-jobs-steps-tasks-requeue)」を参照してください。 ### ジョブの準備が整うのはなぜですか? ジョブが `READY`状態でスタックしているように見える理由には、次のようなものがあります。 + キューに関連付けられているフリートの最大ワーカー数は 0 に設定されています。確認するには、「」を参照してください[Deadline Cloud でキューとフリートの詳細を表示する](view-queue-and-fleet.md)。 + キューには優先度の高いジョブがあります。確認するには、「」を参照してください[Deadline Cloud でキューとフリートの詳細を表示する](view-queue-and-fleet.md)。 + カスタマーマネージドフリートの場合は、自動スケーリング設定を確認します。詳細については、*「Deadline Cloud Developer Guide*」の「Create [fleet infrastructure with an Amazon EC2 Auto Scaling group](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/create-auto-scaling.html)」を参照してください。 ### ジョブが失敗したのはなぜですか? ジョブは、さまざまな理由で失敗する可能性があります。問題を検索するには、Deadline Cloud モニターを開き、失敗したジョブを選択します。失敗したタスクを選択し、タスクのログを表示します。手順については、「[Deadline Cloud でセッションログとワーカーログを表示する](view-logs.md)」を参照してください。 + ライセンスエラーが発生した場合、またはソフトウェアに有効なライセンスがないためにウォーターマークが発生した場合は、ワーカーが必要なライセンスサーバーに接続できることを確認してください。詳細については、*「Deadline Cloud Developer Guide*」の[「Connect customer-managed fleets to a license endpoint](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/cmf-ubl.html)」を参照してください。 + 最後のセッションアクションメッセージまたはプロセス終了コードは、ジョブが失敗した理由に関する情報を提供する場合があります。を使用してWindowsいて、終了コードが負の場合は、終了コードの署名なしバージョンを検索してみてください。 ``` 2,147,483,647 - |{{your exit code}}| ``` ### ステップが保留になっているのはなぜですか? ステップは、1 つ以上の依存関係が完了していない場合、 `PENDING`状態のままになることがあります。Deadline Cloud モニターを使用して、依存関係の状態を確認できます。手順については、「[Deadline Cloud でステップを表示する](view-a-step.md)」を参照してください。 ## 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](https://github.com/aws-deadline) にあります。