View a markdown version of this page

Hooks, Ereignisse und Integrationspunkte für Jobs - Deadline Cloud
Führen Sie benutzerdefinierte Logik auf der Workstation ausFühren Sie benutzerdefinierte Logik auf dem Worker ausReagieren Sie auf Ereignisse in der CloudWählen Sie einen IntegrationspunktWeitere Ressourcen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Hooks, Ereignisse und Integrationspunkte für Jobs

Deadline Cloud bietet mehrere Integrationspunkte, an denen Sie Ihre eigene Logik rund um einen Job ausführen können. Ein Integrationspunkt ist ein Ort im Joblebenszyklus, an dem Deadline Cloud benutzerdefinierten Code ausführt oder die Steuerung an einen von Ihnen konfigurierten Dienst übergibt, z. B. ein Skript, das einen Worker vorbereitet, oder eine Regel, die auf ein Job-Ereignis reagiert. Sie verwenden Integrationspunkte, um Deadline Cloud an Ihre Produktionspipeline anzupassen: um Software zu installieren, Umgebungsvariablen festzulegen, einen Job zu validieren oder zu ändern, Ausgaben zu verarbeiten oder eine nachgelagerte Automatisierung auszulösen.

Die Integrationspunkte unterscheiden sich in drei Fragen:

  • Wo der Code ausgeführt wird — auf Ihrer Workstation, auf dem Worker oder in der AWS Cloud.

  • Wann er ausgeführt wird — bei der Einreichung, vor oder nach der Arbeit oder als Reaktion auf ein Ereignis.

  • Wo Sie es konfigurieren — in einer Workstation-Umgebung, in einem Auftragspaket, in einer Warteschlange, in einer Flotte oder in Ihrem eigenen AWS Konto.

Das folgende Diagramm zeigt, wo die einzelnen Integrationspunkte während des Job-Lebenszyklus ausgeführt werden. Die Steuerung reicht von der Einreichung auf der Workstation über die Worker-Ausführung bis hin zur ereignisgesteuerten Automatisierung in Ihrem AWS Konto.

  • Workstation — Submitter-Hooks und Host-Konfigurationsskripte werden einmal ausgeführt.

  • Worker — Warteschlangen-, Job- und Schrittumgebungen verwenden sitzungsbezogene Ein- und Austrittsaktionen. Durch die Ausführung von Aufgaben wird Ihre Arbeit gesteuert. Abhängige Schritte werden ausgeführt, nachdem die Aufgabe abgeschlossen ist.

  • AWS Konto — EventBridge Ereignisse, CloudWatch Messwerte und Alarme reagieren asynchron auf Statusänderungen.

Integrationspunkte für den Joblebenszyklus zwischen Workstation, Worker und Cloud.

In der folgenden Tabelle sind die Integrationspunkte zusammengefasst. Wählen Sie anhand der Antworten auf die vorherigen Fragen eine aus. In den Abschnitten nach der Tabelle werden die einzelnen Optionen beschrieben und es gibt Links zu detaillierten Anweisungen.

Integrationspunkt Läuft auf Konfiguriert in Wenn es läuft Verwenden Sie für

Hooks des Absenders

Arbeitsstation

Workstation-Konfiguration (alle Jobs) oder ein Job-Bundle

Während der Einreichung, bevor der Job erstellt wird

Fügen Sie Umgebungsvariablen ein oder überschreiben Sie sie, validieren Sie ein Auftragspaket oder schreiben Sie es neu, synchronisieren Sie es bei der Einreichung mit der Produktionsverfolgungssoftware

Skripten für die Host-Konfiguration

Worker

Eigentum an der Flotte (vom Service verwaltete Flotte)

Einmal pro Mitarbeiter, beim Start, mit Administratorrechten

Netzwerkkonfiguration, Installation von Software, für die erhöhte Rechte erforderlich sind

Umgebungen in Warteschlangen

Worker

Eigenschaft Queue

Wenn eine Sitzung beginnt oder beendet wird, für jeden Job in der Warteschlange

