View a markdown version of this page

Parámetros, valores y elementos para paquetes de trabajos - Deadline Cloud

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.

Parámetros, valores y elementos para paquetes de trabajos

Puede usar el archivo de parámetros para establecer los valores de algunos de los parámetros del trabajo de la plantilla de trabajo o de los argumentos de solicitud de CreateJob operación del paquete de trabajos, de modo que no necesite establecer valores al enviar un trabajo. La interfaz de usuario para enviar trabajos te permite modificar estos valores.

Puede definir la plantilla de trabajo en formato YAML (parameter_values.yaml) o JSON (parameter_values.json). Los ejemplos de esta sección se muestran en formato YAML.

En YAML, el formato del archivo es:

parameterValues:
- name: <string>
  value: <integer>, <float>, or <string>
- name: <string>
  value: <integer>, <float>, or <string>ab
... repeating as necessary

Cada elemento de la parameterValues lista debe ser uno de los siguientes:

  • Un parámetro de trabajo definido en la plantilla de trabajo.

  • Parámetro de trabajo definido en un entorno de cola para la cola a la que se envía el trabajo.

  • Un parámetro especial que se transfiere a la CreateJob operación al crear un trabajo.

    • deadline:priority— El valor debe ser un entero. Se pasa a la CreateJob operación como parámetro de prioridad.

    • deadline:targetTaskRunStatus— El valor debe ser una cadena. Se pasa a la CreateJob operación como TaskRunStatus parámetro de destino.

    • deadline:maxFailedTasksCount— El valor debe ser un entero. Se pasa a la CreateJob operación como FailedTasksCount parámetro máximo.

    • deadline:maxRetriesPerTask— El valor debe ser un entero. Se pasa a la CreateJob operación como RetriesPerTask parámetro máximo.

    • deadline:maxWorkerCount— El valor debe ser un entero. Se pasa a la CreateJob operación como WorkerCount parámetro máximo.

Una plantilla de trabajo es siempre una plantilla y no un trabajo específico para ejecutar. Un archivo de valores de parámetros permite que un paquete de trabajos actúe como plantilla si algunos parámetros no tienen valores definidos en este archivo, o como envío de trabajos específicos si todos los parámetros tienen valores.

Por ejemplo, la muestra de blender_render no tiene un archivo de parámetros y su plantilla de trabajo define los parámetros sin valores predeterminados. Esta plantilla debe usarse como plantilla para crear trabajos. Después de crear un trabajo con este paquete de trabajos, Deadline Cloud escribe un nuevo paquete de trabajos en el directorio del historial de trabajos.

Por ejemplo, cuando envías un trabajo con el siguiente comando:

deadline bundle gui-submit blender_render/

El nuevo paquete de trabajos contiene un parameter_values.yaml archivo que contiene los parámetros especificados:

% cat ~/.deadline/job_history/\(default\)/2024-06/2024-06-20-01-JobBundle-Demo/parameter_values.yaml
parameterValues:
- name: deadline:targetTaskRunStatus
  value: READY
- name: deadline:maxFailedTasksCount
  value: 10
- name: deadline:maxRetriesPerTask
  value: 5
- name: deadline:priority
  value: 75
- name: BlenderSceneFile
  value: /private/tmp/bundle_demo/bmw27_cpu.blend
- name: Frames
  value: 1-10
- name: OutputDir
  value: /private/tmp/bundle_demo/output
- name: OutputPattern
  value: output_####
- name: Format
  value: PNG
- name: CondaPackages
  value: blender
- name: RezPackages
  value: blender

Puede crear el mismo trabajo con el siguiente comando:

deadline bundle submit ~/.deadline/job_history/\(default\)/2024-06/2024-06-20-01-JobBundle-Demo/
nota

El paquete de trabajos que envíe se guarda en su directorio de historial de trabajos. Puede encontrar la ubicación de ese directorio con el siguiente comando:

deadline config get settings.job_history_dir