1장. 빌드 구성

Build CR(사용자 정의 리소스)에서는 소스, 빌드 전략, 매개변수 값, 출력, 보존 매개변수 및 볼륨을 정의하여 빌드를 구성할 수 있습니다. Build CR을 사용하여 빌드 Pod를 구성할 수도 있습니다.

빌드 리소스는 네임스페이스 내에서 사용할 수 있습니다.

빌드를 구성하려면 Build 리소스 YAML 파일을 생성하여 OpenShift Container Platform 클러스터에 적용합니다.

1.1. 빌드의 구성 가능한 필드

Build CR(사용자 정의 리소스)에서 다음 필수 및 선택적 필드를 사용할 수 있습니다.

표 1.1. Build CR의 필수 필드
필드	설명
`apiVersion`	리소스의 API 버전을 지정합니다(예: `shipwright.io/v1beta1` ).
`kind`	리소스 유형을 지정합니다(예: `Build` ).
`메타데이터`	`Build` 리소스의 이름과 같이 사용자 정의 리소스 정의 인스턴스를 식별하는 메타데이터를 나타냅니다.
`spec.source`	소스 코드의 위치(예: Git 리포지토리 또는 소스 번들 이미지)를 나타냅니다.
`spec.strategy`	`Build` 리소스에 사용되는 전략의 이름과 유형을 나타냅니다.
`spec.output`	생성된 이미지를 내보낼 위치를 나타냅니다.
`spec.output.pushSecret`	컨테이너 레지스트리에 액세스하기 위한 기존 시크릿을 나타냅니다.

표 1.2. Build CR의 선택적 필드
필드	설명
`spec.paramValues`	빌드 전략에 정의된 매개변수 값을 지정하는 name-value 목록을 나타냅니다.
`spec.timeout`	사용자 정의 시간 초과를 정의합니다. 기본값은 10분입니다. `BuildRun` 리소스에서 이 필드 값을 덮어쓸 수 있습니다.
`spec.output.annotations`	출력 이미지에 주석을 달 때 사용할 수 있는 키-값 쌍 목록을 나타냅니다.
`spec.output.labels`	출력 이미지에 레이블을 지정하는 데 사용할 수 있는 키-값 쌍 목록을 나타냅니다.
`spec.env`	빌드 컨테이너에 전달할 수 있는 추가 환경 변수를 정의합니다. 사용 가능한 변수는 빌드 전략에서 사용하는 도구에 따라 다릅니다.
`spec.retention.ttlAfterFailed`	실패한 빌드 실행이 존재할 수 있는 기간을 지정합니다.
`spec.retention.ttlAfterSucceeded`	성공적인 빌드 실행이 존재할 수 있는 기간을 지정합니다.
`spec.retention.failedLimit`	존재할 수 있는 실패한 빌드 실행 수를 지정합니다.
`spec.retention.succeededLimit`	존재할 수 있는 성공적인 빌드 실행 수를 지정합니다.
`spec.nodeSelector`	빌드해야 하는 노드를 지정합니다.
`spec.tolerations`	빌드 Pod에 대한 허용 오차를 지정합니다.
`spec.schedulerName`	빌드 Pod에 대한 스케줄러를 지정합니다.

맨 위로 이동