# Tekton v1.9.0

2026-01-30 · [릴리스 노트 원문](https://github.com/tektoncd/pipeline/releases/tag/v1.9.0) · [전체 정리](https://ratatosk.io/ko/releases/tekton/v1.9.0)

보안 1 · 호환성 변경 5 · 중요 수정 7 · 기능·개선 2 · 의존성 갱신 30 · 기타 39

## 업그레이드 전 확인

### 릴리스 이후 확인된 결함

- Sidecar-logs 결과 추출에서 TaskRun 결과 전체 누락 문제 해결 · v1.15.0에서 수정됨

## 보안 (1)

### Pipeline 매개변수 기본값 참조 해석과 10단계 제한

- 영향 대상: 기본값에 매개변수 참조가 있는 PipelineRuns

이전에는 `$(params.X)` 참조가 포함된 기본값을 그대로 복사해 태스크 파드 생성 단계에서 뒤늦게 오해를 부르는 메시지와 함께 실패했습니다. 이제 이러한 참조를 해석하며, 의존성 체인이 10단계를 초과하면 최대 재귀 깊이 오류로 실패합니다.

> * :bug: Fix parameter resolution for defaults with  references (#9271)

## 호환성 변경 (5)

### `PriorityClassName`의 중복 protobuf 태그 수정

- 영향 대상: `PriorityClassName`의 `pod.Template` protobuf 직렬화 (추정)

이전에는 `PriorityClassName`이 protobuf 태그 7을 `Env`와 공유했습니다. 이제 `PriorityClassName`은 태그 8을 사용하고, `Env`는 태그 7을 계속 사용합니다.

근거: “- Changed `PriorityClassName` protobuf tag from 7 to 8” https://github.com/tektoncd/pipeline/pull/9229

> * :bug: Fix duplicated protobuf tag in pod.Template struct (#9229)

### `v1beta1` CRD 설명 축약으로 설치 오류 수정

- 영향 대상: `v1beta1` CRD를 적용하는 설치 환경

상세한 임베디드 설명이 포함된 CRD를 적용할 때 `metadata.annotations: Too long` 오류가 발생할 수 있었습니다. 이제 `kubectl explain`에는 이전보다 적은 정보가 표시됩니다. API 필드의 상세 설명은 Tekton 문서나 `v1` 필드에서 확인할 수 있습니다.

근거: “To resolve "metadata.annotations: Too long" errors during installation, the field descriptions embedded in `v1beta1` CRDs (visible via `kubectl explain`) have been significantly shortened. Users should refer to the [Tekton documentation](https://tekton.dev/docs/) for detailed API field descriptions or use descriptions in v1 fields.” https://github.com/tektoncd/pipeline/pull/9252

> * :hammer: fix: reduce CRD size by shortening verbose descriptions (#9252)

### `PipelineRunList` 스트리밍 리스트 처리 수정

- 영향 대상: v1 또는 v1beta1 `PipelineRunList` API 타입

이전에는 JSON에서 items를 생략할 수 있었고, 생성된 스키마에서도 필수 항목으로 표시되지 않아 Kubernetes API의 스트리밍 리스트 처리에서 이러한 타입을 올바르게 해석하지 못했습니다. 이제 items는 항상 직렬화되며 필수 항목으로 표시됩니다.

근거: “- Removes ',omitempty' from the 'Items' field in the v1 and v1beta1 PipelineRunList structs.” https://github.com/tektoncd/pipeline/pull/9240

> * :hammer: fix(codegen): Correct JSON tags for streaming lists (#9240)

### v1beta1 `ResolutionRequestList`의 `ListMeta` JSON 태그에 `omitempty` 추가

- 영향 대상: v1beta1 `ResolutionRequestList` 타입과 해당 JSON 표현을 사용하는 설정 (추정)

`ListMeta` 필드의 JSON 태그가 `json:"metadata"`에서 `json:"metadata,omitempty"`로 변경됩니다.

근거: “- Adds ',omitempty' to the 'ListMeta' field in the v1beta1 ResolutionRequestList struct.” https://github.com/tektoncd/pipeline/pull/9240

> * :hammer: fix(codegen): Correct JSON tags for streaming lists (#9240)

### 커스텀 태스크 API 버전의 `group/version` 형식 필수화

- 영향 대상: 커스텀 태스크에서 `taskRef.apiVersion` 또는 `taskSpec.apiVersion`을 사용하는 Pipeline

이전에는 `invalid-api-version` 같은 잘못된 값으로 인해 PipelineRuns가 처리되지 않는 CustomRuns를 생성하고, 이 CustomRuns가 시간 초과될 수 있었습니다. 이제 두 값 중 하나라도 잘못되면 Pipeline 생성이 명확한 오류와 함께 즉시 실패합니다.

근거: “add validation to ensure taskRef.apiVersion follows the correct format (group/version) when specified. Previously, invalid apiVersion values like 'invalid-api-version' were accepted, causing PipelineRuns to create unhandled CustomRuns that would timeout. Now Pipeline creation fails immediately with a clear error message when an invalid apiVersion is provided.” https://github.com/tektoncd/pipeline/pull/9045

> * :bug: fix: validate taskRef.apiVersion format for custom tasks (#9045)

## 중요 수정 (7)

### Affinity Assistant ServiceAccount 상속 수정

- 영향 대상: Affinity Assistant Pod가 있고 `taskRunTemplate.serviceAccountName`이 설정된 PipelineRun

이전에는 이 Pod들이 항상 네임스페이스의 `default` ServiceAccount를 사용했습니다. 이 ServiceAccount에 필요한 SCC 권한이 없으면 OpenShift에서 워크스페이스를 함께 스케줄링하는 PipelineRun이 실패할 수 있었습니다. 이제는 `AffinityAssistantTemplate`에 재정의 값이 지정되지 않은 경우 PipelineRun의 `taskRunTemplate.serviceAccountName`을 사용합니다. 두 곳 모두 값이 없으면 네임스페이스의 `default` ServiceAccount를 사용합니다.

> * :sparkles: feat: add ServiceAccount inheritance to Affinity Assistants (#9253)

### 중복 PipelineRun 상태 쓰기 수정

- 영향 대상: 자식 참조를 status에 기록하며 조정되는 PipelineRun

순서가 정해지지 않은 자식 참조 배열 때문에 상태 쓰기가 대량으로 반복됐습니다. 자식 TaskRun이 64개를 초과하는 PipelineRun에서 특히 두드러졌으며, apiserver 메모리 급증과 높은 쓰기 QPS를 유발하는 현상과도 관련이 있었습니다. 이제 자식 참조가 일관된 순서로 정렬되어 중복 쓰기가 줄고, 이와 관련된 apiserver 부하와 안정성 영향도 완화됩니다.

> * :bug: fix(pipelinerun): fix the issue of massive invalid status updates caused by unordered arrays, which will greatly impact the resource load and stability of the apiserver. (#9295)

### Pipeline 파라미터 기본값의 참조 해석

- 영향 대상: 다른 파라미터를 참조하는 기본값이 있는 PipelineSpec

이전에는 리터럴 참조가 태스크까지 전달되어 Pod 생성이 실패할 수 있었습니다. 이제 태스크에는 해석된 파라미터 값이 전달되므로 Pod를 성공적으로 생성할 수 있습니다.

> * :bug: Fix parameter resolution for defaults with  references (#9271)

### PipelineRun 생성 시 순환 매개변수 의존성 감지

- 영향 대상: 매개변수 기본값 사이에 순환 참조가 있는 PipelineRun

이전에는 이런 순환이 태스크 파드 생성 중 오해를 부르는 오류로 나타났습니다. 이제 PipelineRun 생성 시 검증에 실패하며, 오류 메시지에서 순환 의존성을 식별합니다.

> * :bug: Fix parameter resolution for defaults with  references (#9271)

### 검증 시 정의되지 않은 PipelineRun 파라미터 참조 감지

- 영향 대상: PipelineRun 파라미터 기본값

기본값이 정의되지 않은 파라미터를 참조해도 이전에는 해석 과정에서 이를 감지하지 못해, 태스크 파드를 만들 때 나중에 오해를 부르는 오류가 나타날 수 있었습니다. 이제 검증 단계에서 정의되지 않은 참조를 식별하는 오류가 발생합니다.

> * :bug: Fix parameter resolution for defaults with  references (#9271)

### timeout이 없는 `TaskRuns` 및 `PipelineRuns`의 과도한 리컨실리에이션 수정

- 영향 대상: 설정된 timeout이 없는 `TaskRuns` 및 `PipelineRuns`: timeout이 `0`으로 설정됐거나, `default-timeout-minutes`가 "0"일 때 timeout이 설정되지 않은 경우

이전에는 이러한 실행이 즉시 다시 큐에 들어가 리컨실리에이션이 과도하게 발생했습니다. timeout이 없으면 이제 watch 이벤트에 따라 리컨실리에이션을 수행합니다. task별 또는 finally별 timeout이 설정되어 있으면 해당 timeout에 맞춰 다시 큐에 넣습니다.

> * :bug: fix: Prevent excessive reconciliation when timeout disabled (#9202)

### TaskRun 파드 컨테이너 오류 발생 시 빠른 실패 처리

- 영향 대상: 파드 컨테이너에서 `valueFrom`으로 ConfigMap 또는 Secret을 사용하도록 구성된 TaskRun

파드 컨테이너에 설정 오류나 컨테이너 생성 오류가 발생하면, `valueFrom`으로 참조한 ConfigMap 또는 Secret이 없는 경우를 포함해 TaskRun이 대기하다가 일반적인 타임아웃만 보고할 수 있었습니다. 이제 오류가 감지되는 즉시 실패하며, `CreateContainerConfigError` 또는 `PodCreationFailed`와 같이 조치 가능한 오류를 보고합니다.

> * :bug: fix: Detect pod configuration errors early instead of timeout (#9197)

## 기능·개선 (2)

- TaskRun 및 PipelineRun PodTemplate의 사용자 네임스페이스 선택 (사용 조건: 이 필드를 사용하려면 Kubernetes 기능 게이트 `UserNamespacesSupport`를 활성화해야 합니다.)
- HTTP 리졸버 다이제스트 검증 추가 (사용 조건: 기본적으로 활성화된 `enable-http-resolver` 기능 플래그)

## 의존성 갱신 (30)

그 외 30건 · 보안 언급 없음

- `* :hammer: build(deps): bump go.uber.org/zap from 1.27.0 to 1.27.1 (#9333)`
- `* :hammer: build(deps): bump github.com/google/cel-go from 0.26.0 to 0.27.0 (#9330)`
- `* :hammer: build(deps): bump golang.org/x/sync from 0.18.0 to 0.19.0 (#9293)`
- `* :hammer: build(deps): bump github.com/hashicorp/go-version from 1.7.0 to 1.8.0 (#9288)`
- `* :hammer: build(deps): bump k8s.io/apiextensions-apiserver from 0.32.8 to 0.32.11 (#9286)`
- `* :hammer: build(deps): bump github.com/spiffe/spire-api-sdk from 1.12.4 to 1.14.0 (#9261)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/sdk from 1.38.0 to 1.39.0 (#9259)`
- `* :hammer: build(deps): bump github.com/cloudevents/sdk-go/v2 from 2.16.1 to 2.16.2 (#9258)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.32.8 to 0.32.11 (#9256)`
- `* :hammer: build(deps): bump google.golang.org/protobuf from 1.36.10 to 1.36.11 (#9254)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.8 to 4.31.9 (#9247)`
- `* :hammer: build(deps): bump the all group in /tekton with 2 updates (#9246)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/trace from 1.37.0 to 1.39.0 (#9245)`
- `* :hammer: build(deps): bump k8s.io/apimachinery from 0.33.3 to 0.33.7 (#9244)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9236)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.13.3 to 2.14.0 (#9235)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.7 to 4.31.8 (#9234)`
- `* :hammer: build(deps): bump actions/cache from 4.3.0 to 5.0.1 (#9233)`
- `* :hammer: build(deps): bump tj-actions/changed-files from abdd2f68ea150cee8f236d4a9fb4e0f2491abf1b to e0021407031f5be11a464abee9a0776171c79891 (#9232)`
- `* :hammer: build(deps): bump actions/upload-artifact from 5.0.0 to 6.0.0 (#9231)`
- `* :hammer: build(deps): bump the all group across 1 directory with 4 updates (#9220)`
- `* :hammer: build(deps): bump actions/checkout from 6.0.0 to 6.0.1 (#9219)`
- `* :hammer: build(deps): bump golangci/golangci-lint-action from 9.1.0 to 9.2.0 (#9218)`
- `* :hammer: build(deps): bump peter-evans/slash-command-dispatch from 4.0.0 to 5.0.1 (#9217)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.13.2 to 2.13.3 (#9216)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.6 to 4.31.7 (#9215)`
- `* :hammer: build(deps): bump actions/github-script from 7.0.1 to 8.0.0 (#9195)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.5 to 4.31.6 (#9194)`
- `* :hammer: build(deps): bump github.com/jenkins-x/go-scm from 1.15.4 to 1.15.16 (#9183)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.75.0 to 1.77.0 (#9177)`

## 기타 (39)

- TaskRun 결과 크기 오류에 실제 크기 표시
- 체리픽 워크플로에서 리베이스 병합된 여러 커밋 처리
- CI에서 임시 제외된 e2e 테스트 두 개
- Docker-in-Docker 사이드카 예제 테스트 프로브 업데이트
- GitHub Actions 워크플로의 실행 간 ko 레이어 메타데이터 캐시
- 리컨실리에이션 및 과도한 리컨실리에이션 테스트 업데이트
- README에서 GHCR 마이그레이션 안내 제거
- 릴리스 문서와 치트 시트 개정
- `github/codeql-action`을 `4.32.0`으로 업데이트
- Tekton 릴리스 파이프라인 이미지 업데이트
- `chainguard-dev/actions` 1.5.13 버전으로 업데이트
- 저장소 자동화의 `actions/checkout` 6.0.2 업데이트
- 저장소 자동화의 `step-security/harden-runner` 2.14.1 업데이트
- 릴리스 파이프라인 이미지 버전 업데이트
- `chainguard-dev/actions` 1.5.12로 업데이트
- 저장소 자동화에서 `actions/setup-go` `6.2.0`으로 업데이트
- 리포지토리 자동화 `actions/cache`를 5.0.1에서 5.0.2로 업데이트
- `/tekton` 릴리스 파이프라인 이미지 업데이트
- 저장소 자동화에서 `chainguard-dev/actions`를 1.5.11로 업데이트
- Tekton 릴리스 파이프라인 이미지 업데이트
- `/tekton` 릴리스 파이프라인 이미지 및 도구 업데이트
- `/tekton`의 `chainguard/go` 업데이트
- 저장소 자동화에서 `peter-evans/slash-command-dispatch`를 5.0.2로 업데이트
- GitHub 워크플로 참조에 `# main` 주석 추가
- `golangci-lint` GitHub Actions 단계의 대규모 diff 처리 수정
- CI 워크플로 파일 변경 감지 수정
- 파이프라인 메인테이너 별칭에 `twoGiants` 추가
- Cherry-pick-command 워크플로 시작 실패 수정
- 종단 간 테스트 분류
- 체리픽 워크플로의 공유 플러밍 워크플로 이전
- go-coverage 댓글 게시 수정
- 자동 체리픽 PR에 설명이 담긴 제목과 원본 맥락 제공
- `e2e-matrix-extras` 워크플로의 잘못된 `github-script` 액션 SHA 수정
- Examples 테스트 병렬 실행 수 6에서 2로 감소
- 커버리지 워크플로에서 풀 리퀘스트 댓글에 `CHATOPS_TOKEN` 사용
- 복사본 `chatops_retest`를 공용 워크플로로 대체
- 릴리스 치트 시트 템플릿의 YAML 들여쓰기 수정
- `projected` 및 `csi` 워크스페이스의 베타 기능 안내 제거
- v1.7 릴리스 정보를 반영한 `releases.md` 업데이트

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
