# Tekton v1.12.0

2026-05-04 · [元のリリースノート](https://github.com/tektoncd/pipeline/releases/tag/v1.12.0) · [全体のまとめ](https://ratatosk.io/ja/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 resolver のレスポンスサイズ制限

- 影響対象: HTTP resolver を使用する環境

> * :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 シンクが設定されている CustomRuns
- 削除予定: 不明

以前は、`send-cloudevents-for-runs` を `true` に設定しない限り、CustomRun の CloudEvents は送信されませんでした。現在は、`config-events` でシンクが設定されていれば送信されます。ただし、`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`）、ステップの OOM または失敗（`StepOOM`、`StepFailed`）、サイドカーの OOM または失敗（`SidecarOOM`、`SidecarFailed`）を理由として識別します。不明な失敗には引き続き `Failed` が使われます。複数の失敗が発生した場合、理由の優先順位は Pod の退避、init コンテナーの失敗、サイドカーの OOM、ステップの OOM、サイドカーの失敗、ステップの失敗の順です。

根拠: “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.

### run オブジェクトの重複 CloudEvents を抑制

- 影響対象: run オブジェクト用に設定された CloudEvents シンク
- 必要な対応: 同一リソースの reconcile サイクルが並行実行されないよう、Controller の concurrency を 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 を送信していましたが、現在は専用コントローラーが送信します。また、キューに入れられるイベントタイプが2種類利用可能になりました。`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 の結果欠落メッセージでタスクと結果を特定

- 影響対象: タスクの結果を消費する後続タスクがある PipelineRun

正常に完了したタスクが、後続タスクから参照されている結果を出力しなかった場合、従来は件数だけを報告していました。現在はタスク名、欠落した結果名、後続タスク名を示し、詳細は最大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 が設定されていれば送信されるようになりました。

> ### :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)

- タスクの結果検証失敗に対する Kubernetes Warning イベント
- 完了済み PipelineRun の調整で重複処理を省略
- TaskRun のクリーンアップでデフォルト値を適用しなくなる
- PipelineRun と TaskRun の map 比較を `maps.Equal` に切り替え
- Events コントローラーのキャッシュを bigcache とハッシュ化キーに切り替え
- リリースパイプラインによるカテゴリー別 GitHub リリース下書きの作成
- CI ワークフローでの `tj-actions/changed-files` から `git diff` への置き換え
- LTS リリースブランチ向けの Dependabot 自動設定
- `TestEmit` テストのテーブル駆動構成の削除
- `TaskRun` の Pending ライフサイクルに関するエンドツーエンドテストの追加
- 生成された fake clientset 群を `k8s.io/code-generator` 0.35.3 に合わせて更新
- Bundle resolver のオプションの既定値と必須条件の文書化
- OpenCensus から OpenTelemetry への移行に伴うメトリクスのドキュメント更新
- Examples README の v1 apply パスの更新

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
