# Tekton v1.12.0

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

보안 6 (high 1) · 호환성 변경 5 · 폐기 예정 1 · 의존성 갱신 9 · 기타 14

## 보안 (6)

### [high] Git resolver 인자 주입 수정

- 영향 대상: 지원 중단 예정이거나 현재 사용 중인 Git resolver를 사용하는 설정
- [GHSA-94jr-7pqp-xhcq](https://github.com/tektoncd/pipeline/security/advisories/GHSA-94jr-7pqp-xhcq)

1.10.0부터 1.11.0까지는 Git resolver가 `revision`의 앞에 `-`가 있는지 확인하지 않고 값을 그대로 `git fetch`에 전달해 인자 주입이 가능했습니다.

> * :lock: fix: prevent git argument injection via revision parameter (GHSA-94jr-7pqp-xhcq) (0967cc8e6e9b)

### VolumeMount 제한 검사에서 정규화된 경로 사용

- 영향 대상: VolumeMount 경로를 `/tekton/`과 대조해 검사하는 설정

> * :lock: fix: normalize VolumeMount paths before /tekton/ restriction check (c8cc73a2ceca)

### 사용자 제어 `serverURL`을 사용하는 경우 시스템 API 토큰 거부

- 영향 대상: 사용자 제어 `serverURL`과 시스템 API 토큰을 사용하는 설정

> * :lock: Security: reject system API token with user-controlled serverURL (e964bce1a130)

### HTTP 리졸버 응답 크기 제한

- 영향 대상: HTTP 리졸버를 사용하는 구성

> * :lock: fix: limit HTTP resolver response body size to prevent OOM DoS (d4ba8cae9edf)

### 리졸버 접두사 제거 및 비캡처 패턴 앵커링

- 영향 대상: 접두사와 패턴 앵커링을 사용하는 리졸버 설정 (추정)

> * :lock: fix: strip resolver prefixes and use non-capturing group for pattern anchoring (b8905600322a)

### 패턴 매칭 전 소스 URI 공백 제거

- 영향 대상: 소스 URI 패턴 매칭을 사용하는 환경 (추정)

> * :lock: fix: trim whitespace from source URI before pattern matching (37f9657b4bd1)

## 호환성 변경 (5)

### CustomRun CloudEvents 기본 전송

- 영향 대상: `config-events`에 CloudEvents sink가 설정된 CustomRuns
- 제거 시점: 미상

이전에는 `send-cloudevents-for-runs`를 `true`로 설정하지 않으면 CustomRun CloudEvents를 전송하지 않았습니다. 이제 `config-events`에 sink가 설정되어 있으면 전송합니다. 단, `send-cloudevents-for-runs`를 `false`로 설정하면 전송하지 않습니다.

근거: “The feature flag send-cloudevents-for-runs is deprecated and will be removed in a future release. Its default has changed from false to true: CloudEvents for CustomRuns are now sent by default whenever a sink is configured in config-events.” https://github.com/tektoncd/pipeline/pull/9774

> * :sparkles: [TEP-0137] Deprecate send-cloudevents-for-runs feature flag (#9774)
> The feature flag default changed from `false` to `true`. CloudEvents for CustomRuns are now sent by default.
> * :rotating_light: [TEP-0137] The `send-cloudevents-for-runs` feature flag is deprecated and will be removed in a future release. Its default has changed from `false` to `true` (#9774).

### Pod 수준 TaskRun 실패의 구체적인 사유

- 영향 대상: TaskRun `Succeeded` 조건

이전에는 Pod 수준의 모든 TaskRun 실패에 일반적인 `Failed` 사유를 사용했습니다. 이제 사유에 Pod 축출(`PodEvicted`), init 컨테이너의 OOM 또는 실패(`InitContainerOOM`, `InitContainerFailed`), step의 OOM 또는 실패(`StepOOM`, `StepFailed`), sidecar의 OOM 또는 실패(`SidecarOOM`, `SidecarFailed`)가 표시됩니다. 알 수 없는 실패에는 계속 `Failed`를 사용합니다. 여러 실패가 발생하면 Pod 축출, init 컨테이너 실패, sidecar OOM, step OOM, sidecar 실패, step 실패 순으로 우선순위를 적용합니다.

근거: “When multiple containers fail, the reason is chosen by priority: 1. Pod eviction (pod-level, authoritative) 2. Init container failures (run first, block everything) 3. Sidecar OOM → Step OOM (OOM is likely root cause) 4. Sidecar failed → Step failed (non-OOM failures)” https://github.com/tektoncd/pipeline/pull/9368

> * :sparkles: fix: surface specific TaskRun failure reasons when pod fails (#9368)
> TaskRun failure reasons now distinguish between different pod-level failure types: PodEvicted, InitContainerOOM, InitContainerFailed, StepOOM, StepFailed, SidecarOOM, and SidecarFailed, replacing the generic "Failed" reason.

### 실행 오브젝트의 중복 CloudEvents 억제

- 영향 대상: run 오브젝트용으로 구성한 CloudEvents 싱크
- 필요 조치: 동일 리소스의 reconcile 사이클이 동시에 실행되지 않도록 컨트롤러 동시성을 1로 설정

이번 릴리스 전에는 `PipelineRun`과 `TaskRun` 이벤트가 이벤트 캐시를 우회했습니다. 이제 반복되는 컨디션 스냅샷은 건너뛰며, 한 번 전송한 이벤트 유형은 컨디션이 바뀌어도 계속 억제됩니다. 단, `.unknown.` 이벤트는 메시지만 바뀌는 경우를 포함해 컨디션이 바뀌면 계속 전송할 수 있습니다.

근거: “// A cache miss requires a new object or change in the condition (including message-only changes)” https://github.com/tektoncd/pipeline/pull/6914

> * :bug: Rework the events controller cache (#6914)

### CloudEvents 전송을 전용 컨트롤러로 이전

- 영향 대상: PipelineRun 또는 TaskRun에 CloudEvents를 사용하는 구성
- 필요 조치: `tekton-events-controller` Deployment가 실행 중이어야 함

이전에는 PipelineRun 및 TaskRun 컨트롤러가 이러한 CloudEvents를 전송했지만, 이제는 전용 컨트롤러가 전송하며 대기열에 추가된 이벤트 유형 두 가지를 사용할 수 있습니다. `kubectl describe pipelinerun/taskrun`을 실행하면 `CloudEventSent` 및 `CloudEventFailed` Kubernetes Events를 통해 전송 상태를 확인할 수 있습니다.

> ### :rotating_light: TEP-0137: CloudEvents now sent by dedicated events controller (ACTION REQUIRED)
> CloudEvents for **PipelineRuns** and **TaskRuns** are now sent by the dedicated `tekton-events-controller` and **no longer by the PipelineRun/TaskRun controllers**. Operators must ensure the `tekton-events-controller` Deployment is running.
> New events added:
> - `dev.tekton.event.pipelinerun.queued.v1` — sent when a PipelineRun is created but not yet processed
> - `dev.tekton.event.taskrun.queued.v1` — sent when a TaskRun is created but not yet processed
> CloudEvent delivery visibility is available via `kubectl describe pipelinerun/taskrun` (CloudEventSent/CloudEventFailed k8s Events).

### PipelineRun 누락 result 메시지에 태스크와 result 정보 표시

- 영향 대상: 다운스트림 태스크가 태스크 result를 사용하는 PipelineRun

성공적으로 완료된 태스크에 다운스트림 태스크가 참조하는 result가 없으면, 이전 메시지는 개수만 표시했지만 이제는 해당 태스크와 누락된 result, 다운스트림 태스크를 표시하며 세부 정보는 1024자로 제한됩니다. 참조된 태스크가 성공하지 않고 실패한 경우에는 기존 오류 메시지가 그대로 유지됩니다.

근거: “If a referenced result is missing from a completed (successful) task, the error message now states which task completed without emitting which result and which downstream task references it. The details are included in the PipelineRun status condition message (capped at 1024 characters). When the referenced task failed (rather than succeeded), the original error message is preserved unchanged.” https://github.com/tektoncd/pipeline/pull/9529

> * :sparkles: fix: surface clear errors when completed tasks miss referenced results (#9529)

## 폐기 예정 (1)

### `send-cloudevents-for-runs` 플래그 지원 중단 예정

- 영향 대상: `config-events`에 sink가 설정된 CustomRuns
- 제거 시점: 미상

이전에는 플래그 기본값이 `false`여서 CustomRuns의 CloudEvents가 기본적으로 전송되지 않았습니다. 설정을 바꾸지 않아도 이제 `config-events`에 sink가 설정되어 있으면 CloudEvents가 전송됩니다.

> ### :rotating_light: TEP-0137: `send-cloudevents-for-runs` feature flag deprecated
> The `send-cloudevents-for-runs` feature flag is deprecated and will be removed in a future release. Its default has changed from `false` to `true`: CloudEvents for CustomRuns are now sent by default whenever a sink is configured in `config-events`.
> Users relying on the flag set to `false` to skip events for CustomRuns should be aware of this change.

## 의존성 갱신 (9)

그 외 9건 · 보안 언급 없음

- `* :hammer: Remove aws-sdk-go-v2 ECR replace directives (#9773)`
- `* :hammer: build(deps): bump k8s.io dependencies from 0.35.2 to 0.35.4 (#9848)`
- `* :hammer: build(deps): bump github.com/google/cel-go from 0.27.0 to 0.28.0 (#9824)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.79.3 to 1.80.0 (#9715)`
- `* :hammer: build(deps): bump go.uber.org/zap from 1.27.1 to 1.28.0 (#9926)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/sdk from 1.42.0 to 1.43.0 (#9757)`
- `* :hammer: build(deps): bump github.com/go-jose/go-jose/v3 from 3.0.4 to 3.0.5 (#9722)`
- `* :hammer: build(deps): bump github.com/go-jose/go-jose/v4 from 4.1.3 to 4.1.4 (#9721)`
- `* :hammer: build(deps): bump github.com/sigstore/sigstore from 1.10.4 to 1.10.5 (#9711)`

## 기타 (14)

- task 결과 검증 실패 시 Kubernetes Warning 이벤트
- 완료된 PipelineRun 조정에서 반복 작업 생략
- TaskRun 정리 과정에서 더 이상 기본값을 적용하지 않음
- PipelineRun 및 TaskRun 맵 비교에 `maps.Equal` 적용
- Events 컨트롤러 캐시를 bigcache와 해시 키로 전환
- 분류된 GitHub 릴리스 초안을 만드는 릴리스 파이프라인
- CI 워크플로에서 `tj-actions/changed-files`를 `git diff`로 대체
- LTS 릴리스 브랜치용 Dependabot 자동 구성
- `TestEmit` 테스트의 테이블 기반 구조 제거
- `TaskRun` 대기 라이프사이클 엔드투엔드 테스트 추가
- `k8s.io/code-generator` 0.35.3에 맞춰 생성된 가짜 클라이언트셋 업데이트
- Bundle resolver 옵션의 기본값과 필수 여부 문서화
- OpenCensus에서 OpenTelemetry로의 마이그레이션에 맞춰 메트릭 문서 업데이트
- Examples README의 v1 적용 경로 업데이트

---

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