# Tekton v1.11.0

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

セキュリティ 2 · 破壊的変更 3 · 重大な修正 11 · 機能・改善 4 · 依存関係の更新 45 · その他の変更 27

## セキュリティ (2)

### Cluster Resolver の名前空間リスト項目をアクセス制御と照合する前のトリミング

- 影響対象: 項目の前後に空白を含む、カンマ区切りの `allowed-namespaces` または `blocked-namespaces` 値を使用する Cluster Resolver の設定

以前は、`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.

### Cluster resolver のワイルドカードによるブロック処理の修正

- 影響対象: `*` と `blocked-namespaces` の明示的な項目を含む Cluster resolver の設定

以前は、`"*,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)

### Cluster resolver による空の `default-namespace` 値の拒否

- 影響対象: 空の `default-namespace` 値を設定した Cluster resolver 構成

同梱されている `default-namespace: ""` の値は、以前はパラメーターの欠落を報告することなく、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` 系列がアクティブな時系列数で 120 万を超えることがあり、Prometheus のスクレイプタイムアウトと Tekton メトリクスの欠落を引き起こしていました。置き換え後は、ヒストグラムのバケット、合計値、件数の各系列が公開されます。

> * :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` の namespace フォールバックを明示的なエラーに置き換え

- 影響対象: リクエストにも所有オブジェクトにも namespace がない ResolutionRequest (推定)

リクエストにも所有オブジェクトにも namespace が指定されていない場合、このメソッドは暗黙に `default` を使用していました。その結果、誤った namespace に `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.

### [表面化しなかった不具合] Resolution Framework のリクエスト名検索の修正

- 影響対象: リクエストの名前空間と名前のコンテキスト値を注入・読み取る Resolution Framework のコード

名前空間がリクエスト名より先に注入されると、コンテキストキーが衝突し、名前の注入がエラーなく失敗して `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` メトリクスを使用する環境

初回の reconcile 前は、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` のキャンセル時の期間・件数メトリクス記録

- 影響対象: キャンセルされた `PipelineRun` の期間・件数メトリクスを利用する環境 (推定)

キャンセル処理が `reconcile()` を呼び出さずに `cancelPipelineRun()` の短絡経路を通ると、期間と件数のメトリクス観測値がエラーなく欠落していました。この経路でも記録されるようになりました。

> * :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` のシンボリックリンクが共有ボリューム上に残る Pod

Pod 内でコンテナが再起動し、前回の実行で作成されたシンボリックリンクが共有ボリューム上に残っている場合（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.

### `PipelineRun` の延長されたタイムアウトを子 `TaskRun` に適用

- 影響対象: グローバルデフォルトを超える `PipelineRun` の task または finally タイムアウトが設定され、子 `TaskRun` にタスク単位の明示的なタイムアウトが設定されていない場合

以前は、Webhook が子 `TaskRun` にグローバルデフォルト（通常は1時間）を適用していたため、`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 サーバー上のリポジトリについて、アノテーション URL にリポジトリパスを指定した複数の Git 認証情報シークレット

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.

### Resolver の可観測性メタデータの復元

- 影響対象: Resolver デプロイメントの `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 への適用 (利用条件: 該当する `WEBHOOK_TLS_MIN_VERSION`、`WEBHOOK_TLS_MAX_VERSION`、`WEBHOOK_TLS_CIPHER_SUITES`、および／または `WEBHOOK_TLS_CURVE_PREFERENCES` 環境変数)
- Hub Resolver のリクエストごとの URL 指定と順序付きハブフォールバック (利用条件: `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)

- Gitea のエンドツーエンドテストの CI への追加と memcached フィクスチャの起動引数の修正
- 名前生成エラーで対象項目を `resource` として識別
- リゾルバーキャッシュによる同時解決の重複排除
- 3つの GitHub Actions ワークフローへの明示的なトップレベル権限ブロックの追加
- `step-script.yaml` の TaskRun 例でイメージ参照を固定
- Example TaskRun のイメージ参照のダイジェスト固定
- `examples/v1/taskruns` 内の Bash、Alpine、Busybox イメージ参照のダイジェスト固定
- `examples/v1/taskruns` 内の Ubuntu イメージ参照をダイジェストに固定
- パイプライン状態の解決ごとに一度だけ行う `VerificationPolicy` のリスト取得
- GitHub Actions のセキュリティ修正と zizmor CI チェックの追加
- PipelineRun の子リソース用ラベル参照処理を `memberOfLookup` に移動
- ドキュメントとスクリプト内の旧 GCS リリース URL の置き換え
- Gitea テストインフラストラクチャの 1.25.4 へのアップグレード
- 解決済み TaskSpec の保存に関するコメントの明確化
- テストファイルからの `opencensus` 依存関係の削除
- `tj-actions/changed-files` のバージョンコメントを v47.0.5 に更新
- リリース早見表とパイプラインでの `release.notags.yaml` の使用
- Pipeline API ドキュメント生成の復旧と公開済みドキュメントの更新
- `auth.md` からの古くなった TODO の削除
- 認証ドキュメントにおける Step の認証情報と `imagePullSecrets` の区別
- `releases.md` にセキュリティパッチリリースを追記
- メトリクスのドキュメントに未記載だった4つのメトリクスを追加
- 壊れていた内部 Markdown リンクの修正
- `PipelineRun` と `TaskRun` のサンプルへの README ファイル追加
- `taskruns.md` 内の Tekton Bundles の例へのリンク切れの修正
- `releases.md` を v1.10.0 向けに更新
- TaskRun ドキュメントから `tkn bundle` CLI ドキュメントへのリンク

---

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