View a markdown version of this page

プラグイン同期を使用してカスタムプラグインを配信する - Deadline クラウド

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

プラグイン同期を使用してカスタムプラグインを配信する

プラグイン同期は、conda パッケージを構築することなく、カスタムプラグインとアドオンを提供します。プラグインファイルをキューのジョブアタッチメントバケットの所定のプレフィックスにアップロードします。ジョブがサポートされているアプリケーションパッケージを使用する場合、パッケージはファイルをワーカーにコピーし、ロードするようにアプリケーションを設定します。

ファイルがアプリケーション検索パスにコピーされた後にプラグインを実行できる場合は、プラグイン同期を使用します。プラグインに依存関係解決、インストールコマンド、またはシステム変更が必要な場合は、 Deadline Cloud でカスタムプラグインを使用する に戻って別の配信方法を選択します。

プラグイン同期の仕組み

サポートされているデジタルコンテンツ作成 (DCC) conda パッケージは、プラグイン同期のアクティベーションスクリプトと非アクティブ化スクリプトを使用します。ワーカーセッションごとに次のイベントが発生します。

  1. キュー環境は、ジョブによって選択された DCC とアダプターパッケージを含む conda 環境を作成します。

  2. conda が環境をアクティブ化すると、DCC パッケージのプラグイン同期スクリプトは、セッション環境からジョブアタッチメントバケットとルートプレフィックスを読み取ります。

  3. このスクリプトは、Amazon S3 のオペレーティングシステム、DCC、および DCC バージョンプレフィックスからファイルをダウンロードします。次に、アプリケーション固有の環境変数を設定するか、ファイルをアプリケーションプラグインディレクトリにコピーします。

  4. セッションが終了すると、非アクティブ化スクリプトはダウンロードしたプラグインファイルと設定を削除します。次のセッションは、パッケージ化された DCC 環境から開始されます。

スクリプトは、 で始まるメッセージをセッションログPlugin Sync:に書き込みます。これらのメッセージを使用して、処理されたソースプレフィックス、送信先、およびファイルを確認できます。

前提条件

プラグインをアップロードする前に、次の要件を確認してください。

  • アプリケーション、バージョン、ワーカーオペレーティングシステムは、サポートされているアプリケーションテーブルに表示されます。

  • プラグインファイルは、ワーカーオペレーティングシステム、アプリケーションバージョン、プロセッサアーキテクチャと互換性があります。

  • プラグインベンダーに必要なディレクトリ構造がわかっている。プラグイン同期は、アップロードしたディレクトリ構造を保持します。

  • プラグインにライセンスが必要な場合、ワーカーはライセンスサーバーに到達できます。

プラグインファイルを Amazon 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>/。たとえば、Maya 2025 plugins/linux/maya/2025/には を使用します。

  5. プラグインファイルとディレクトリをバージョンプレフィックスにアップロードします。プラグインベンダーが必要とするディレクトリ構造を保持します。

プラグイン配信の検証

プラグイン同期がファイルを配信したことを確認するには
  1. サポートされている DCC パッケージとバージョンを選択するジョブを送信します。

  2. AWS Deadline Cloud Monitor (Deadline Cloud Monitor) で、タスクのセッションログを開きます。

  3. セッションログで を検索しますPlugin Sync:。ログに、予想される Amazon S3 プレフィックスと送信先が表示されていることを確認します。

  4. アプリケーションがプラグインをロードしたことをタスクログで確認します。メッセージはアプリケーションとプラグインによって異なります。

プラグイン同期をサポートするアプリケーション

次の表に、プラグイン同期スクリプトを含むアプリケーションとバージョンを示します。また、GitHub ウェブサイトで conda recipe サンプルが利用可能かどうか、およびサービスマネージドフリートのdeadline-cloudチャネルにスクリプトが含まれているかどうかも識別します。

DCC アプリケーション S3 フォルダ名 バージョンフォルダ ワーカーオペレーティングシステム Conda レシピのサンプル サービスマネージドフリートパッケージ
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 はい はい

アプリケーションまたはバージョンがテーブルに表示されない場合は、プラグインをパッケージ化する「」または「」を参照するかキュー環境を使用してジョブを設定する、カスタマーマネージドフリートを使用します。GitHub ウェブサイトの conda recipe サンプルには、セルフホスト型チャネルで使用できるプラグイン同期スクリプトが含まれています。