Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ganchos, eventos y puntos de integración para puestos de trabajo
Deadline Cloud ofrece varios *puntos de integración* en los que puedes ejecutar tu propia lógica en torno a un trabajo. Un punto de integración es un punto del ciclo de vida laboral en el que Deadline Cloud ejecuta un código personalizado o cede el control a un servicio que tú configuras, como un script que prepara a un trabajador o una regla que reacciona ante un evento laboral. Los puntos de integración se utilizan para adaptar Deadline Cloud a su proceso de producción: para instalar software, establecer variables de entorno, validar o cambiar un trabajo, procesar los resultados o activar la automatización posterior.
Los puntos de integración difieren en tres aspectos:
+ **Dónde se ejecuta el código**: en su estación de trabajo, en el trabajador o en la AWS nube.
+ **Cuándo se ejecuta**: en el momento de la presentación, antes o después del trabajo, o en respuesta a un evento.
+ **Dónde lo configure**: en una estación de trabajo, en un paquete de tareas, en una cola o en una propiedad de una flota, o en su propia cuenta AWS .
El siguiente diagrama muestra dónde se ejecuta cada punto de integración durante el ciclo de vida del trabajo. El control va desde la presentación en la estación de trabajo, pasando por la ejecución por parte de los trabajadores, hasta la automatización basada en eventos en su cuenta. AWS
+ **Estación de trabajo**: los enlaces del remitente y los scripts de configuración del host se ejecutan una vez.
+ **Trabajador**: los entornos de colas, trabajos y pasos utilizan acciones de entrada y salida relacionadas con la sesión. La ejecución de tareas ejecuta su trabajo. Los pasos dependientes se ejecutan una vez finalizada la tarea.
+ **AWS cuenta**: EventBridge los eventos, CloudWatch las métricas y las alarmas responden de forma asíncrona a los cambios de estado.
En la siguiente tabla se resumen los puntos de integración. Elija uno en función de las respuestas a las preguntas anteriores. En las secciones que siguen a la tabla se describe cada opción y se enlaza con instrucciones detalladas.
| Punto de integración | Se ejecuta | Configurado en | Cuando se ejecuta | Úselo para |
| --- | --- | --- | --- | --- |
| Ganchos para remitentes | Estación de trabajo | Configuración de estación de trabajo (todos los trabajos) o un paquete de trabajos | Durante el envío, antes de que se cree el trabajo | Inserte o anule variables de entorno, valide o reescriba un paquete de trabajos, sincronícelo con el software de seguimiento de la producción en el momento de enviarlo |
| Aloje los scripts de configuración | Entorno de trabajo | Propiedad de flota (flota gestionada por el servicio) | Una vez por trabajador, al inicio, con privilegios de administrador | Configuración de red: instalación de software que necesita privilegios elevados |
| Entornos de colas | Entorno de trabajo | Propiedad de cola | Al entrar o salir de una sesión, para cada trabajo de la cola | Project-level configuración: instalaciones de software ajenas a la administración, variables de entorno compartidas, configuración de licencia o daemon |
| Entornos de trabajo | Entorno de trabajo | Paquete de trabajos o plantilla de trabajo | Antes y después de un trabajo | Per-job configuración y desmontaje |
| Ambientes escalonados | Entorno de trabajo | Paquete de trabajos o plantilla de pasos | Antes y después de un paso | Per-step configuración y desmontaje |
| Pasos dependientes | Entorno de trabajo | Paquete de tareas o plantilla de pasos (`dependsOn`) | Tras un paso anterior, el mismo trabajo se realiza correctamente | Post-render trabajo que necesita los archivos de salida de forma local, como codificar fotogramas en una película o generar miniaturas |
| Eventos de Amazon EventBridge (EventBridge) | AWS Nube | Tu AWS cuenta (regla y objetivo) | En caso de un cambio de trabajo, paso, tarea, flota o presupuesto | Seguimiento de la producción, notificaciones, automatización en la nube, encadenamiento de tareas entre colas |
| Métricas y alarmas de Amazon CloudWatch (CloudWatch) | AWS Nube | Tu AWS cuenta | Continuamente, por encima de un umbral | Condiciones que no tienen ningún evento, como la disponibilidad de licencias (`LicensesInUse`) y la capacidad de la flota |
## Ejecute una lógica personalizada en la estación de trabajo
Los enlaces del remitente se ejecutan durante el envío, antes de que el trabajo llegue al servicio. Los configura por estación de trabajo, donde se aplican a todos los trabajos enviados desde esa estación de trabajo, o dentro de un paquete de trabajos, donde se aplican a ese paquete. El remitente puede modificar el paquete en diferentes puntos del flujo de envío. Úselos para introducir variables de entorno, validar un envío o sincronizarlo con el software de seguimiento de la producción en el momento del envío.
Para obtener más información, consulte [Ganchos de presentación](submission-hooks.md).
## Ejecute una lógica personalizada en el trabajador
Los siguientes puntos de integración se ejecutan en el host de renderizado. Están anidados desde el ámbito más amplio hasta el más estrecho:
+ **Los scripts de configuración del host** se ejecutan una vez cuando se inicia un trabajador, con privilegios de administrador. Los scripts de configuración del host son específicos de las flotas gestionadas por servicios (SMF). En una flota gestionada por el cliente (CMF), usted crea su propia imagen. Utilice los scripts de configuración del host para la configuración de la red y las instalaciones de software a nivel de administrador.
+ Cada uno de los **entornos de colas, tareas y escalones define y actúa.** `onEnter` `onExit` Las acciones se ejecutan cuando la sesión del trabajador entra en un ámbito y, en orden inverso, cuando la sesión sale del ámbito. Los entornos de colas son un buen lugar para la configuración a nivel de proyecto que se aplica a todos los trabajos de una cola, como el software compartido, las variables de entorno y la configuración de licencias o demonios. Los entornos de trabajo y paso reducen el alcance a un solo trabajo o paso.
+ **Los pasos dependientes** añaden un segundo paso `dependsOn` que suele depender del paso de renderizado. Por ejemplo, puede renderizar y, a continuación, codificar una película, o renderizar y, a continuación, generar miniaturas. El paso permanece en el mismo trabajo, por lo que las salidas ya son locales. Los pasos dependientes requieren un remitente personalizado o un paquete de trabajos escritos a mano. Job-to-job las dependencias no son nativas. Para encadenar tareas independientes, utilice eventos en la nube, tal y como se describe en la siguiente sección.
**nota**
Los entornos dependen de la sesión, no de cada tarea. Una `onExit` acción se ejecuta al desarmar la sesión, no después de cada tarea. Si vas a migrar una llamada posterior a una tarea de Deadline 10, utiliza un paso dependiente en lugar de una acción de entorno. `onExit`
Para obtener más información, consulte los siguientes temas:
+ [Ejecute scripts de configuración del host con privilegios de administrador](smf-admin.md)
+ [Cree un entorno de colas](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-queue-environment.html)
+ [Presente las solicitudes para sus puestos de trabajo](provide-applications.md)
+ [Dependencias escalonadas](build-jobs-scheduling.md#jobs-scheduling-dependencies)
+ [Abra los esquemas de plantillas de descripción del trabajo](https://github.com/OpenJobDescription/openjd-specifications/wiki/2023-09-Template-Schemas) en el GitHub sitio web, para `onEnter` y su alcance `onExit`
## Responda a los eventos en la nube
EventBridge y le CloudWatch permiten reaccionar ante la actividad laboral sin consumir la capacidad de la granja. Úselos cuando su lógica responda a los resultados del trabajo en lugar de correr como parte de un trabajo.
+ Deadline Cloud envía los eventos con la fuente `aws.deadline` al bus de eventos predeterminado de tu AWS cuenta. Los eventos incluyen los cambios de estado de las tareas, los pasos y las tareas, las recomendaciones sobre el tamaño de la flota y los umbrales presupuestarios. Eres el propietario de la regla, de la función AWS Lambda (Lambda) y de la cola de cartas muertas (DLQ). Conecta una regla a una función de Lambda para notificaciones, registro de activos o para encadenar trabajos entre colas (evento a Lambda o () a). `CreateJob` La entrega es lo mejor y los eventos pueden llegar fuera de orden, así que haga que sus clientes sean idempotentes y configure los reintentos y un DLQ.
+ CloudWatch las métricas y las alarmas cubren condiciones que EventBridge no lo hacen, y lo que es más importante, la disponibilidad de las licencias y la capacidad de la flota. No existe ningún evento relacionado con la disponibilidad de las licencias, por lo que hay que preocuparse por la `LicensesInUse` métrica y limitar el número de licencias. El `Fleet Size Recommendation Change` evento y la `RecommendedFleetSize` métrica también impulsan el escalado automático de la flota gestionada por el cliente.
Para obtener más información, consulte los siguientes temas:
+ [Gestión de eventos de Deadline Cloud mediante Amazon EventBridge](eventbridge-integration.md)
+ [Referencia detallada de los eventos de Deadline Cloud](events-detail-reference.md)
+ [CloudWatch métricas](cloudwatch-metrics.md)
+ [Cree una infraestructura de flota con un grupo de Amazon EC2 Auto Scaling](create-auto-scaling.md)
+ [Los eventos de Deadline Cloud figuran](https://docs.aws.amazon.com/eventbridge/latest/ref/events-ref-deadline.html) *en la referencia de EventBridge servicios*
+ *La [invocación asíncrona en](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) la Guía para desarrolladores de Lambda*
+ [Política de reintentos de eventos y uso de colas con letra muerta en la Guía](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-retry-policy.html) *del usuario EventBridge *
## Elija un punto de integración
Utilice las siguientes instrucciones para elegir un punto de integración para una necesidad común:
+ Para cambiar un trabajo antes de enviarlo, usa un enlace de remitente.
+ Para ejecutar la lógica en el host de renderizado de la obra, usa un script de configuración del host o un entorno de colas, trabajos o pasos. Elija el ámbito más amplio que se adapte y utilice un entorno de colas para la configuración a nivel de proyecto.
+ Para procesar los resultados de los trabajos mientras aún son locales, utilice un paso dependiente.
+ Para reaccionar ante los resultados del trabajo sin consumir la capacidad de la granja, utilice una EventBridge regla con una función Lambda.
+ Para condiciones que no tengan ningún evento, como los límites de licencia o capacidad, utilice una CloudWatch alarma.
## Recursos adicionales
Para ver conceptos relacionados y material de referencia, consulte lo siguiente:
+ [Cree trabajos para enviarlos a Deadline Cloud](building-jobs.md)
+ [Configure los trabajos mediante entornos de colas](configure-jobs.md)
+ [Supervisión de AWS Deadline Cloud](monitoring-overview.md)