Project-level Konfiguration: Softwareinstallationen ohne Administratorrechte, gemeinsam genutzte Umgebungsvariablen, Lizenz- oder Daemon-Setup

Arbeitsumfeld

Worker

Jobpaket oder Jobvorlage

Vor und nach einem Job

Per-job Auf- und Abbau

Step-Umgebungen

Worker

Auftragspaket oder Schrittvorlage

Vor und nach einem Schritt

Per-step Aufbau und Abbau

Abhängige Schritte

Worker

Auftragspaket oder Schrittvorlage (dependsOn)

Nach einem früheren Schritt ist derselbe Job erfolgreich

Post-render Arbeiten, bei denen die Ausgabedateien lokal benötigt werden, z. B. das Kodieren von Einzelbildern in einen Film oder das Generieren von Miniaturbildern

Amazon EventBridge (EventBridge) -Ereignisse

AWS Wolke

Ihr AWS Konto (Regel und Ziel)

Bei einer Änderung des Status eines Auftrags, Schritts, einer Aufgabe, einer Flotte oder eines Budgets

Produktionsverfolgung, Benachrichtigungen, Cloud-Automatisierung, Verkettung von Aufträgen in Warteschlangen

Amazon CloudWatch (CloudWatch) -Metriken und Alarme

AWS Wolke

Ihr AWS Konto

Kontinuierlich, gegen einen bestimmten Schwellenwert

Bedingungen, für die es kein Ereignis gibt, wie z. B. die Verfügbarkeit von Lizenzen (LicensesInUse) und die Flottenkapazität

Führen Sie benutzerdefinierte Logik auf der Workstation aus

Submitter-Hooks werden während der Übermittlung ausgeführt, bevor der Job den Dienst erreicht. Sie konfigurieren sie pro Workstation, sodass sie für alle Jobs gelten, die von dieser Workstation aus eingereicht wurden, oder innerhalb eines Job-Bundles, wo sie für dieses Paket gelten. Submitter-Hooks können das Bundle an verschiedenen Stellen im Einreichungsprozess ändern. Verwenden Sie sie, um Umgebungsvariablen einzufügen, eine Einreichung zu validieren oder sie bei der Einreichung mit einer Software zur Produktionsverfolgung zu synchronisieren.

Weitere Informationen finden Sie unter Hooks für die Einreichung.

Führen Sie benutzerdefinierte Logik auf dem Worker aus

Die folgenden Integrationspunkte werden auf dem Renderhost ausgeführt. Sie sind vom breitesten bis zum engsten Bereich verschachtelt:

  • Host-Konfigurationsskripten werden einmal mit Administratorrechten ausgeführt, wenn ein Worker gestartet wird. Host-Konfigurationsskripts sind spezifisch für Service-Managed Fleets (SMFs). Bei einer kundenverwalteten Flotte (CMF) erstellen Sie stattdessen Ihr eigenes Image. Verwenden Sie Host-Konfigurationsskripten für die Netzwerkeinrichtung und Softwareinstallationen auf Administratorebene.

  • Warteschlangen-, Job- und Schrittumgebungen definieren onEnter jeweils Aktionen. onExit Die Aktionen werden ausgeführt, wenn die Sitzung des Workers in einen Bereich eintritt, und in umgekehrter Reihenfolge, wenn die Sitzung den Bereich verlässt. Warteschlangenumgebungen eignen sich gut für Konfigurationen auf Projektebene, die für jeden Job in einer Warteschlange gelten, wie z. B. gemeinsam genutzte Software, Umgebungsvariablen und Lizenz- oder Daemon-Setup. Job- und Step-Umgebungen schränken den Anwendungsbereich auf einen einzelnen Job oder Schritt ein.

  • Bei abhängigen Schritten wird ein zweiter Schritt hinzugefügt, der dependsOn früher vom Renderschritt abhängt. Sie können beispielsweise einen Film rendern und dann kodieren oder rendern und anschließend Miniaturansichten generieren. Der Schritt bleibt im selben Job, sodass die Ausgaben bereits lokal sind. Für abhängige Schritte ist ein benutzerdefinierter Absender oder ein handgeschriebenes Auftragspaket erforderlich. Job-to-job Abhängigkeiten sind nicht systemeigen. Verwenden Sie Ereignisse in der Cloud, um separate Jobs zu verketten, wie im folgenden Abschnitt beschrieben.

