任務範本的任務區塊

任務區塊可讓您將多個任務分組為稱為區塊的單一工作單位。例如，在轉譯任務中，這表示截止日期雲端可以將多個影格一起分派，而不是每個命令叫用一個影格。這可降低每個任務啟動應用程式的負荷，並縮短總任務執行時間。如需詳細資訊，請參閱 OpenJD Wiki 中的一次執行多個影格。

OpenJD 支援擴充功能，可將選用功能新增至任務範本。新增 TASK_CHUNKING延伸來啟用任務區塊。若要使用區塊，請將延伸模組新增至您的任務範本，並使用CHUNK[INT]任務參數類型。使用相同的deadline bundle submit命令提交區塊任務。例如，下列任務範本會以 10 的區塊轉譯影格：

specificationVersion: 'jobtemplate-2023-09'
extensions:
  - TASK_CHUNKING
name: Blender Render with Contiguous Chunking
parameterDefinitions:
  - name: BlenderSceneFile
    type: PATH
    objectType: FILE
    dataFlow: IN
  - name: Frames
    type: STRING
    default: "1-100"
  - name: OutputDir
    type: PATH
    objectType: DIRECTORY
    dataFlow: OUT
    default: "./output"
steps:
  - name: RenderBlender
    parameterSpace:
      taskParameterDefinitions:
        - name: Frame
          type: CHUNK[INT]
          range: "{{Param.Frames}}"
          chunks:
            defaultTaskCount: 10
            rangeConstraint: CONTIGUOUS
    script:
      actions:
        onRun:
          command: bash
          args: ["{{Task.File.Run}}"]
      embeddedFiles:
        - name: Run
          type: TEXT
          data: |
            set -xeuo pipefail
            
            mkdir -p '{{Param.OutputDir}}'
            
            # Parse the chunk range (e.g., "1-10") into start and end frames
            START_FRAME="$(echo '{{Task.Param.Frame}}' | cut -d- -f1)"
            END_FRAME="$(echo '{{Task.Param.Frame}}' | cut -d- -f2)"
            
            blender --background '{{Param.BlenderSceneFile}}' \
                    --render-output '{{Param.OutputDir}}/output_####' \
                    --render-format PNG \
                    --use-extension 1 \
                    -s "$START_FRAME" \
                    -e "$END_FRAME" \
                    --render-anim

在此範例中，Deadline Cloud 會將 100 個影格分成 1-10、 11-20等區塊。{{Task.Param.Frame}} 變數會展開至範圍表達式，例如 1-10。因為 rangeConstraint 設為 CONTIGUOUS，所以範圍一律為 start-end 格式。指令碼剖析此範圍，並使用 -s和 -e選項將開始和結束影格傳遞給 Blender--render-anim。

chunks 屬性支援下列欄位：

如需更多任務區塊範例，包括具有連續和非連續區塊的基本和 Blender 範例，請參閱 GitHub 上截止日期雲端範例儲存庫中的任務區塊範例。