# Tekton v1.13.0

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

보안 3 · 호환성 변경 2 · 중요 수정 6 · 기능·개선 1 · 의존성 갱신 32 · 기타 17

## 보안 (3)

### [보안 여부 불분명] TaskRun 알림 트레이싱 추가

- 영향 대상: TaskRun 알림 리컨실리에이션 및 CloudEvent 전달 경로와, `CustomRun`에서 사용하는 공유 `ReconcileRunObject` 경로
- 추가 조치: Kubernetes 리소스 식별자가 포함될 수 있는 내보낸 트레이스를 처리하는 신뢰할 수 있는 옵저버빌리티 시스템

기존에는 리컨실리에이션 트리거부터 CloudEvent를 최종 발행할 때까지 발생한 실패를 서로 연관 지어 추적하거나 지연 시간을 측정할 수 없었습니다. 이제 연결된 스팬이 이 경로를 추적합니다. TaskRun 루트 스팬에는 `taskrun.name`과 `taskrun.namespace`가 포함되며, CloudEvent 스팬에는 네트워크 및 싱크 실패가 기록됩니다.

> * :sparkles: feat(tracing): add spans to TaskRun notifications controller (#9912)
> Added OpenTelemetry tracing to the TaskRun notification reconciliation path.
> Spans now cover ReconcileKind, ReconcileRunObject, and EmitCloudEvents,
> enabling operators to trace CloudEvent delivery latency end-to-end.

### `TaskRun` 알림 식별자 로그의 debug 레벨 전환

- 영향 대상: `TaskRun` 알림 조정
- 추가 조치: 내보낸 트레이스의 경우 CloudEvents sink와 동등하거나 더 엄격한 접근 제어를 갖춘 신뢰할 수 있는 백엔드; 멀티테넌트 환경에서는 트레이싱을 활성화하기 전에 검토한 보존 및 접근 제어 정책

이전에는 이 경로가 기본적으로 `TaskRun` 및 실행 오브젝트 식별자를 INFO 레벨로 로그에 남겼습니다. 업그레이드하면 운영자가 변경하지 않아도 이 식별자들이 기본 로그 레벨에서 더는 출력되지 않습니다.

> * :bug: fix(events): reduce TaskRun notification identifier logging and document trace exposure (#10117)
> Reduced default log verbosity in the TaskRun notification path introduced
> by #9912. Identifier logs (TaskRun name/namespace) are now emitted at debug

### 리졸버 검증에서 지원하지 않는 오브젝트 거부

- 영향 대상: Resolver API를 사용하는 커스텀 리졸버 또는 ResolutionRequest

이전에는 리졸버가 어떤 오브젝트나 문자열이든 가져와 ResolutionRequest를 성공으로 표시할 수 있었고, 검증은 부모 Run에 주입될 때만 수행됐습니다. 이제 Tekton StepAction, Task 또는 Pipeline이 아닌 것을 resolve하면 데이터가 ResolutionRequest에 기록되기 전에 ResolutionRequest가 실패합니다.

> * :bug: fix(resolvers): validate data is Tekton object in resolver framework (#9588)
> Fixes a bug which lets Tekton Resolvers resolve non-tekton objects and arbitrary data. After this change, resolving a non-tekton object causes the ResolutionRequest to fail.
> Action Required: Tekton Resolvers are now only permitted to resolve StepActions, Tasks, and Pipelines. Custom resolvers or ResolutionRequest which use the Resolver API for other object types will no longer function.

## 호환성 변경 (2)

### 이제 이벤트 내보내기를 제어하는 `config-events` 형식

- 영향 대상: `config-events`의 `formats` 필드를 설정한 환경

설정을 변경하지 않으면 기본값인 `tektonv1`이 기존 동작을 유지합니다. 유효하지 않거나 인식할 수 없는 형식은 경고 로그를 남기며, 해당 형식의 이벤트를 내보내지 않습니다.

> * :sparkles: [TEP-0137] Activate formats field in config-events (#9776)
> The formats field in config-events is now active. The default value is
> tektonv1, which preserves existing behaviour. Setting an invalid or
> unrecognised format value logs a warning and suppresses event emission
> for that format.

### 익명 Pipeline의 label과 metrics에서 정제된 `generateName` 사용

- 영향 대상: `metadata.generateName`이 설정된 inline-spec Pipeline

이전에는 이 실행에서 생성된 TaskRun의 `tekton.dev/pipeline` label과 metrics 태그에 PipelineRun 이름이 사용됐습니다.

> * :bug: fix(pipelinerun): use generateName for anonymous pipeline label (#9826)
> Previously, TaskRuns' `tekton.dev/pipeline` label for anonymous Pipelines would use their PipelineRun's name in their `tekton.dev/pipeline` label and `pipeline` metrics tag.  After this change, TaskRun and PipelineRun which are created from anonymous Pipelines now reference a sanitized `metadata.generateName`, when present, for the label `tekton.dev/pipeline`. Similarly, these TaskRruns and PipelineRuns will populate their respective metrics' `pipeline` tag with the sanitized generateName instead of using `anonymous`.

## 중요 수정 (6)

### PipelineRun 타임아웃 시 이전 TaskRun 조건 정보 보존

- 영향 대상: 타임아웃이 설정된 PipelineRun이 관리하는 TaskRun

이전에는 PipelineRun 타임아웃으로 자식 TaskRun의 `status.conditions`가 덮어써져 `ExceededResourceQuota` 같은 세부 정보가 사라질 수 있었습니다. 새 실패 메시지에는 이전 조건의 reason과 message가 포함됩니다. 단, reason이 `Started`, `Running` 또는 `Pending`인 경우는 제외됩니다.

> * :bug: fix: preserve previous condition context when TaskRun is cancelled or times out (#10076)
> Preserve previous TaskRun condition context (reason + message) when a TaskRun is cancelled or times out due to a PipelineRun timeout, so diagnostic information like ExceededResourceQuota is no longer lost.

### 리졸버별 TTL을 반영하는 리졸버 캐시

- 영향 대상: 리졸버별 TTL이 0보다 큰 리졸버 ConfigMap(예: `bundleresolver-config` 또는 `git-resolver-config`)

이전에는 리졸버 ConfigMap에 양수 TTL이 설정되어 있어도 캐시 항목에 항상 전역 `resolver-cache-config` TTL을 적용했습니다. 이제는 리졸버별 TTL이 0보다 크면 해당 TTL을 적용하고, 그렇지 않으면 전역 TTL을 적용합니다.

> * :bug: fix: respect per-resolver TTL override in cache (#9625)
> Resolver cache now respects per-resolver TTL values set in individual
> resolver ConfigMaps (e.g., bundleresolver-config, git-resolver-config),
> instead of always using the global resolver-cache-config TTL.

### Pod eviction 후 PipelineRun 조기 실패 수정

- 영향 대상: Pod 기반 TaskRun을 사용하는 PipelineRun

Pod eviction 이후 TaskRun 상태가 Running으로 업데이트되기 전의 경쟁 상태에서, 오래된 캐시 실패 상태 때문에 TaskRun이 복구되더라도 PipelineRun이 영구적으로 실패할 수 있었습니다. 이제 컨트롤러는 캐시된 `PodEvicted` 실패에 대해 실패한 TaskRun마다 reconcile마다 API 서버 GET을 한 번 수행하고 최신 상태를 사용합니다. NotFound가 아닌 이유로 확인에 실패하면 reconcile에서 오류를 반환합니다.

> * :bug: Fix PipelineRun premature failure when TaskRun recovers after pod eviction (#9640)

### Affinity assistant 볼륨 이름의 Kubernetes 63자 제한 대응

- 영향 대상: `AffinityAssistantPerPipelineRun` 또는 `AffinityAssistantPerPipelineRunWithIsolation` 모드에서 workspace `volumeClaimTemplate` 이름으로 생성되는 볼륨 이름이 63자를 초과하는 affinity assistant (추정)

긴 `volumeClaimTemplate.metadata.name` 때문에 생성된 볼륨 이름이 Kubernetes의 63자 제한을 넘으면 affinity assistant Pod 생성이 실패하고 파이프라인이 막힐 수 있었습니다. 이제 길이가 초과된 이름을 자를 때 해시 접미사를 붙이며, 더 짧은 이름은 그대로 유지됩니다.

> * :bug: fix: truncate affinity assistant volume names to 63 characters (#9752)
> Affinity assistant StatefulSet no longer fails when workspace volumeClaimTemplate names exceed 63 characters. Long volume names are now automatically truncated with a hash suffix to stay within the Kubernetes limit.

### PipelineRun 타임아웃 후 finally task 실행

- 영향 대상: finally task가 있는 PipelineRun

명시적인 `timeouts.tasks` 타임아웃 또는 계산된 `timeouts.pipeline - timeouts.finally` 타임아웃을 초과했을 때 아직 실행할 finally task가 남아 있으면 PipelineRun이 즉시 Failed로 표시되어 해당 task가 실행되지 않았습니다. 이제 대기 중인 finally task가 완료될 때까지 PipelineRun이 실행 상태를 유지한 뒤 타임아웃 사유로 실패합니다.

> * :bug: fix: allow finally tasks to run when tasks timeout is exceeded (#9709)
> Fix a bug where finally tasks were not executed when the tasks timeout
> (either explicit via `timeouts.tasks` or calculated as `timeouts.pipeline -
> timeouts.finally`) was exceeded. The PipelineRun was immediately marked as
> Failed without giving finally tasks a chance to run. Now the pipeline
> continues running with reason `PipelineRunTimeoutRunningFinally` until
> finally tasks complete.

### 리졸버 프레임워크 타임아웃으로 인한 고루틴 누수 수정

- 영향 대상: 로컬 또는 원격 리졸버 프레임워크 리컨실러를 사용하는 설정

`Resolve()`가 데드라인을 넘기면 호출자는 반환하지만, 고루틴은 `errChan` 또는 `resourceChan`에 값을 보내지 못하고 차단되어 고루틴이 누수되고 리소스가 계속 점유됐습니다. 이런 상태가 지속적인 부하에서 이어지면 컨트롤러 성능이 저하되어 재시작이 필요할 수 있었습니다. 이제 버퍼링된 채널을 사용하므로 고루틴이 결과를 보내고 종료할 수 있습니다.

> * :bug: fix: resolve goroutine leak from unbuffered channels in resolver reconciler (#10098)

## 기능·개선 (1)

- 선택적 종료 메시지 압축 (사용 조건: 종료 메시지 압축을 활성화하는 데 필요한 알파 기능 플래그 `enable-termination-message-compression`)

## 의존성 갱신 (32)

그 외 32건 · 보안 언급 없음

- `* :hammer: chore: bump OpenTelemetry semconv to match SDK version (#9697)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#10126)`
- `* :hammer: build(deps): bump golangci/golangci-lint-action from 9.2.0 to 9.2.1 (#10125)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/trace from 1.43.0 to 1.44.0 (#10118)`
- `* :hammer: build(deps): bump golang.org/x/crypto from 0.51.0 to 0.52.0 (#10095)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#10085)`
- `* :hammer: build(deps): bump github/codeql-action from 4.35.4 to 4.35.5 (#10084)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.19.2 to 2.19.4 (#10083)`
- `* :hammer: build(deps): bump zizmorcore/zizmor-action from 0.5.3 to 0.5.6 (#10082)`
- `* :hammer: build(deps): bump github.com/sigstore/sigstore/pkg/signature/kms/gcp from 1.10.5 to 1.10.6 (#10081)`
- `* :hammer: build(deps): bump github.com/spiffe/spire-api-sdk from 1.14.6 to 1.15.0 (#10080)`
- `* :hammer: build(deps): bump github.com/sigstore/sigstore/pkg/signature/kms/aws from 1.10.5 to 1.10.6 (#10060)`
- `* :hammer: build(deps): bump github.com/google/go-containerregistry from 0.21.5 to 0.21.6 (#10058)`
- `* :hammer: build(deps): bump github.com/sigstore/sigstore from 1.10.5 to 1.10.6 (#10057)`
- `* :hammer: build(deps): bump github.com/sigstore/sigstore/pkg/signature/kms/hashivault from 1.10.5 to 1.10.6 (#10047)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#10039)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.19.1 to 2.19.2 (#10038)`
- `* :hammer: build(deps): bump actions/dependency-review-action from 4.9.0 to 5.0.0 (#10037)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.81.0 to 1.81.1 (#10036)`
- `* :hammer: build(deps): bump k8s.io/apiextensions-apiserver from 0.35.4 to 0.35.5 (#10033)`
- `* :hammer: build(deps): bump github.com/jenkins-x/go-scm from 1.15.21 to 1.15.22 (#10032)`
- `* :hammer: build(deps): bump github.com/google/cel-go from 0.28.0 to 0.28.1 (#10012)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.35.4 to 0.35.5 (#10011)`
- `* :hammer: build(deps): bump k8s.io/code-generator from 0.35.4 to 0.35.5 (#10010)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.35.4 to 0.35.5 in /test/custom-task-ctrls/wait-task-beta (#10009)`
- `* :hammer: build(deps): bump golang.org/x/crypto from 0.50.0 to 0.51.0 (#10005)`
- `* :hammer: build(deps): bump github/codeql-action from 4.35.2 to 4.35.4 (#9992)`
- `` * :hammer: build(deps): bump chainguard/go from `7ec9277` to `a4477c3` in /tekton in the all group (#9991) ``
- `* :hammer: build(deps): bump step-security/harden-runner from 2.19.0 to 2.19.1 (#9978)`
- `* :hammer: build(deps): bump chainguard-dev/actions from 1.6.17 to 1.6.19 (#9977)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9975)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.80.0 to 1.81.0 (#9954)`

## 기타 (17)

- 내보낸 트레이스의 민감 데이터 관련 트레이싱 안내
- 데이터가 있는 `ResolutionRequest`의 재해석 건너뛰기
- 다운스트림에서 가져올 수 있는 `gen-crd-api-reference-docs` 모듈 요구사항
- Dependabot 재생성 커밋에서 CLA 승인 신원과 DCO 사인오프 사용
- `dependabot-regen` 워크플로에서 checkout과 push에 `secrets.CHATOPS_TOKEN` 사용
- Go 버전 지시문 및 테스트 서브모듈의 1.26 업데이트
- 리컨실러별 TaskRun 네이티브 사이드카 감지 캐싱
- 초안 PR의 CI e2e 매트릭스 축소
- `.github/dependabot.yml` 원본 설정을 바탕으로 재생성
- `wait-task-beta` 테스트의 Pipeline 의존성을 1.12.0으로 업데이트
- `actions/setup-go` 버전 5.2.0에서 6.4.0으로 업데이트
- `/tekton` 내 빌드 이미지 및 도구 참조 업데이트
- `codeql-analysis.yml`의 `setup-go` 버전 주석 수정
- 웹사이트 동기화 설정 릴리스 참고표 업데이트
- v1.12.0 LTS, v1.11 및 v1.9 항목을 반영한 `releases.md` 업데이트
- 인라인 task spec에서 재시도 횟수 치환 동작 명확화
- 테스트 모범 사례 추가

---

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