# Tekton v1.10.0

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

破壊的変更 4 · 非推奨 1 · 重大な修正 3 · 機能・改善 1 · 依存関係の更新 23 · その他の変更 37

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

### 前提条件

- **オブザーバビリティのメトリクス送信先設定の更新**: `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 をすでに使用している場合を除き、`metrics.backend-destination` の代わりに `metrics-protocol: prometheus`（または `grpc` / `http`）を使用するように config-observability を更新すること、ダッシュボードのクエリを新しいメトリクス名に更新すること、追加された `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 メトリクスを使ったコントローラー性能監視

プルリクエストでは、コントローラーの性能監視用として `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`（または `grpc/http`）を使用すること。ダッシュボードでは旧名称の代わりに `kn_workqueue_*` と `go_*` を使用し、期間の集計で `reason` ラベルを考慮すること

以前は、インフラストラクチャーのメトリクスに `tekton_pipelines_controller_` プレフィックスが使われ、期間メトリクスには `reason` ラベルがなく、2つのカスタム 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` 設定は、`prometheus`、`grpc`、`http` を指定する `metrics-protocol` に置き換わります。すでに 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 より前に作成された PipelineRuns を削除できるよう、保持されています。

> * :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 の検証でデフォルト値内の非パラメーター変数を許可

- 影響対象: Pipeline パラメーターのデフォルト値で非パラメーター変数を使用する 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)`)

### 正常終了しなかったタスクの出力を含む Pipeline レベルの結果

- 影響対象: 失敗、キャンセル、またはタイムアウトしたタスクの出力を参照する Pipeline レベルの結果を持つ PipelineRun

以前は、これらの参照が未解決の変数文字列のまま残ることがありました。現在は、完了したものの失敗、キャンセル、またはタイムアウトとなったタスクの結果も、Pipeline レベルの結果に含まれます。

> * :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 resolver による 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 の所要時間メトリクスに `reason` ラベルを追加
- `/rebase` プルリクエストワークフローの追加
- 統合 CI サマリージョブが e2e 専用の集約ジョブを置き換え
- フレームワークのマップベース設定処理を採用したリゾルバーキャッシュ
- GoSec の検出事項の評価と `nosec` コメントの追加
- チェリーピックの再実行で既存の PR ブランチをリセットして強制プッシュ
- Cherry-pick ワークフローでのフォークのプルリクエストコミット取得
- `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 に更新
- タイムアウトリゾルバーテストの 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` のリリースライフサイクル掲載内容の更新
- `roadmap.md` への GitHub Projects ロードマップガイダンスの追加
- PipelineRun と workspace のドキュメント例の更新

---

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