Anmerkung

Umgebungen sind sitzungsbezogen, nicht pro Aufgabe. Eine onExit Aktion wird beim Teardown der Sitzung ausgeführt, nicht nach jeder Aufgabe. Wenn Sie einen Rückruf nach Ablauf von Deadline 10 nach Ablauf der Aufgabe migrieren, verwenden Sie einen abhängigen Schritt anstelle einer Umgebungsaktion. onExit

Weitere Informationen finden Sie hier:

Reagieren Sie auf Ereignisse in der Cloud

EventBridge und CloudWatch ermöglichen es Ihnen, auf Arbeitsaktivitäten zu reagieren, ohne die Kapazität der Farm zu verbrauchen. Verwenden Sie sie, wenn Ihre Logik auf Arbeitsergebnisse reagiert, anstatt sie als Teil eines Jobs auszuführen.

  • Deadline Cloud sendet Ereignisse mit der Quelle aws.deadline an den Standard-Event-Bus in Ihrem AWS Konto. Zu den Ereignissen gehören Änderungen von Aufgaben, Stufen und Aufgabenstatus, Empfehlungen zur Flottengröße und Budgetschwellenwerte. Sie besitzen die Regel, die Funktion AWS Lambda (Lambda) und die Dead-Letter-Warteschlange (DLQ). Verknüpfen Sie eine Regel mit einer Lambda-Funktion für Benachrichtigungen, die Registrierung von Ressourcen oder die Verkettung von Jobs über Warteschlangen hinweg (Ereignis an Lambda oder () an). CreateJob Die Lieferung erfolgt nach bestem Wissen und Ereignisse können nicht in der richtigen Reihenfolge eintreffen. Sorgen Sie also dafür, dass Ihre Kunden idempotent sind, und konfigurieren Sie Wiederholungsversuche und eine DLQ.

  • CloudWatch Kennzahlen und Alarme decken Bedingungen ab, bei denen EventBridge dies nicht der Fall ist, vor allem die Verfügbarkeit von Lizenzen und die Flottenkapazität. Es gibt kein Ereignis für die Verfügbarkeit von Lizenzen, sodass Sie sich über die Anzahl der LicensesInUse Metriken und Limits informieren müssen. Das Fleet Size Recommendation Change Ereignis und die RecommendedFleetSize Metrik treiben auch die vom Kunden verwaltete auto Skalierung der Flotte voran.

Weitere Informationen finden Sie hier:

Wählen Sie einen Integrationspunkt

Verwenden Sie die folgenden Hinweise, um einen Integrationspunkt für einen allgemeinen Bedarf auszuwählen:

  • Verwenden Sie einen Submitter-Hook, um einen Job vor dem Absenden zu ändern.

  • Verwenden Sie ein Host-Konfigurationsskript oder eine Warteschlangen-, Job- oder Schrittumgebung, um Logik auf dem Render-Host rund um das Werk auszuführen. Wählen Sie den umfassendsten Anwendungsbereich, der passt, und verwenden Sie eine Warteschlangenumgebung für die Konfiguration auf Projektebene.

  • Verwenden Sie einen abhängigen Schritt, um Jobausgaben zu verarbeiten, solange sie noch lokal sind.

  • Verwenden Sie eine EventBridge Regel mit einer Lambda-Funktion, um auf Arbeitsergebnisse zu reagieren, ohne die Kapazität der Farm zu verbrauchen.

  • Verwenden Sie bei Bedingungen, für die es kein Ereignis gibt, wie z. B. Lizenz- oder Kapazitätsgrenzen, einen CloudWatch Alarm.

Weitere Ressourcen

Verwandte Konzepte und Referenzmaterial finden Sie im Folgenden: