

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CHUNK[INT] 작업 파라미터 참조
<a name="build-job-bundle-chunking-reference"></a>

`CHUNK[INT]` 작업 파라미터 유형은 Deadline Cloud가 개별 값 대신 청크로 처리하는 정수 작업 파라미터를 정의합니다. 청크 작업 파라미터의 구조는 다음과 같습니다.

```
taskParameterDefinitions:
  - name: {{identifier}}
    type: CHUNK[INT]
    range: {{integer range expression}}
    chunks:
      defaultTaskCount: {{integer}}
      rangeConstraint: CONTIGUOUS | NONCONTIGUOUS
      targetRuntimeSeconds: {{integer}}
```

다음 테이블에 각 옵션이 설명되어 있습니다.


| Field | 필수 | 설명 | 
| --- | --- | --- | 
| range | 예 | 정수 목록 또는 "1-100" 또는와 같은 정수 범위 표현식으로 처리할 정수 값의 전체 집합입니다"1,3,7-20:2". 와 같은 작업 파라미터 참조를 수락합니다"{{Param.Frames}}". | 
| chunks.defaultTaskCount | 예 | 단일 청크로 결합할 값의 수입니다. 최대값은 150입니다. 와 같은 작업 파라미터 참조를 수락합니다"{{Param.ChunkSize}}". | 
| chunks.rangeConstraint | 예 | 각 청크의 모양입니다. 에서는 CONTIGUOUS모든 청크가와 같은 연속 범위입니다1-10. 를 사용하면 청크NONCONTIGUOUS는와 같은 임의의 집합일 수 있습니다1,3,7-10. | 
| chunks.targetRuntimeSeconds | 아니요 | 각 청크의 대상 런타임으로, 초 단위입니다. 설정된 경우 Deadline Cloud는 완료된 청크의 관찰된 런타임을 기반으로 청크 크기를 대상으로 조정합니다. 설정하지 않으면 모든 청크가 defaultTaskCount 값을 사용합니다. | 

`CHUNK[INT]` 유형에는 다음과 같은 제약 조건이 있습니다.
+ 작업 템플릿은 `TASK_CHUNKING`에 나열되어야 합니다`extensions`. 확장이 없으면 작업 생성이 실패하고 오류가 발생합니다. `The CHUNK[INT] task parameter requires the TASK_CHUNKING extension.` 
+ 단계의 파라미터 공간에는 최대 하나의 `CHUNK[INT]` 파라미터가 포함될 수 있습니다. 청크가 실행되면 다른 모든 작업 파라미터는 단일 값을 사용하고 청크 파라미터는 값 집합을 사용합니다.

단계의 스크립트에서 청크 파라미터의 `{{Task.Param.{{name}}}}` 변수는 정수 범위 표현식 문자열로 확장됩니다. `rangeConstraint: CONTIGUOUS`의 경우 표현식은 항상 `1-1` 또는와 같은 `{{start}}-{{end}}` 형식입니다`11-20`. `rangeConstraint: NONCONTIGUOUS`의 경우 표현식은와 같은 정수 범위 표현식일 수 있습니다`1-3,5,7-20:2`.

자세한 정보는 다음 자료를 참조하세요.
+ [RFC 0001: 작업 청킹](https://github.com/OpenJobDescription/openjd-specifications/blob/mainline/rfcs/0001-task-chunking.md) - GitHub의 Open Job Description 리포지토리에 있는 확장의 전체 사양입니다.
+ [작업 템플릿에 작업 청킹 추가](build-job-bundle-chunking-add.md) - 청킹을 사용하도록 작업 템플릿을 변환합니다.