View a markdown version of this page

Elementos de valores de parâmetros para pacotes de tarefas - Deadline Cloud

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Elementos de valores de parâmetros para pacotes de tarefas

Você pode usar o arquivo de parâmetros para definir os valores de alguns dos parâmetros do trabalho no modelo de trabalho ou nos argumentos da solicitação de CreateJob operação no pacote de trabalhos para que você não precise definir valores ao enviar um trabalho. A interface do usuário para envio de trabalhos permite que você modifique esses valores.

Você pode definir o modelo de trabalho no formato YAML (parameter_values.yaml) ou no formato JSON (parameter_values.json). Os exemplos nesta seção são mostrados no formato YAML.

Em YAML, o formato do arquivo é:

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

Cada elemento da parameterValues lista deve ser um dos seguintes:

  • Um parâmetro de trabalho definido no modelo de trabalho.

  • Um parâmetro de trabalho definido em um ambiente de fila para a fila para a qual você envia o trabalho.

  • Um parâmetro especial passado para a CreateJob operação ao criar um trabalho.

    • deadline:priority— O valor deve ser um número inteiro. Ele é passado para a CreateJob operação como parâmetro de prioridade.

    • deadline:targetTaskRunStatus— O valor deve ser uma string. Ele é passado para a CreateJob operação como TaskRunStatus parâmetro de destino.

    • deadline:maxFailedTasksCount— O valor deve ser um número inteiro. Ele é passado para a CreateJob operação como o FailedTasksCount parâmetro máximo.

    • deadline:maxRetriesPerTask— O valor deve ser um número inteiro. Ele é passado para a CreateJob operação como o RetriesPerTask parâmetro máximo.

    • deadline:maxWorkerCount— O valor deve ser um número inteiro. Ele é passado para a CreateJob operação como o WorkerCount parâmetro máximo.

Um modelo de trabalho é sempre um modelo em vez de um trabalho específico a ser executado. Um arquivo de valores de parâmetros permite que um pacote de trabalhos atue como um modelo se alguns parâmetros não tiverem valores definidos nesse arquivo ou como um envio de trabalho específico se todos os parâmetros tiverem valores.

Por exemplo, a amostra blender_render não tem um arquivo de parâmetros e seu modelo de trabalho define parâmetros sem valores padrão. Esse modelo deve ser usado como modelo para criar trabalhos. Depois de criar um trabalho usando esse pacote de tarefas, o Deadline Cloud grava um novo pacote de tarefas no diretório do histórico de tarefas.

Por exemplo, quando você envia um trabalho com o seguinte comando:

deadline bundle gui-submit blender_render/

O novo pacote de tarefas contém um parameter_values.yaml arquivo que contém os 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

Você pode criar o mesmo trabalho com o seguinte comando:

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

O pacote de tarefas que você envia é salvo em seu diretório de histórico de tarefas. Você pode encontrar a localização desse diretório com o seguinte comando:

deadline config get settings.job_history_dir