# Tekton v1.11.0

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

보안 2 · 호환성 변경 3 · 중요 수정 11 · 기능·개선 4 · 의존성 갱신 45 · 기타 27

## 보안 (2)

### 액세스 제어 매칭 전 네임스페이스 목록 항목의 공백 제거

- 영향 대상: 항목 앞뒤에 공백이 있는 쉼표 구분 `allowed-namespaces` 또는 `blocked-namespaces` 값을 사용하는 클러스터 리졸버 설정

이전에는 `prod, staging` 같은 항목에서 `staging` 앞에 공백이 남아 액세스 제어 매칭이 조용히 실패할 수 있었습니다. 이제 비교 전에 항목의 공백을 제거하므로, 앞뒤 공백이 매칭을 막지 않습니다.

> * :bug: fix: cluster resolver namespace access control whitespace and wildcard bugs (#9592)
> ix cluster resolver namespace access control: trim whitespace in allowed/blocked namespace lists, fix wildcard (*) handling when combined with explicit entries, and reject empty default-namespace values.

### 클러스터 리졸버의 와일드카드 차단 수정

- 영향 대상: `*`와 `blocked-namespaces`의 명시적 항목을 함께 사용하는 클러스터 리졸버 구성

이전에는 `"*,kube-system"` 같은 조합 형식이 의도한 대로 네임스페이스를 차단하지 못했으며, 실패 사실도 드러나지 않았습니다.

> * :bug: fix: cluster resolver namespace access control whitespace and wildcard bugs (#9592)
> ix cluster resolver namespace access control: trim whitespace in allowed/blocked namespace lists, fix wildcard (*) handling when combined with explicit entries, and reject empty default-namespace values.

## 호환성 변경 (3)

### 클러스터 리졸버의 빈 `default-namespace` 값 거부

- 영향 대상: 빈 `default-namespace` 값을 사용하는 클러스터 리졸버 구성

기본 제공되는 `default-namespace: ""` 값은 이전에는 누락된 매개변수라는 알림 없이 네임스페이스 검사를 통과했습니다.

근거: “`default-namespace: ""` (the shipped default) passes an empty string through all namespace checks instead of reporting a missing parameter” https://github.com/tektoncd/pipeline/pull/9592

> * :bug: fix: cluster resolver namespace access control whitespace and wildcard bugs (#9592)
> ix cluster resolver namespace access control: trim whitespace in allowed/blocked namespace lists, fix wildcard (*) handling when combined with explicit entries, and reject empty default-namespace values.

### TaskRun pod 지연 시간 메트릭, `pod` 레이블 없는 히스토그램으로 변경

- 영향 대상: 대시보드나 알림에서 `tekton_pipelines_controller_taskruns_pod_latency_milliseconds`를 참조하는 환경
- 필요 조치: 직접 값 쿼리 대신 `histogram_quantile()`을 사용해야 하는 대시보드 또는 알림

대규모 클러스터에서는 기존의 TaskRun별 `pod` 시계열이 활성 시계열 1.2M개를 넘을 수 있어 Prometheus 스크레이프 시간 초과와 Tekton 메트릭 손실이 발생할 수 있었습니다. 대체 메트릭은 히스토그램 버킷, sum, count 시계열을 노출합니다.

> * :bug: fix: convert pod latency metric to histogram and remove pod label (#9530)
> ction required: The `tekton_pipelines_controller_taskruns_pod_latency_milliseconds` metric has been converted from a Gauge to a Histogram and the `pod` label has been removed. Dashboards or alerts referencing this metric will need to be updated to use `histogram_quantile()` instead of direct value queries.

### 기본 Jaeger 트레이싱 엔드포인트 변경

- 영향 대상: `config-tracing.yaml`에서 기본 엔드포인트를 사용하도록 설정한 트레이싱

기본 엔드포인트는 이전에 `http://jaeger-collector.jaeger.svc.cluster.local:14268/api/traces`였으며, 업그레이드 후에는 `http://jaeger-collector.jaeger.svc.cluster.local:4318/v1/traces`로 변경됩니다. 명시적으로 설정한 엔드포인트도 변경되는지는 노트에 나와 있지 않습니다.

근거: “-* endpoint: API endpoint for jaeger collector to send the traces. By default the endpoint is configured to be `http://jaeger-collector.jaeger.svc.cluster.local:14268/api/traces`. +* endpoint: API endpoint for jaeger collector to send the traces. By default the endpoint is configured to be `http://jaeger-collector.jaeger.svc.cluster.local:4318/v1/traces`.” https://github.com/tektoncd/pipeline/pull/9141

> * :bug: fix: update default tracing endpoint to http protobuf endpoint (#9141)

## 중요 수정 (11)

### [드러나지 않던 결함] `GetNameAndNamespace`의 네임스페이스 폴백 대신 명시적 오류 반환

- 영향 대상: 요청이나 소유 객체에 네임스페이스가 없는 ResolutionRequest (추정)

요청이나 이를 소유한 객체 어느 쪽에서도 네임스페이스를 제공하지 않으면, 메서드는 조용히 `default`를 사용했습니다. 이로 인해 잘못된 네임스페이스에 `ResolutionRequest`가 생성되고, Kubernetes 가비지 컬렉션에서 무시되는 OwnerReference가 설정될 수 있었습니다. 이제는 대신 명시적 오류를 반환합니다.

> * :bug: fix: replace silent default namespace fallback with explicit error in GetNameAndNamespace (#9594)
> eplace silent "default" namespace fallback in GetNameAndNamespace with an explicit error, preventing potential ResolutionRequest creation in wrong namespace.

### [드러나지 않던 결함] 리졸루션 프레임워크 요청 이름 조회 수정

- 영향 대상: 리졸루션 프레임워크에서 요청 네임스페이스와 이름 컨텍스트 값을 주입하고 읽는 코드

요청 이름보다 네임스페이스를 먼저 주입하면 컨텍스트 키가 충돌해 이름 주입이 조용히 실패하고, `RequestName()`이 네임스페이스 문자열을 반환했습니다.

> * :bug: fix: resolve context key collision and ownerRef nil panic in resolution framework (#9593)
> ix context key collision in resolution framework where RequestName() silently returned the namespace value, and fix nil pointer panic in ownerRefsAreEqual when both Controller fields are nil.

### `running_taskruns` 메트릭 과다 집계 수정

- 영향 대상: `running_taskruns` 메트릭을 사용하는 설정

첫 리컨실 전에 condition이 설정되지 않은 새 `TaskRun`이 실행 중으로 집계될 수 있었습니다.

> * :bug: Fix running_taskruns metric overcounting TaskRuns with no condition (#9485)
> Fixed overcounting in the `running_taskruns` metric for `TaskRun`s with no condition set yet.

### `PipelineRun` 취소 시 duration 및 count 메트릭 기록

- 영향 대상: 취소된 `PipelineRun`의 duration 및 count 메트릭을 사용하는 설정 (추정)

취소 처리 중 `reconcile()`을 호출하지 않고 `cancelPipelineRun()`에서 바로 반환하면 duration 및 count 관측값이 오류 없이 누락됐습니다. 이제 이 경로에서도 관측값을 기록합니다.

> * :bug: fix: record metrics for cancelled PipelineRuns (#9658)

### 리포지토리별 SSH 키 선택 수정

- 영향 대상: 하나의 Git 서버에서 서로 다른 리포지토리용 SSH 인증 시크릿을 여러 개 사용하고, 시크릿 어노테이션 URL에 리포지토리 경로가 포함된 경우

이전에는 모든 리포지토리에서 첫 번째 SSH 키를 사용해 배포 키 인증에 실패했습니다. 이제 각 리포지토리에 맞는 키를 선택합니다.

> * :bug: Fix: Add SSH Host aliases to support multiple SSH credentials on same host (#9643)
> Fixed SSH credential matching to support multiple repositories on the same host with different SSH keys. Previously, when using multiple SSH auth secrets for different repositories on the same Git server (e.g., github.com/org/repo1 and github.com/org/repo2), SSH would use the first key for all repositories, causing authentication failures with deploy keys. SSH Host aliases and Git `url.*.insteadOf` rewriting now enable per-repository SSH key selection when the secret annotation URL includes a repo path.

### `step-init` 반복 실행 시 심볼릭 링크 오류 수정

- 영향 대상: `step-init`의 심볼릭 링크가 공유 볼륨에 남아 있는 파드

OOM 또는 축출 후처럼 파드 내 컨테이너가 재시작되고 이전 실행에서 만든 심볼릭 링크가 공유 볼륨에 남아 있으면 `step-init`이 `symlink: file exists` 오류와 함께 실패했습니다. 이제 다시 실행할 때 기존 링크를 허용합니다.

> * :bug: fix: make step-init symlink creation idempotent (#9600)
> ix entrypoint step-init to handle container restarts gracefully. Previously, if a container restarted within a pod (e.g. due to OOM or eviction), the init process would fail with "symlink: file exists" because symlinks from the previous run persisted on the shared volume.

### Resolution-framework owner-reference 비교 중 nil 포인터 패닉 수정

- 영향 대상: Resolution-framework의 owner-reference 비교

`a.Controller`와 `b.Controller`가 모두 nil이면 `ownerRefsAreEqual`이 두 값을 역참조해 컨트롤러에서 패닉이 발생했습니다. 이제 역참조하기 전에 두 값이 모두 nil인 경우를 확인합니다.

> * :bug: fix: resolve context key collision and ownerRef nil panic in resolution framework (#9593)
> ix context key collision in resolution framework where RequestName() silently returned the namespace value, and fix nil pointer panic in ownerRefsAreEqual when both Controller fields are nil.

### Tekton 자격 증명 볼륨 이름 충돌 수정

- 영향 대상: 어노테이션된 시크릿을 통한 Tekton 자격 증명 주입

네임스페이스에 어노테이션된 시크릿이 118개 이상 있으면, 특히 이름의 접두사가 비슷한 시크릿끼리 볼륨 이름이 충돌할 수 있었습니다. 이제 볼륨 이름은 임의 접미사를 붙이고 이름을 자르는 대신, 전체 시크릿 이름에 결정적 SHA-256 해시를 적용합니다.

> * :bug: fix: use hashed volume names to prevent credential volume name collisions (#9528)
> ix credential volume name collisions when namespaces have many (118+)
> annotated secrets. Volume names now use deterministic SHA-256 hashing
> instead of truncation with random suffix.

### 하위 TaskRun에도 적용되는 더 긴 `PipelineRun` 타임아웃

- 영향 대상: `PipelineRun`의 태스크 또는 finally 타임아웃이 전역 기본값보다 길고, 하위 TaskRun에 태스크별 타임아웃이 명시되지 않은 경우

이전에는 웹훅이 해당 하위 TaskRun에 전역 기본값(보통 1h)을 적용해, 더 긴 `PipelineRun` 타임아웃이 끝나기 전에 취소될 수 있었습니다. 이제 하위 TaskRun에도 더 긴 `PipelineRun` 타임아웃이 적용됩니다. 태스크별 타임아웃을 명시한 경우에는 해당 타임아웃이 계속 우선합니다.

> * :bug: fix: propagate PipelineRun tasks/finally timeout to child TaskRuns (#9419)
> When `spec.timeouts.tasks` or `spec.timeouts.finally` on a PipelineRun exceeds the global default timeout, the value is now propagated to individual child TaskRuns that do not have an explicit per-task timeout. This prevents TaskRuns from being prematurely canceled at the global default (e.g., 1h) when the PipelineRun allows a longer duration.

### Git 자격 증명의 저장소 경로별 매칭 수정

- 영향 대상: 같은 Git 서버의 저장소에 사용할 Git 자격 증명 시크릿이 여러 개이고, 어노테이션 URL에 저장소 경로가 있는 경우

이전에는 Git이 호스트 이름만으로 자격 증명을 매칭해 모든 저장소에 첫 번째 자격 증명을 사용할 수 있었고, 이로 인해 인증이 실패할 수 있었습니다. 이제 전체 저장소 URL을 기준으로 자격 증명을 선택하며, 호스트 이름만 지정한 자격 증명은 폴백으로 유지합니다.

> * :bug: Fix: Add useHttpPath to support multiple Git credentials on same host (#9143)
> Fixed Git credential matching to support multiple repositories on the same host with different credentials. Previously, when using multiple secrets for different repositories on the same Git server (e.g., github.com/org/repo1 and github.com/org/repo2), it incorrectly use the first credential for all repositories, causing authentication failures. Git credential contexts now include `useHttpPath = true`, enabling proper per-repository credential selection.

### 리졸버 옵저버빌리티 메타데이터 복원

- 영향 대상: 리졸버 배포의 `config/resolvers/config-observability.yaml` 설정

OTel 마이그레이션 중 네임스페이스가 `tekton-pipelines`로 변경되고 `app.kubernetes.io/component: resolvers` 레이블이 제거되었습니다. 이제 네임스페이스는 `tekton-pipelines-resolvers`이고 레이블은 복원되었으며, OTel 설정 내용은 변경되지 않았습니다.

> * :bug: fix: revert mistaken metadata changes in resolvers config-observability (#9468)

## 기능·개선 (4)

- 웹훅의 설정된 TLS 정책 상속 (사용 조건: 해당되는 `WEBHOOK_TLS_MIN_VERSION`, `WEBHOOK_TLS_MAX_VERSION`, `WEBHOOK_TLS_CIPHER_SUITES` 및/또는 `WEBHOOK_TLS_CURVE_PREFERENCES` 환경 변수)
- 요청별 URL 및 순서가 적용되는 Hub Resolver 폴백 (사용 조건: `artifact-hub-urls` 또는 `tekton-hub-urls` ConfigMap 키, 또는 해석별 `url` 매개변수)
- TaskRun 실행 보류 지원
- `volumeClaimTemplate` 워크스페이스 PVC 자동 정리 (사용 조건: `coschedule: workspaces`를 사용하는 PipelineRun에서 `tekton.dev/auto-cleanup-pvc`를 정확히 `"true"`로 설정)

## 의존성 갱신 (45)

그 외 45건 · 보안 언급 없음

- `* :hammer: chore: bump knative.dev/pkg to main and k8s libs to 0.35.1 (#9470)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9652)`
- `* :hammer: build(deps): bump github/codeql-action from 4.33.0 to 4.34.1 (#9651)`
- `* :hammer: build(deps): bump actions/cache from 5.0.3 to 5.0.4 (#9650)`
- `* :hammer: build(deps): bump chainguard-dev/actions from 1.6.8 to 1.6.9 (#9649)`
- `* :hammer: build(deps): bump github.com/spiffe/spire-api-sdk from 1.14.3 to 1.14.4 (#9648)`
- `* :hammer: build(deps): bump k8s.io/apimachinery from 0.35.2 to 0.35.3 (#9639)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.35.2 to 0.35.3 (#9638)`
- `* :hammer: build(deps): bump k8s.io/api from 0.34.5 to 0.34.6 in /test/custom-task-ctrls/wait-task-beta (#9637)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.34.5 to 0.34.6 in /test/custom-task-ctrls/wait-task-beta (#9634)`
- `* :hammer: build(deps): bump github.com/spiffe/spire-api-sdk from 1.14.1 to 1.14.3 (#9629)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.79.2 to 1.79.3 (#9628)`
- `* :hammer: build(deps): bump github.com/google/go-containerregistry from 0.21.2 to 0.21.3 (#9627)`
- `* :hammer: build(deps): bump github.com/tektoncd/pipeline from 1.10.0 to 1.10.2 in /test/custom-task-ctrls/wait-task-beta (#9626)`
- `* :hammer: build(deps): bump golang.org/x/sync from 0.19.0 to 0.20.0 (#9611)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9587)`
- `* :hammer: build(deps): bump github/codeql-action from 4.32.6 to 4.33.0 (#9586)`
- `* :hammer: build(deps): bump fgrosse/go-coverage-report from 1.2.0 to 1.3.0 (#9585)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.15.1 to 2.16.0 (#9584)`
- `* :hammer: build(deps): bump chainguard-dev/actions from 1.6.7 to 1.6.8 (#9583)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/trace from 1.41.0 to 1.42.0 (#9549)`
- `* :hammer: build(deps): bump github.com/google/go-containerregistry from 0.21.1 to 0.21.2 (#9548)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.79.1 to 1.79.2 (#9547)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.15.0 to 2.15.1 (#9542)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9541)`
- `* :hammer: build(deps): bump tj-actions/changed-files from 47.0.4 to 47.0.5 (#9540)`
- `* :hammer: build(deps): bump chainguard-dev/actions from 1.6.5 to 1.6.7 (#9539)`
- `* :hammer: build(deps): bump github/codeql-action from 4.32.5 to 4.32.6 (#9538)`
- `* :hammer: build(deps): bump actions/dependency-review-action from 4.8.3 to 4.9.0 (#9536)`
- `* :hammer: build(deps): bump k8s.io/apiextensions-apiserver from 0.35.1 to 0.35.2 (#9487)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9483)`
- `* :hammer: build(deps): bump github/codeql-action from 4.32.4 to 4.32.5 (#9482)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.14.2 to 2.15.0 (#9481)`
- `* :hammer: build(deps): bump actions/setup-go from 6.2.0 to 6.3.0 (#9480)`
- `* :hammer: build(deps): bump chainguard-dev/actions from 1.6.4 to 1.6.5 (#9479)`
- `* :hammer: build(deps): bump actions/upload-artifact from 6.0.0 to 7.0.0 (#9478)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/metric from 1.40.0 to 1.41.0 (#9477)`
- `* :hammer: build(deps): bump k8s.io/apimachinery from 0.35.1 to 0.35.2 (#9476)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.34.3 to 0.34.5 in /test/custom-task-ctrls/wait-task-beta (#9475)`
- `* :hammer: build(deps): bump k8s.io/code-generator from 0.35.1 to 0.35.2 (#9473)`
- `* :hammer: build(deps): bump k8s.io/api from 0.34.3 to 0.34.5 in /test/custom-task-ctrls/wait-task-beta (#9472)`
- `* :hammer: build(deps): bump k8s.io/apiextensions-apiserver from 0.34.3 to 0.34.5 (#9455)`
- `* :hammer: build(deps): bump github.com/tektoncd/pipeline from 1.9.1 to 1.10.0 in /test/custom-task-ctrls/wait-task-beta (#9453)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.34.3 to 0.34.4 (#9447)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/trace from 1.39.0 to 1.40.0 (#9445)`

## 기타 (27)

- CI에 Gitea 엔드투엔드 테스트 추가 및 memcached 픽스처 시작 인수 수정
- 이름 생성 오류에서 항목을 `resource`로 식별
- Resolver 캐시에서 동시 리졸루션 중복 제거
- 세 개의 GitHub Actions 워크플로에 명시적 최상위 권한 블록 추가
- TaskRun 예시의 이미지 참조 고정
- 예제 TaskRun 이미지 참조를 digest로 고정
- Bash, Alpine, Busybox 이미지 참조를 digest로 고정
- `examples/v1/taskruns`의 Ubuntu 이미지 참조를 digest로 고정
- Pipeline 상태 해석당 `VerificationPolicy` 목록 1회 조회
- GitHub Actions 보안 문제 수정 및 zizmor CI 검사 추가
- PipelineRun 하위 리소스 레이블 조회를 `memberOfLookup`으로 이동
- 문서와 스크립트의 레거시 GCS 릴리스 URL 교체
- Gitea 테스트 인프라 1.25.4 업그레이드
- Resolved TaskSpec 저장 관련 설명 명확화
- 테스트 파일에서 `opencensus` 의존성 제거
- `tj-actions/changed-files` 버전 코멘트 v47.0.5로 업데이트
- 릴리스 치트 시트와 파이프라인에서 `release.notags.yaml` 사용
- Pipeline API 문서 생성 복구 및 공개 문서 업데이트
- `auth.md`의 오래된 TODO 제거
- 인증 문서의 Step 자격 증명과 `imagePullSecrets` 구분
- 보안 패치 릴리스를 반영한 `releases.md` 업데이트
- 메트릭 문서에 기존에 문서화되지 않았던 메트릭 네 개 추가
- 깨진 내부 Markdown 링크 수정
- `PipelineRun` 및 `TaskRun` 예제에 README 파일 추가
- `taskruns.md`의 Tekton Bundles 예제 링크 오류 수정
- v1.10.0용 `releases.md` 업데이트
- TaskRun 문서의 `tkn bundle` CLI 문서 링크

---

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