# Tekton v1.13.0

2026-05-29 · [元のリリースノート](https://github.com/tektoncd/pipeline/releases/tag/v1.13.0) · [全体のまとめ](https://ratatosk.io/ja/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` 通知識別子ログのデバッグレベルへの移行

- 影響対象: `TaskRun` 通知の調整処理
- 追加の対応: トレースをエクスポートする場合は、CloudEvents シンクと同等以上に厳格なアクセス制御を備えた信頼できるバックエンド。マルチテナント環境でトレースを有効にする前に確認済みの保持ポリシーとアクセス制御ポリシー

従来、この処理経路では `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 以外を解決すると、データが書き込まれる前に 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 のラベルとメトリクスにサニタイズ済みの `generateName` を使用

- 影響対象: `metadata.generateName` を設定した inline-spec Pipeline

以前は、これらの実行から作成される TaskRun では、`tekton.dev/pipeline` ラベルと `pipeline` メトリクスタグに 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 condition context を保持

- 影響対象: タイムアウトを設定した PipelineRun が管理する TaskRun

以前は、PipelineRun のタイムアウトによって子 TaskRun の `status.conditions` が上書きされ、`ExceededResourceQuota` などの詳細が失われることがありました。新しい失敗メッセージには、以前の condition の 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 を適用

- 影響対象: `bundleresolver-config` や `git-resolver-config` など、リゾルバー固有の TTL が 0 より大きいリゾルバーの ConfigMap

これまでは、リゾルバーの ConfigMap で正の TTL が設定されていても、キャッシュエントリーには常にグローバルな `resolver-cache-config` の TTL が使われていました。今後は、リゾルバー固有の TTL が 0 より大きい場合はその値を使い、それ以外の場合はグローバルな 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退避後にPipelineRunが早期に失敗する問題の修正

- 影響対象: PodベースのTaskRunを持つPipelineRun

Podの退避後、TaskRunのステータスがRunningに更新されるまでの競合により、古いキャッシュ済みの失敗情報を使って、TaskRunが復旧してもPipelineRunが恒久的に失敗することがありました。キャッシュされた `PodEvicted` の失敗について、コントローラーは調整ごとに失敗したTaskRunごとに1回、APIサーバーへGETリクエストを送り、新しいステータスを使用するようになりました。NotFound以外の理由で検証に失敗した場合、調整はエラーを返します。

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

### アフィニティアシスタントのボリューム名を Kubernetes の上限内に収める修正

- 影響対象: `AffinityAssistantPerPipelineRun` または `AffinityAssistantPerPipelineRunWithIsolation` モードのアフィニティアシスタントのうち、ワークスペースの `volumeClaimTemplate` 名から生成されるボリューム名が63文字を超えるもの (推定)

長い `volumeClaimTemplate.metadata.name` によって、生成されるボリューム名が Kubernetes の63文字制限を超え、アフィニティアシスタントの 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 タスクを実行

- 影響対象: finally タスクを持つ PipelineRun

明示的な `timeouts.tasks` のタイムアウト、または計算された `timeouts.pipeline - timeouts.finally` のタイムアウトを超過した時点で finally タスクが残っていると、PipelineRun は直ちに Failed と判定され、タスクは実行されませんでした。現在は、保留中の finally タスクが完了するまで 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 承認済み ID と DCO 署名を使用
- `dependabot-regen` ワークフローでチェックアウトと 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` バージョンコメントの修正
- ウェブサイト同期設定に関するリリース早見表の更新
- `releases.md` に v1.12.0 LTS、v1.11、v1.9 の項目を反映
- インラインタスク仕様の再試行回数置換に関する明確化
- テストのベストプラクティスの追加

---

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