# Tekton v1.9.0

2026-01-30 · [元のリリースノート](https://github.com/tektoncd/pipeline/releases/tag/v1.9.0) · [全体のまとめ](https://ratatosk.io/ja/releases/tekton/v1.9.0)

セキュリティ 1 · 破壊的変更 5 · 重大な修正 7 · 機能・改善 2 · 依存関係の更新 30 · その他の変更 39

## アップグレード前の確認事項

### リリース後に確認された不具合

- sidecar-logs による結果抽出での TaskRun 結果全件の欠落解消 · v1.15.0で修正済み

## セキュリティ (1)

### Pipeline パラメーターのデフォルト値における参照解決と10レベル制限

- 影響対象: デフォルト値にパラメーター参照を含む PipelineRun

以前は、`$(params.X)` 参照を含むデフォルト値がそのままコピーされていたため、後続のタスク Pod 作成時に誤解を招くメッセージとともに失敗していました。現在はこれらの参照が解決されますが、依存関係の連鎖が10レベルを超えると、最大再帰深度エラーで失敗します。

> * :bug: Fix parameter resolution for defaults with  references (#9271)

## 破壊的変更 (5)

### `PriorityClassName` の protobuf タグ重複の修正

- 影響対象: `pod.Template` における `PriorityClassName` の protobuf シリアライズ (推定)

以前は `PriorityClassName` が `Env` と protobuf タグ 7 を共有していました。現在は `PriorityClassName` にタグ 8 を使用し、`Env` はタグ 7 のままです。

根拠: “- Changed `PriorityClassName` protobuf tag from 7 to 8” https://github.com/tektoncd/pipeline/pull/9229

> * :bug: Fix duplicated protobuf tag in pod.Template struct (#9229)

### `v1beta1` CRD の説明文短縮によるインストールエラーの修正

- 影響対象: `v1beta1` CRD を適用するインストール環境

詳細な説明が埋め込まれた CRD を適用すると、`metadata.annotations: Too long` エラーが発生し、適用に失敗することがありました。`kubectl explain` で表示される情報は少なくなりますが、API フィールドの詳細な説明は Tekton のドキュメントまたは `v1` フィールドで引き続き確認できます。

根拠: “To resolve "metadata.annotations: Too long" errors during installation, the field descriptions embedded in `v1beta1` CRDs (visible via `kubectl explain`) have been significantly shortened. Users should refer to the [Tekton documentation](https://tekton.dev/docs/) for detailed API field descriptions or use descriptions in v1 fields.” https://github.com/tektoncd/pipeline/pull/9252

> * :hammer: fix: reduce CRD size by shortening verbose descriptions (#9252)

### `PipelineRunList` のストリーミングリスト処理の修正

- 影響対象: v1 または v1beta1 の `PipelineRunList` API 型

以前は JSON から `items` が省略されることがあり、生成されたスキーマでも必須として指定されていなかったため、Kubernetes API のストリーミングリスト処理でこれらの型が正しく解釈されていませんでした。現在は `items` が常にシリアライズされ、必須として指定されます。

根拠: “- Removes ',omitempty' from the 'Items' field in the v1 and v1beta1 PipelineRunList structs.” https://github.com/tektoncd/pipeline/pull/9240

> * :hammer: fix(codegen): Correct JSON tags for streaming lists (#9240)

### v1beta1 `ResolutionRequestList` の `ListMeta` JSON タグに `omitempty` を追加

- 影響対象: v1beta1 `ResolutionRequestList` 型とその JSON 表現を使用する構成 (推定)

`ListMeta` フィールドの JSON タグが `json:"metadata"` から `json:"metadata,omitempty"` に変更されます。

根拠: “- Adds ',omitempty' to the 'ListMeta' field in the v1beta1 ResolutionRequestList struct.” https://github.com/tektoncd/pipeline/pull/9240

> * :hammer: fix(codegen): Correct JSON tags for streaming lists (#9240)

### カスタムタスクの API バージョンに `group/version` 形式が必須に

- 影響対象: カスタムタスクで `taskRef.apiVersion` または `taskSpec.apiVersion` を使用する Pipeline

以前は、`invalid-api-version` などの無効な値によって、PipelineRuns が処理されない CustomRuns を作成したままタイムアウトすることがありました。現在は、どちらかの値が無効な場合、明確なエラーとともに Pipeline の作成が即時に失敗します。

根拠: “add validation to ensure taskRef.apiVersion follows the correct format (group/version) when specified. Previously, invalid apiVersion values like 'invalid-api-version' were accepted, causing PipelineRuns to create unhandled CustomRuns that would timeout. Now Pipeline creation fails immediately with a clear error message when an invalid apiVersion is provided.” https://github.com/tektoncd/pipeline/pull/9045

> * :bug: fix: validate taskRef.apiVersion format for custom tasks (#9045)

## 重大な修正 (7)

### Affinity Assistant の ServiceAccount 継承の修正

- 影響対象: Affinity Assistant Pod を使用し、`taskRunTemplate.serviceAccountName` が設定されている PipelineRun

これまでは、これらの Pod は常に名前空間の `default` ServiceAccount を使用していました。その ServiceAccount に必要な SCC 権限がない場合、OpenShift でワークスペースを同時にスケジュールする PipelineRun が失敗することがありました。現在は、`AffinityAssistantTemplate` に上書き値が指定されていない限り、PipelineRun の `taskRunTemplate.serviceAccountName` を使用します。どちらにも値が指定されていない場合は、名前空間の `default` ServiceAccount を使用します。

> * :sparkles: feat: add ServiceAccount inheritance to Affinity Assistants (#9253)

### PipelineRun の冗長な status 書き込みの修正

- 影響対象: 子参照が status に書き込まれる形で調整される PipelineRun

順序が一定でない子参照の配列により、status への書き込みが大量に繰り返されていました。特に、子 TaskRun が 64 件を超える PipelineRun で顕著で、apiserver のメモリ使用量の急増や書き込み QPS の上昇につながっていました。子参照の順序が常に一定になるよう修正され、冗長な書き込みと、それに伴う apiserver の負荷や安定性への影響が軽減されます。

> * :bug: fix(pipelinerun): fix the issue of massive invalid status updates caused by unordered arrays, which will greatly impact the resource load and stability of the apiserver. (#9295)

### Pipeline のパラメーター既定値での参照解決

- 影響対象: 他のパラメーターを参照する既定値を持つ PipelineSpec

以前は、参照が文字列のままタスクに渡され、Pod の作成に失敗することがありました。現在は、解決済みのパラメーター値がタスクに渡されるため、Pod を正常に作成できます。

> * :bug: Fix parameter resolution for defaults with  references (#9271)

### PipelineRun 作成時の循環パラメーター依存関係の検出

- 影響対象: パラメーターのデフォルト値間に循環参照がある PipelineRun

これまでは、タスク Pod の作成時に誤解を招くエラーとして表面化していました。今後は PipelineRun の作成時に検証エラーとなり、循環依存関係を示すエラーが返されます。

> * :bug: Fix parameter resolution for defaults with  references (#9271)

### 未定義の PipelineRun パラメーター参照を検証時に検出

- 影響対象: PipelineRun パラメーターのデフォルト値

デフォルト値が未定義のパラメーターを参照している場合、解決時には検出されず、後のタスク Pod 作成時に誤解を招くエラーが表示されることがありました。現在は検証時に失敗し、未定義の参照を特定するエラーが返されます。

> * :bug: Fix parameter resolution for defaults with  references (#9271)

### タイムアウト未設定時の `TaskRuns` と `PipelineRuns` の過剰な調整を修正

- 影響対象: タイムアウトが設定されていない `TaskRuns` と `PipelineRuns`：タイムアウトが `0` に設定されている場合、または `default-timeout-minutes` が `"0"` のときに未設定の場合

以前はこれらの実行が直ちに再キューされ、調整が過剰に行われていました。タイムアウトが設定されていない場合、調整はウォッチイベントに依存するようになりました。タスク固有または finally 固有のタイムアウトが設定されている場合は、そのタイムアウト時に引き続き再キューされます。

> * :bug: fix: Prevent excessive reconciliation when timeout disabled (#9202)

### TaskRun の Pod コンテナエラーを即時失敗に変更

- 影響対象: Pod コンテナで `valueFrom` を通じて ConfigMap または Secret を使用するよう設定された TaskRun

Pod 内のコンテナに設定エラーやコンテナ作成エラーがある場合、たとえば `valueFrom` で参照している ConfigMap や Secret が見つからない場合、TaskRun は待機を続け、一般的なタイムアウトエラーだけを報告することがありました。現在はエラーの検出後すぐに失敗し、`CreateContainerConfigError` や `PodCreationFailed` など、対処に役立つエラーを報告します。

> * :bug: fix: Detect pod configuration errors early instead of timeout (#9197)

## 機能・改善 (2)

- TaskRun と PipelineRun の PodTemplate におけるユーザー名前空間の選択 (利用条件: このフィールドを使用するには、Kubernetes のフィーチャーゲート `UserNamespacesSupport` が有効になっている必要があります。)
- HTTP resolver のダイジェスト検証の追加 (利用条件: デフォルトで有効な `enable-http-resolver` フィーチャーフラグ)

## 依存関係の更新 (30)

ほか30件（いずれもセキュリティへの言及なし）

- `* :hammer: build(deps): bump go.uber.org/zap from 1.27.0 to 1.27.1 (#9333)`
- `* :hammer: build(deps): bump github.com/google/cel-go from 0.26.0 to 0.27.0 (#9330)`
- `* :hammer: build(deps): bump golang.org/x/sync from 0.18.0 to 0.19.0 (#9293)`
- `* :hammer: build(deps): bump github.com/hashicorp/go-version from 1.7.0 to 1.8.0 (#9288)`
- `* :hammer: build(deps): bump k8s.io/apiextensions-apiserver from 0.32.8 to 0.32.11 (#9286)`
- `* :hammer: build(deps): bump github.com/spiffe/spire-api-sdk from 1.12.4 to 1.14.0 (#9261)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/sdk from 1.38.0 to 1.39.0 (#9259)`
- `* :hammer: build(deps): bump github.com/cloudevents/sdk-go/v2 from 2.16.1 to 2.16.2 (#9258)`
- `* :hammer: build(deps): bump k8s.io/client-go from 0.32.8 to 0.32.11 (#9256)`
- `* :hammer: build(deps): bump google.golang.org/protobuf from 1.36.10 to 1.36.11 (#9254)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.8 to 4.31.9 (#9247)`
- `* :hammer: build(deps): bump the all group in /tekton with 2 updates (#9246)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel/trace from 1.37.0 to 1.39.0 (#9245)`
- `* :hammer: build(deps): bump k8s.io/apimachinery from 0.33.3 to 0.33.7 (#9244)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#9236)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.13.3 to 2.14.0 (#9235)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.7 to 4.31.8 (#9234)`
- `* :hammer: build(deps): bump actions/cache from 4.3.0 to 5.0.1 (#9233)`
- `* :hammer: build(deps): bump tj-actions/changed-files from abdd2f68ea150cee8f236d4a9fb4e0f2491abf1b to e0021407031f5be11a464abee9a0776171c79891 (#9232)`
- `* :hammer: build(deps): bump actions/upload-artifact from 5.0.0 to 6.0.0 (#9231)`
- `* :hammer: build(deps): bump the all group across 1 directory with 4 updates (#9220)`
- `* :hammer: build(deps): bump actions/checkout from 6.0.0 to 6.0.1 (#9219)`
- `* :hammer: build(deps): bump golangci/golangci-lint-action from 9.1.0 to 9.2.0 (#9218)`
- `* :hammer: build(deps): bump peter-evans/slash-command-dispatch from 4.0.0 to 5.0.1 (#9217)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.13.2 to 2.13.3 (#9216)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.6 to 4.31.7 (#9215)`
- `* :hammer: build(deps): bump actions/github-script from 7.0.1 to 8.0.0 (#9195)`
- `* :hammer: build(deps): bump github/codeql-action from 4.31.5 to 4.31.6 (#9194)`
- `* :hammer: build(deps): bump github.com/jenkins-x/go-scm from 1.15.4 to 1.15.16 (#9183)`
- `* :hammer: build(deps): bump google.golang.org/grpc from 1.75.0 to 1.77.0 (#9177)`

## その他の変更 (39)

- TaskRun の結果サイズ超過エラーに実際のサイズを表示
- Cherry-pick ワークフローによる複数コミットのリベースマージ処理
- 2つのE2Eテストの一時的なCI対象外化
- Docker-in-Docker サイドカーのサンプルテストプローブの更新
- GitHub Actions ワークフローにおける実行間の ko レイヤーメタデータのキャッシュ
- リコンシリエーションと過剰なリコンシリエーションのテスト更新
- README からの GHCR 移行告知の削除
- リリースドキュメントとチートシートの改訂
- `github/codeql-action` を `4.32.0` に更新
- Tekton リリースパイプラインのイメージ更新
- `chainguard-dev/actions` の 1.5.13 への更新
- リポジトリー自動化による `actions/checkout` の 6.0.2 への更新
- リポジトリ自動化による `step-security/harden-runner` の 2.14.1 への更新
- リリースパイプラインのイメージバージョン更新
- `chainguard-dev/actions` を 1.5.12 に更新
- リポジトリー自動化の `actions/setup-go` `6.2.0` への更新
- リポジトリ自動化における `actions/cache` の 5.0.1 から 5.0.2 への更新
- `/tekton` リリースパイプラインのイメージ更新
- リポジトリー自動化による `chainguard-dev/actions` の 1.5.11 への更新
- Tekton リリースパイプラインのイメージ更新
- `/tekton` リリースパイプラインのイメージとツールの更新
- `/tekton` における `chainguard/go` の更新
- リポジトリ自動化における `peter-evans/slash-command-dispatch` の 5.0.2 への更新
- GitHub ワークフロー参照への `# main` コメント追加
- `golangci-lint` GitHub Actions ステップの大きな差分の処理を修正
- CI ワークフローのファイル変更検出の修正
- パイプラインのメンテナーエイリアスに `twoGiants` を追加
- Cherry-pick-command ワークフローの起動失敗の修正
- エンドツーエンドテストの分類
- Cherry-pick ワークフローの共通基盤ワークフローへの移行
- go-coverage のコメント投稿の修正
- 自動チェリーピック PR のタイトルの具体化と元のコンテキストの引き継ぎ
- `e2e-matrix-extras` ワークフロー内の無効な `github-script` アクションの SHA の修正
- Examples のテスト並列数を 6 から 2 に削減
- プルリクエストへのコメント投稿における `CHATOPS_TOKEN` の使用
- 複製版 `chatops_retest` を共有ワークフローに置き換え
- リリース用チートシートテンプレートの YAML インデント修正
- `projected` および `csi` ワークスペースのベータ機能に関する注記の削除
- `releases.md` の v1.7 リリース情報更新

---

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