View a markdown version of this page

问题排查 - AWS 截止日期云
为什么用户看不到我的农场、舰队或队列？为什么工人不接我的工作？为什么我的工作人员一直无法运行？排查作业截止日期云监控桌面应用程序日志其他资源

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

问题排查

以下步骤和提示可以帮助您解决与 AWS Deadline Cloud 农场和资源有关的问题。

为什么用户看不到我的农场、舰队或队列？

用户访问权限

当您的用户在 Deadline Cloud 监视器中看不到您的农场、舰队或队列时，他们对您的农场和资源的访问权限可能会出现问题。

无法访问任何农场的用户会在 Deadline Cloud 监视器中收到 “没有可用的农场” 消息。

确认您为农场、车队或队列分配了正确的用户或群组

  1. 在 De AWS adline Cloud 控制台中，找到您的农场、舰队或队列，然后选择访问管理。

  2. 默认情况下，群组选项卡处于选中状态。如果您按群组分配权限（建议这样做），则您的群组应显示在列表中并具有已分配的访问级别。

    如果该群组不在列表中，请选择添加群组为该群组分配权限。

  3. 如果您要按用户分配权限，请选择 “用户” 选项卡。您的用户应显示在列表中并分配访问级别。

    如果您的用户不在列表中，请选择添加用户为该用户分配权限。

确认您已将用户分配到您的群组

  1. 在 De AWS adline Cloud 控制台中，找到您的农场、舰队或队列，然后选择访问管理。

  2. 默认情况下，群组选项卡处于选中状态。选择群组名称以查看其成员。

  3. 如果用户未在群组中列出，则必须添加他们。

    如果您使用默认身份设置，则可以直接在 Identity Center 控制台中将用户添加到群组。如果您连接到外部身份提供商，例如Okta或Google Workspace，则可以将用户添加到身份提供商的群组中。

    注意

    一些外部身份提供商将用户同步到身份中心，但不同步群组。在这种情况下，可以考虑直接向用户分配权限，而不是按组分配权限。

有关管理用户对 Deadline Cloud 访问权限的更多信息，请参阅在 Deadline 云中管理用户。

为什么工人不接我的工作？

舰队角色配置

有时，当创建了工作人员但没有完成初始化并且没有开始处理任务时，这是因为队列角色配置不正确。

要验证此原因，请检查您的 CloudTrail 日志中是否存在任何访问被拒绝错误。确认访问被拒绝问题后，前往您的队列并将角色配置更新为正确的权限。有关更多信息，请参阅 Deadline Cloud 开发者指南中的CloudTrail日志。

为什么我的工作人员一直无法运行？

工作人员无法退出 OpenJD 环境

工作人员可能会陷入长时间运行的envExit会话操作中。如果您使用的作业模板覆盖 OpenJD 模板并将环境退出操作超时设置为超过 5 分钟，则可能会出现此问题。Deadline Cloud 监视器为陷入这种情况的工作人员提供了一些可见性，但它需要将RUNNING工作人员与关联队列中的可用工作进行交叉引用。

要找到卡住的员工，请在 Deadline Cloud 监视器中查看所有队列并完成以下步骤：

  1. 在工作人员状态列中，查找RUNNING工作人员。

  2. 在舰队详细信息部分，导航到每个关联队列。

  3. 在每个关联队列中，搜索位于RUNNINGREADY、或的作业PENDING。如果所有关联队列都没有处于这些状态的作业，则该工作人员正在运行环境退出。

要阻止处于此状态的工作人员，请使用以下 AWS CLI 命令：

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

运行命令后，工作器代理会在程序退出时重新启动。然后，工作人员返回联机状态，从关联队列中运行更多作业。如果队列包含更多环境退出操作超时时间超过 5 分钟的作业，则该工作人员将再次陷入困境。如果发生这种情况，你将需要重复这个过程，直到不再有工作人员被困在退出为止。

为避免此问题，请在使用作业模板时将超时选项设置为不超过 5 分钟。

对截止日期云任务疑难解

有关 AWS Deadline Cloud 中作业的常见问题的信息，请参阅以下主题。

为什么创建我的任务失败了？

配额验证

作业可能无法通过验证检查的一些可能原因包括：

  • 作业模板不遵循 OpenJD 规范。

  • 该任务包含太多步骤。

  • 该任务总共包含太多任务。

  • 出现内部服务错误，无法创建作业。

要查看任务中最大步骤和任务数的配额，请使用服务配额控制台。有关更多信息，请参阅 的服务配额和限制 Deadline Cloud。

