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.
Descargas automáticas
La CLI de Deadline proporciona un comando para descargar el resultado de todas las tareas de una cola que se hayan completado desde la última vez que se ejecutó el mismo comando. Puede configurarlo como un trabajo cron o una tarea programada para que se ejecute de forma repetida. Esta configuración configura la descarga automática de los resultados de forma continua.
Antes de configurar las descargas automáticas, siga los pasos que se indican en los perfiles de almacenamiento de los archivos adjuntos de tareas para configurar todas las rutas de carga y descarga de los datos de los activos. Si un trabajo usa una ruta de salida que no está en su perfil de almacenamiento, la descarga automática omite la descarga de esa salida e imprime mensajes de advertencia para resumir los archivos que no descargó. Del mismo modo, si se envía un trabajo sin un perfil de almacenamiento, la descarga automática omite ese trabajo e imprime un mensaje de advertencia. De forma predeterminada, los remitentes de Deadline Cloud muestran mensajes de advertencia sobre las rutas que se encuentran fuera de los perfiles de almacenamiento para ayudar a garantizar una configuración correcta.
Configuración AWS credentials
Las descargas automáticas utilizan la CLI de Deadline para descargar de forma continua los resultados de los trabajos. Para autenticar estas descargas, necesita credenciales de IAM de larga duración. Las credenciales de Deadline Cloud Monitor caducan, por lo que no puede usarlas para este propósito.
Siga los pasos que se indican a continuación para configurar las credenciales a largo plazo.
importante
Preste atención a las siguientes advertencias:
-
NO utilices las credenciales raíz de tu cuenta para acceder a AWS los recursos. Estas credenciales proporcionan acceso ilimitado a la cuenta y son difíciles de revocar.
-
NO incluya claves de acceso literales ni información sobre credenciales en sus archivos de aplicación. Si lo hace, puede crear un riesgo de exposición accidental de sus credenciales si, por ejemplo, carga el proyecto en un repositorio público.
-
NO incluya archivos que contengan credenciales en el área del proyecto.
-
Proteja sus claves de acceso. No proporcione sus claves de acceso a terceros no autorizados, ni siquiera para que le ayuden a buscar sus identificadores de cuenta. De este modo, puedes dar a alguien acceso permanente a tu cuenta.
-
Tenga en cuenta que las credenciales almacenadas en el archivo de AWS credenciales compartidas se almacenan en texto sin formato.
Para obtener más información, consulte las prácticas recomendadas para administrar las claves de AWS acceso en la Referencia AWS general.
Creación de un usuario de IAM
Abra la consola de IAM en https://console.aws.amazon.com/iam/
. -
En el panel de navegación, seleccione Usuarios y, a continuación, seleccione Crear usuario.
-
Asigne un nombre al usuario
deadline-output-downloader. Desactive la casilla de verificación Proporcionar acceso a los usuarios al y, a continuación Consola de administración de AWS, seleccione Siguiente. -
Seleccione Asociar políticas directamente.
-
Seleccione Crear política para crear una política personalizada con los permisos mínimos requeridos.
-
En el editor JSON, especifica los siguientes permisos:
-
Asigne un nombre a la política
DeadlineCloudOutputDownloadPolicyy elija Crear política. -
Vuelva a la página de creación de usuarios, actualice la lista de políticas, seleccione la DeadlineCloudOutputDownloadPolicy que acaba de crear y, a continuación, elija Siguiente.
-
Revise los detalles del usuario y, a continuación, elija Crear usuario.
Creación de una clave de acceso
-
En la página de detalles del usuario, selecciona la pestaña Credenciales de seguridad. En la sección Claves de acceso, haga clic en Crear clave de acceso.
-
Indica que quieres usar la clave para Otros, selecciona Siguiente y, a continuación, elige Crear clave de acceso.
-
En la página Recuperar claves de acceso, selecciona Mostrar para ver el valor de la clave de acceso secreta de tu usuario. Puede copiar las credenciales o descargar un archivo .csv.
Guarde las claves de acceso de los usuarios
-
Guarde las claves de acceso de los usuarios en el archivo de AWS credenciales de su sistema:
-
SíLinux, el archivo se encuentra en
~/.aws/credentials -
SíWindows, el archivo se encuentra en
%USERPROFILE%\.aws\credentials
Sustituya las siguientes claves:
[deadline-downloader] aws_access_key_id=ACCESS_KEY_IDaws_secret_access_key=SECRET_ACCESS_KEYregion=YOUR_AWS_REGION -
importante
Cuando ya no necesites este usuario de IAM, te recomendamos que lo elimines para adaptarlo a las prácticas recomendadas AWS de seguridad. Le recomendamos que exija a sus usuarios humanos que utilicen credenciales temporales AWS IAM Identity Center al acceder AWS.
Requisitos previos
Complete los siguientes pasos antes de crear un trabajo cron o una tarea programada para su descarga automática.
-
Si aún no lo has hecho, instala Python
desde el sitio web de Python. -
Instala la CLI de Deadline ejecutando:
python -m pip install deadline -
Confirme que la versión de la CLI de Deadline es 0.52.1 o posterior con el siguiente comando.
$ deadline --version deadline, version 0.52.1Para ver el estado de la descarga en el monitor de Deadline Cloud, usa la versión 0.60.4 o una posterior. Esa versión empezó a registrar el estado de descarga que lee el monitor. Para obtener más información, consulte Ver el estado de descarga de los resultados en Deadline Cloud.
Pruebe el comando de descarga de salida
Para comprobar que el comando funciona en su entorno
-
Obtenga la ruta a Deadline
-
Ejecuta el comando sync-output para arrancar.
/path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory \ -
Solo necesita realizar este paso si su máquina de descarga es la misma que la máquina de envío. Sustituya
--storage-profile-id YOUR_PROFILE_ID \lo anterior por--ignore-storage-profiles. -
Envía un trabajo de prueba.
-
Descargue el archivo.zip desde GitHub.
-
Abra el repositorio https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline
deadline-cloud-samples en el sitio web. GitHub -
Selecciona Código y, a continuación, en el menú desplegable, selecciona Descargar ZIP.
-
Descomprime el archivo descargado en un directorio local.
-
-
Ejecutar
cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output -
Ejecutar
deadline bundle submit .-
Si no tienes la configuración de fecha límite predeterminada, es posible que tengas que proporcionar lo siguiente en la línea de comandos.
--farm-idYOUR-FARM-ID--queue-idYOUR-QUEUE-ID
-
-
Espera a que se complete el trabajo antes de continuar con el siguiente paso.
-
-
Vuelva a ejecutar el comando sync-output.
/path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory -
Compruebe lo siguiente:
-
Los resultados del trabajo de prueba aparecen en el directorio de destino.
-
Se crea un archivo de puntos de control en el directorio de puntos de control especificado.
-
Configure las descargas programadas
Selecciona la pestaña de tu sistema operativo para aprender a configurar las descargas automáticas para cada 5 minutos.
Verificar la configuración
Para comprobar que la configuración de las descargas automáticas se ha realizado correctamente, siga estos pasos.
-
Envía un nuevo trabajo de prueba.
-
Espere a que se complete un intervalo del programador, que en este caso es de 5 minutos.
-
Compruebe que las nuevas salidas se descarguen automáticamente.
Si las salidas no se descargan, consulte la sección de solución de problemas para ver los registros del proceso.
Solución de problemas de descargas automáticas
Si tienes problemas con las descargas automáticas, comprueba lo siguiente:
Códigos de error de descarga
Cuando se produce un error en una descarga, en la columna de estado de descarga del monitor Deadline Cloud se indica el motivo y el deadline queue sync-output comando registra uno de los siguientes códigos de error. La mayoría de estos errores se resuelven en el equipo en el que se ejecuta el comando de descarga, que suele ser un equipo diferente del equipo en el que se ve el monitor.
PERMISSION_DENIED(Permiso denegado)-
El descargador no puede escribir en la ubicación de salida o se ha denegado el acceso a sus AWS credenciales. Conceda al usuario que ejecute el comando de descarga acceso de escritura a la ubicación de salida, confirme que el AWS perfil del comando tiene acceso a la cola y vuelva a ejecutar el comando.
DISK_FULL(Disco lleno)-
El equipo que ejecutaba la descarga se quedó sin espacio en disco. Libere espacio en la unidad que contiene la ubicación de salida y, a continuación, vuelva a ejecutar el comando.
PATH_NOT_FOUND(No se encontró la ruta)-
El destino de salida no existe o no está montado en la máquina que ejecuta la descarga. Crea el directorio o monta la unidad compartida y, a continuación, vuelve a ejecutar el comando.
NETWORK_ERROR(Error de red)-
Una interrupción de la red detuvo la transferencia. Los errores de red suelen ser transitorios. Vuelva a ejecutar el comando y compruebe la conectividad de la máquina si el error se repite.
UNKNOWN(Falló)-
El descargador no pudo identificar una causa específica. En el monitor aparece el mensaje Fallo para este código y para cualquier código que no reconozca. Compruebe el resultado del registro del
deadline queue sync-outputcomando para ver si hay un error subyacente.
Un trabajo cuya descarga produce un error se vuelve a intentar automáticamente cada vez que se ejecuta más adelante. Tras cinco intentos fallidos, el descargador deja de volver a intentar la tarea e imprime una advertencia. Tras solucionar la causa, recupere el trabajo ejecutando el comando de descarga con una ventana retrospectiva que muestra cuándo finalizó el trabajo:
deadline queue sync-output --farm-idFARM_ID--queue-idQUEUE_ID\ --storage-profile-idSTORAGE_PROFILE_ID\ --force-bootstrap --bootstrap-lookback-minutes1440
Pase ambas banderas juntas. La --bootstrap-lookback-minutes opción por defecto es 0, por lo que por sí --force-bootstrap sola no recupera nada.
¿Por qué se saltó mi trabajo?
Cuando el descargador omite un trabajo, la columna de estado de la descarga indica el motivo directamente en la celda:
- Sin archivos adjuntos ()
no_attachments -
El trabajo no se envió con los archivos adjuntos del trabajo, por lo que no tiene ningún archivo de salida grabado para descargar. Algunos trabajos nunca producen resultados descargables, por lo que un trabajo omitido sin archivos adjuntos no suele requerir ninguna acción.
- Falta el perfil de almacenamiento ()
missing_storage_profile -
El trabajo se envió sin un perfil de almacenamiento, mientras que el comando de descarga usa uno, por lo que el descargador no sabe a qué lugar de cada máquina pertenecen los archivos del trabajo. No se descarga nada para el trabajo hasta que se haya configurado un perfil de almacenamiento para ello. El perfil de almacenamiento de un trabajo se establece cuando se envía el trabajo, así que envíe el trabajo con un perfil de almacenamiento y pase el mismo perfil al comando de descarga. En la tabla de tareas, el estado del perfil de almacenamiento faltante es un enlace que abre una explicación, un enlace a la documentación y un botón para solucionar problemas con IA. Para obtener más información, consulte Perfiles de almacenamiento para archivos adjuntos de trabajos.
Un trabajo omitido sin mostrar ningún motivo se canceló o detuvo antes de generar resultados. No necesita ninguna acción.
¿Es un problema de descarga o de renderizado?
Un problema en la columna de estado de descarga de una tarea puede tener dos significados diferentes y tener soluciones diferentes. El texto de estado te indica cuál tienes:
-
La ausencia de resultados en una tarea cuyo estado de ejecución es
FAILEDsignifica que la tarea no se pudo procesar en la granja. Nunca se produjo ningún archivo, por lo que no había nada que descargar. Su disco y su red funcionan bien. Revisa los registros de la tarea para encontrar el error de renderizado, corregirlo y volver a poner la tarea en cola. Una tarea también puede mostrar Sin resultados una vez finalizada correctamente sin escribir ningún archivo, lo cual es normal y no requiere ninguna acción. -
Un nombre de error, como Permiso denegado, significa que la tarea se ha procesado y su resultado existe y que no se han podido copiar los archivos al sistema de archivos. Resuelva el error utilizandoCódigos de error de descarga.
En la tabla de trabajos, ambos problemas aparecen como un segmento rojo en la barra de progreso de la descarga del trabajo. Abre la tabla de tareas del trabajo para diferenciarlos. Un trabajo en el que todas las tareas fallaron muestra un guión en lugar de un error de descarga, porque el trabajo nunca produjo resultados. La propia columna de estado del trabajo informa de ese error. Diagnosticar la descarga en estos casos de errores de renderización es una pérdida de tiempo, así que compruebe siempre primero el estado de ejecución de la tarea.
Solucione problemas con IA
Los mensajes de error de descarga que aparecen en el monitor de Deadline Cloud, incluido el indicador rojo de error en la sincronización de salida, incluyen un botón para solucionar problemas con IA. Este botón abre el asistente de Deadline Cloud, que lee el registro del estado de las descargas de tu lista de espera y te explica cuál ha sido el error específico, incluidos los comandos que debes ejecutar para solucionarlo.
Utilízalo cuando la descarga sigue fallando después de intentar solucionar el código de error, cuando veas un error que no reconozcas o cuando no estés seguro de en qué equipo se encuentra el problema. El botón aparece cuando el asistente de Deadline Cloud está activado en el monitor. Para obtener más información, consulte Asistente Deadline Cloud.
Problemas con el perfil de almacenamiento
-
Un error similar al que
[Errno 2] No such file or directoryaparece[Errno 13] Permission denieden el archivo de registro puede estar relacionado con la falta de perfiles de almacenamiento o con una configuración incorrecta. -
Consulte Perfiles de almacenamiento para obtener información sobre cómo configurar los perfiles de almacenamiento cuando la máquina de descarga es diferente de la máquina de envío.
-
Para descargas realizadas desde la misma máquina, prueba con la
--ignore-storage-profilesbandera.
Permisos de directorio
-
Asegúrese de que el usuario del servicio de programación tenga:
-
Read/write acceso al directorio de puntos de control
-
Acceso de escritura al directorio de destino de salida
-
-
Para Linux ymacOS, utilícelo
ls -lapara comprobar los permisos. -
ParaWindows, revise la configuración de seguridad en la carpeta Propiedades.