View a markdown version of this page

提供带有插件同步功能的自定义插件 - 截止日期云
插件同步的工作原理先决条件将插件文件上传到亚马逊 S3验证插件交付支持插件同步的应用程序

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

提供带有插件同步功能的自定义插件

插件同步无需您构建 conda 软件包即可提供自定义插件和附加组件。将插件文件上传到队列任务附件存储桶中的指定前缀。当作业使用支持的应用程序包时，该包会将文件复制到工作程序并配置应用程序以加载它们。

当插件文件复制到应用程序搜索路径后可以运行时，请使用插件同步。如果插件需要依赖关系解析、安装命令或系统更改，请在截止日期云中使用自定义插件返回选择其他交付方式。

插件同步的工作原理

支持的数字内容创建 (DCC) conda 包使用激活和停用脚本进行插件同步。每个工作器会话都会发生以下事件：

  1. 队列环境创建一个 conda 环境，其中包含作业选择的 DCC 和适配器包。

  2. 当 conda 激活环境时，DCC 包的插件同步脚本会从会话环境中读取任务附件存储桶和根前缀。

  3. 该脚本从 Amazon S3 中的操作系统、DCC 和 DCC 版本前缀下载文件。然后，它会设置特定于应用程序的环境变量或将文件复制到应用程序插件目录中。

  4. 会话结束后，停用脚本会删除下载的插件文件和配置。下一个会话从打包的 DCC 环境开始。

该脚本将以开头的消息写Plugin Sync:入会话日志。您可以使用这些消息来确认源前缀、目标和已处理的文件。

先决条件

在上传插件之前，请确认以下要求：

  • 应用程序、版本和工作器操作系统显示在支持的应用程序表中。

  • 插件文件与工作器操作系统、应用程序版本和处理器架构兼容。

  • 你知道插件供应商所需的目录结构。插件同步会保留您上传的目录结构。

  • 如果插件需要许可证，则工作人员可以访问许可证服务器。

将插件文件上传到亚马逊 S3

将插件文件上传到与您的队列关联的任务附件 Amazon S3 存储桶。使用以下前缀：

s3://<job-attachments-bucket>/<root-prefix>/plugins/<os>/<dcc-name>/<dcc-version>/
重要

Amazon S3 前缀区分大小写。操作系统和 DCC 文件夹名称使用小写。

按如下方式替换变量：

<job-attachments-bucket>

与您的队列关联的任务附件存储桶。队列详细信息页面显示存储桶。

<root-prefix>

您的队列的作业附件根前缀。队列详细信息页面显示前缀。

<os>

工作器操作系统，可以linux是windows。

<dcc-name>

支持的应用程序表中的确切文件夹名称。

<dcc-version>

支持的应用程序表中的版本文件夹。例如，Maya 2025.3 使用2025，Blender 5.1 使用。5.1

例如，Linux 上的 Maya 2025 插件的前缀是：

s3://<job-attachments-bucket>/<root-prefix>/plugins/linux/maya/2025/
使用 Amazon S3 控制台上传插件文件

  1. 打开 Deadline Cloud 控制台，然后打开队列详细信息页面。

  2. 选择任务附件存储桶链接，在 Amazon S3 控制台中打开存储桶。

  3. 打开队列的根前缀。

  4. 创建前缀plugins/<os>/<dcc-name>/<dcc-version>/。例如，用plugins/linux/maya/2025/于 Maya 2025。

  5. 将插件文件和目录上传到版本前缀。保留插件供应商所需的目录结构。

验证插件交付

验证插件同步是否传送了文件

  1. 提交一份选择支持的 DCC 包和版本的作业。

  2. 在 De AWS adline Cloud 监视器（Deadline Cloud 监视器）中，打开任务的会话日志。

  3. 在会话日志中搜索Plugin Sync:。确认日志显示了预期的 Amazon S3 前缀和目标。

  4. 在任务日志中确认应用程序已加载插件。消息取决于应用程序和插件。

支持插件同步的应用程序

下表列出了包含插件同步脚本的应用程序和版本。它还可以确定 GitHub 网站上是否有 conda 配方示例，以及服务管理车队的deadline-cloud频道是否包含这些脚本。

DCC 应用程序 S3 文件夹名称 版本文件夹 工作器操作系统 康达食谱样本 Service-managed 舰队套餐
Blender blender 5.0, 5.1 Linux 支持 是
Autodesk Maya maya 2024, 2025, 2026, 2027 Linux 支持 是
Foundry Nuke nuke 15.0, 16.0, 17.0 Linux 支持 是
SideFX Houdini houdini 19.5, 20.0, 20.5, 21.0, 22.0 Linux 支持 是
Maxon Cinema 4D cinema4d Linux: 2024.5.1 2025.3.1、和2026.3.4；Windows：2025.3.3和 2026.3.4 2024 年：Linux；2025 年和 2026 年：Linux 和 Windows 支持 是
Adobe After Effects aftereffects 25.6或25.6.4；26.0或 26.0.0 Windows 支持 是

如果您的应用程序或版本未出现在表中，请参阅Package 一个插件或使用队列环境配置作业，或者使用客户管理的队列。 GitHub 网站上的 conda 配方示例包括插件同步脚本，您可以在自托管频道中使用这些脚本。