CHUNK [INT] 任务参数错误

如果任务创建失败并显示以下错误消息，则需要将TASK_CHUNKING扩展程序添加到作业模板中。

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

要解决此问题，请将以下内容添加到您的作业模板中：

extensions:
  - TASK_CHUNKING

有关更多信息，请参阅 AWS Deadline Cloud 开发者指南中的向作业模板添加任务分块。

为什么我的工作不兼容？

任务与队列不兼容的常见原因包括：

Deadline Cloud 会在您提交任务时检查兼容性。如果您稍后将兼容队列与队列相关联，则现有NOT_COMPATIBLE任务不会自动重启。要运行这些作业，请重新对它们进行重新排序。有关更多信息，请参阅 重新申请工作。

为什么我的工作准备就绪？

你的工作似乎停滞在该READY州的可能原因包括：

为什么我的工作失败了？

一项工作失败的原因可能有很多。要搜索问题，请打开 Deadline Cloud 监视器并选择失败的作业。选择失败的任务，然后查看该任务的日志。有关说明，请参阅在 Deadline Cloud 中查看会话和工作人员日志。

  • 如果您看到许可证错误，或者由于软件没有有效许可证而出现水印，请确保工作人员可以连接到所需的许可证服务器。有关更多信息，请参阅 Deadl ine Cloud 开发人员指南中的将客户管理的队列连接到许可证端点。

  • 最后的会话操作消息或进程退出代码可能会提供有关任务失败原因的信息。如果您正在使用Windows且退出代码为负数，请尝试搜索退出代码的未签名版本：

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

为什么我的工作失败了 Windows 什么时候我的文件路径很长？

当您的项目使用长路径时，即使在工作站上Windows呈现相同的文件，工作程序上的作业也可能会失败。文件传输正确，当渲染应用程序打开文件时会发生故障。症状包括以下几点：

  • 渲染应用程序找不到场景文件或其依赖项之一，即使该文件是随作业一起上传的。

  • 任务日志包含FileNotFoundError或一条命名长路径的[WinError 3] The system cannot find the path specified消息。

  • 当您缩短场景文件名而不更改任何其他内容时，作业就会成功。

Windows将大多数文件路径限制为 260 个字符。有两点使得在渲染农场上比在工作站上更容易达到这个极限：

  • 长路径支持针对每个应用程序，而不是每台计算机。Windows仅支持在其应用程序清单longPathAware中声明的应用程序的LongPathsEnabled注册表设置，因此在工作主机上启用该设置并不会提高未声明注册表设置的应用程序的限制。

  • macOS并且Linux允许最多 1,024 个字符，因此从其中一个工作站提交到Windows队列可能会生成路径，这些路径在创建时有效，渲染位置也太长。

Deadline Cloud 将Windows扩展长度路径前缀应用于自己的文件操作，因此传输和上传不会受到影响。它不能在使用自己的代码打开文件的渲染应用程序中应用该前缀，这就是在渲染时出现故障的原因。会话和作业附件目录名称也使用 260 个字符的一部分。

要解决故障，请使用以下一种或多种方法，从最可靠的方法开始：

  1. 缩短项目路径。这种方法是唯一适用于所有应用程序的方法，因为它避免了限制，而不是绕过了限制。

  2. 使用队列环境来缩短应用程序看到的路径。Deadline Cloud 发布了一个示例，该示例将作业附件目录连接到一条短路径，并提供了匹配的路径映射规则。请参阅网站存储库中的 windows_path_limit_junction_fix.yaml 。deadline-cloud-samples GitHub 它仅对阅读这些规则的集成生效。

  3. 如果你的软件在Linux舰队上可用，则在舰队上进行渲染。Linux不受限额限制。

注意

这些方法会扩大项目可用的路径预算，而不是取消 260 个字符的限制。一条足够长的路径仍然失败。

为什么我的步骤处于待处理状态？

当一个或多个依赖项未完成时，步骤可能会保持PENDING状态。你可以使用截止日期云监控器检查依赖关系的状态。有关说明，请参阅在 Deadline Cloud 中查看步骤。

截止日期云监控桌面应用程序日志

Deadline Cloud 监控器桌面应用程序会写入诊断日志，您可以使用这些日志来调查崩溃或其他意外行为。报告桌面应用程序问题时，请包括相关的日志文件以帮助诊断。

日志文件的位置取决于您的操作系统：

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

其他资源

您可以在网站的 aws-deadline 存储库中找到其他信息和资源。 GitHub