# Tekton v1.10.0

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

호환성 변경 4 · 폐기 예정 1 · 중요 수정 3 · 기능·개선 1 · 의존성 갱신 23 · 기타 37

## 업그레이드 전 확인

### 전제 조건

- **Observability 메트릭 전송 대상 설정 변경**: `config-observability` ConfigMap에서는 `metrics.backend-destination` 대신 `metrics-protocol`을 사용하고, 값을 `prometheus`, `grpc` 또는 `http`로 설정해야 합니다. 이미 Prometheus를 사용하고 있다면 변경할 필요가 없습니다.
  >   Upgrade actions:
  >   1. **Update Config**: Ensure your `config-observability` ConfigMap uses `metrics-protocol: prometheus` (or `grpc`/`http`) instead of the old `metrics.backend-destination`. If prometheus was already being used, no changes are needed.

### 업그레이드 안내

- **전체 메트릭 마이그레이션 표**
  >   See the [full migration table in PR #9043](https://github.com/tektoncd/pipeline/pull/9043) for complete details.

## 호환성 변경 (4)

### Tekton 인프라 메트릭 이름 변경

- 영향 대상: Go 런타임, Workqueue 또는 Kubernetes 클라이언트 메트릭을 포함한 Tekton 인프라 메트릭을 수집하거나 조회하는 설정
- 필요 조치: Prometheus를 이미 사용 중인 경우가 아니라면 `config-observability`에서 `metrics.backend-destination` 대신 `metrics-protocol: prometheus`(또는 `grpc`/`http`)를 사용하도록 설정 업데이트; 대시보드 쿼리를 새 메트릭 이름으로 업데이트하고 추가된 `reason` 레이블을 고려해 `pipelinerun_duration_seconds` 집계 확인

이 메트릭은 이전에 `tekton_pipelines_controller_` 접두사를 사용했습니다. 예를 들어 `tekton_pipelines_controller_workqueue_adds_total`이 있었습니다. 이제 `kn_workqueue_adds_total`, `http_client_request_duration_seconds`, `go_*`와 같은 이름으로 내보냅니다.

> * :rotating_light: **Metrics migration from OpenCensus to OpenTelemetry** (#9043)
>   **ACTION REQUIRED**: Infrastructure metrics (Go runtime, Workqueue, K8s Client) have been renamed from the `tekton_pipelines_controller_` prefix to standard OpenTelemetry/Knative namespaces. The `reason` label has been added to duration metrics (`pipelinerun_duration_seconds`, `taskrun_duration_seconds`). The `reconcile_count` and `reconcile_latency` metrics have been removed.

### Tekton 컨트롤러 reconcile 메트릭 제거

- 영향 대상: 두 커스텀 reconcile 메트릭 중 하나를 사용해 컨트롤러 성능을 모니터링하는 경우

PR에서는 컨트롤러 성능 모니터링에 `kn_workqueue_process_duration_seconds`와 `kn_workqueue_adds_total`을 사용하도록 안내합니다.

근거: “3. Removed Metrics * `tekton_pipelines_controller_reconcile_count` and `tekton_pipelines_controller_reconcile_latency`: These custom reconcile metrics are no longer emitted. Users should rely on kn_workqueue_process_duration_seconds and kn_workqueue_adds_total to monitor controller performance.” https://github.com/tektoncd/pipeline/pull/9043

>   **ACTION REQUIRED**: Infrastructure metrics (Go runtime, Workqueue, K8s Client) have been renamed from the `tekton_pipelines_controller_` prefix to standard OpenTelemetry/Knative namespaces. The `reason` label has been added to duration metrics (`pipelinerun_duration_seconds`, `taskrun_duration_seconds`). The `reconcile_count` and `reconcile_latency` metrics have been removed.

### PipelineRun 및 TaskRun 메트릭의 OpenTelemetry 전환

- 영향 대상: PipelineRun, TaskRun 또는 인프라 메트릭을 수집하거나 조회하는 구성 (추정)
- 필요 조치: Prometheus를 이미 사용 중인 경우가 아니라면 `config-observability` ConfigMap에서 `metrics.backend-destination` 대신 `metrics-protocol: prometheus` 또는 `metrics-protocol: grpc/http`를 사용하고, 대시보드는 이전 이름 대신 `kn_workqueue_*` 및 `go_*`를 사용하며, 기간 집계에는 `reason` 레이블을 반영해야 함

기존에는 인프라 메트릭에 `tekton_pipelines_controller_` 접두사가 사용됐고, 기간 메트릭에는 `reason` 레이블이 없었으며, 커스텀 reconcile 메트릭 두 개가 제공됐습니다. 이제 인프라 메트릭에는 `kn_workqueue_*`, `go_*`를 비롯한 표준 OpenTelemetry 및 Knative 이름이 사용됩니다. 기간 메트릭에는 `reason` 레이블이 추가되고, 커스텀 reconcile 메트릭은 더 이상 제공되지 않습니다.

근거: “* `tekton_pipelines_controller_reconcile_count` and `tekton_pipelines_controller_reconcile_latency`: These custom reconcile metrics are no longer emitted. Users should rely on” https://github.com/tektoncd/pipeline/pull/9043

> * :sparkles: feat(metrics): Migrate from OpenCensus to OpenTelemetry (#9043)
>   Migrated PipelineRun and TaskRun metrics to OpenTelemetry instruments (histograms, counters, gauges). Updated Knative to 1.19. See [Upgrade Notices](#upgrade-notices) for breaking changes and required actions.

### 메트릭 설정을 `metrics-protocol`로 전환

- 영향 대상: `config-observability` ConfigMap의 메트릭 설정

기존 `metrics.backend-destination` 설정은 `metrics-protocol`로 대체되며, 값은 `prometheus`, `grpc`, `http` 중 하나입니다. 이미 Prometheus를 사용하는 설치 환경은 설정을 변경할 필요가 없습니다. 인프라 메트릭은 이제 `tekton_pipelines_controller_` 접두사 대신 OpenTelemetry/Knative 표준 네임스페이스를 사용하며, `reconcile_count`와 `reconcile_latency`는 제거됩니다.

근거: “1. **Update Config**: Ensure your `config-observability` ConfigMap uses `metrics-protocol: prometheus` (or `grpc`/`http`) instead of the old `metrics.backend-destination`. If prometheus was already being used, no changes are needed.” https://github.com/tektoncd/pipeline/releases/tag/v1.10.0

>   Migrated PipelineRun and TaskRun metrics to OpenTelemetry instruments (histograms, counters, gauges). Updated Knative to 1.19. See [Upgrade Notices](#upgrade-notices) for breaking changes and required actions.

## 폐기 예정 (1)

### 호환성을 위해 사용되지 않는 `featureFlags.EnableTektonOCIBundles` 필드 허용

- 영향 대상: `featureFlags.EnableTektonOCIBundles`를 포함하는 PipelineRun 및 TaskRun 리소스 (추정)
- 제거 시점: 미상

이전에는 `EnableTektonOCIBundles`를 알 수 없는 필드로 처리했습니다. 이제는 이 필드를 받아들이지만 아무 효과도 없습니다. v0.62.x 이전에 생성된 PipelineRun을 삭제할 수 있도록 필드를 유지합니다.

> * :bug: accept featureFlags.EnableTektonOCIBundles to fix unknown field error (#8996)

## 중요 수정 (3)

### 중복된 `ResolutionRequest` 단축 이름 제거

- 영향 대상: Kubernetes 1.33+에서 `ResolutionRequest` CRD를 사용하는 설치 환경

Kubernetes 1.33+에서는 중복된 단축 이름으로 인해 CRD에 `ShortNamesConflict` 조건이 발생했습니다.

> * :bug: fix: Remove redundant shortNames from ResolutionRequest CRD (#9398)
>   Remove redundant shortNames from ResolutionRequest CRD that caused ShortNamesConflict on Kubernetes 1.33+

### PipelineRun 검증에서 기본값의 비매개변수 변수 허용

- 영향 대상: 파이프라인 매개변수 기본값에서 매개변수가 아닌 변수를 사용하는 PipelineRun

이전에는 파이프라인 매개변수의 기본값이 `$(context.pipelineRun.name)` 같은 값을 참조하면 검증이 실패했습니다. 이제 이러한 기본값도 오류 없이 검증됩니다.

> * :bug: fix(pipelines): allow pipeline param defaults to use non-param variables (#9386)
>   Fixed a bug which caused PipelineRun validation to fail when a pipeline parameter's default value referenced a non-parameter variable (e.g. `$(context.pipelineRun.name)`)

### 실패·취소·시간 초과 태스크의 출력도 포함하는 파이프라인 수준 결과

- 영향 대상: 실패, 취소 또는 시간 초과된 태스크의 출력을 참조하는 파이프라인 수준 결과가 있는 PipelineRuns

이전에는 이러한 참조가 해석되지 않은 변수 문자열로 남을 수 있었습니다. 이제 실패, 취소 또는 시간 초과 상태로 완료된 태스크의 결과가 파이프라인 수준 결과에 포함됩니다.

> * :bug: fix: pipeline-level results not recorded from failed tasks (#9367)
>   Pipeline-level results now include results from failed, cancelled, and timed-out tasks, fixing cases where results referencing non-successful task outputs were left as unresolved variable strings.

## 기능·개선 (1)

- Git 리졸버의 SHA-256 커밋 해시 인식

## 의존성 갱신 (23)

그 외 23건 · 보안 언급 없음

- `Migrated PipelineRun and TaskRun metrics to OpenTelemetry instruments (histograms, counters, gauges). Updated Knative to 1.19. See [Upgrade Notices](#upgrade-notices) for breaking changes and required actions.`
- `* :hammer: build(deps): bump golang.org/x/crypto from 0.36.0 to 0.45.0 in /test/resolver-with-timeout (#9426)`
- `* :hammer: build(deps): bump opentelemetry exporter packages to v1.39.0 (#9332)`
- `* :hammer: build(deps): bump github.com/google/go-containerregistry from 0.21.0 to 0.21.1 (#9433)`
- `* :hammer: build(deps): bump github.com/google/go-containerregistry from 0.20.7 to 0.21.0 (#9418)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.79.0 to 1.79.1 (#9392)`
- `* :hammer: build(deps): bump github.com/jenkins-x/go-scm from 1.15.16 to 1.15.17 (#9391)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.78.0 to 1.79.0 (#9389)`
- `* :hammer: build(deps): bump k8s.io/code-generator from 0.32.11 to 0.32.12 (#9388)`
- `* :hammer: build(deps): bump k8s.io/apiextensions-apiserver from 0.32.11 to 0.32.12 (#9385)`
- `* :hammer: build(deps): bump k8s.io/apimachinery from 0.33.7 to 0.33.8 (#9384)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.32.11 to 0.32.12 (#9383)`
- `* :hammer: build(deps): bump github/codeql-action from 4.32.1 to 4.32.2 (#9374)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9373)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.14.1 to 2.14.2 (#9372)`
- `* :hammer: build(deps): bump tj-actions/changed-files from 47.0.1 to 47.0.2 (#9371)`
- `* :hammer: build(deps): bump chainguard-dev/actions from 1.5.14 to 1.5.16 (#9370)`
- `* :hammer: build(deps): bump golang.org/x/crypto from 0.47.0 to 0.48.0 (#9369)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.39.0 to 1.40.0 (#9363)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.37.0 to 1.40.0 (#9345)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.77.0 to 1.78.0 (#9337)`
- `* :hammer: build(deps): bump github.com/spiffe/spire-api-sdk from 1.14.0 to 1.14.1 (#9336)`
- `* :hammer: build(deps): bump sigstore/sigstore from 1.9.5 to 1.10.4 (#9331)`

## 기타 (37)

- PipelineRun 및 TaskRun duration 메트릭에 `reason` 라벨 추가
- `/rebase` 풀 리퀘스트 워크플로 추가
- 통합 CI 요약 작업이 e2e 전용 fan-in 작업을 대체
- resolver cache 설정 처리에 프레임워크의 맵 기반 방식 적용
- GoSec 진단 항목 평가 및 `nosec` 주석 추가
- 체리픽 재실행 시 기존 PR 브랜치 초기화 및 강제 푸시
- 포크 pull request 커밋을 가져오는 체리픽 워크플로
- `github/codeql-action` 의존성 4.32.4로 업데이트
- `/tekton`의 `chainguard/crane` 이미지 핀 업데이트
- 고정된 `chainguard/go` 이미지 업데이트
- `/tekton`의 `tektoncd/plumbing/ko` 핀 업데이트
- `/tekton`의 `tektoncd/plumbing/koparse` 핀 업데이트
- `tj-actions/changed-files` 의존성 버전 47.0.2에서 47.0.4로 업데이트
- `actions/dependency-review-action` 4.8.2에서 4.8.3으로 업데이트
- `chainguard-dev/actions` 1.6.1에서 1.6.4로 업데이트
- timeout resolver 테스트의 Sigstore 의존성 업데이트
- `/test/custom-task-ctrls/wait-task-beta`의 `github.com/tektoncd/pipeline`을 1.9.1로 업데이트
- `/tekton`의 `chainguard/crane` 이미지 업데이트
- `/tekton`의 `chainguard/go` 이미지 다이제스트 업데이트
- `tektoncd/plumbing/ko` 이미지 핀 업데이트
- `/tekton`에서 `tektoncd/plumbing/koparse` 이미지 핀 업데이트
- `github/codeql-action` 4.32.3으로 업데이트
- `chainguard-dev/actions`의 1.6.1 업데이트
- wait-task-beta 테스트의 `k8s.io/client-go` 의존성 업데이트
- `/test/custom-task-ctrls/wait-task-beta`에서 `k8s.io/api`를 0.32.12로 업데이트
- wait-task-beta의 `k8s.io/apimachinery` 의존성 업데이트
- e2e 테스트 헬스 상태 결과 간소화
- `tekton/publish.yaml`에서 사용하는 이미지 업데이트
- `chainguard-dev/actions` 1.5.13에서 1.5.14로 업데이트
- `github/codeql-action`을 4.32.1로 업데이트
- `actions/cache` 5.0.3으로 업데이트
- `github.com/tektoncd/pipeline` 의존성을 1.7.0에서 1.9.0으로 업데이트
- wait-task-beta의 `github.com/tektoncd/pipeline` v1.7.0 업데이트
- 컨트롤러 플래그 및 환경 변수 문서 명확화와 수정
- `releases.md`의 릴리스 수명 주기 목록 업데이트
- GitHub Projects 로드맵 안내를 추가한 `roadmap.md`
- PipelineRun과 workspace 문서 예제 업데이트

---

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