# Tekton v1.0.0

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

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

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

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

- Git resolver のシステムトークン漏えいの修正 · v1.0.2で修正済み
- HTTP resolver のレスポンスボディ上限によるメモリ枯渇の防止 · v1.0.2で修正済み

## 破壊的変更 (4)

### `disable-affinity-assistant` の削除と `coschedule` への移行

- 影響対象: `disable-affinity-assistant` を使用する Tekton 設定 (推定)
- 必要な対応: 代替としての `coschedule` の使用。従来の既定動作を維持するための `disabled` の設定

このフィールドは v0.51 で非推奨になった後も、クライアントコードとの互換性のために保持されていました。このリリースでは webhook がこのフィールドを拒否し、それ以外のコードでは無視されます。

根拠: “Action Required: The feature flag `disable-affinity-assistant` has been removed. Please use `coschedule` as a replacement. It was marked as deprecated in version v0.51 and has been completely removed in the current version. If you need to maintain the previous default behavior, set feature flag `coschedule` to `disabled`.” https://github.com/tektoncd/pipeline/pull/8603

> * :hammer: cleanup: [TEP-0135] remove deprecated disable-affinity-assistant feature flag (#8603)

### Tekton における `keep-pod-on-cancel` のベータ化とデフォルト有効化

- 影響対象: `keep-pod-on-cancel` を使用する Tekton Pipelines のインストール環境 (推定)

このフラグは以前はアルファ版で、デフォルト値に `DefaultAlphaFeatureEnabled` を使用していました。

> * :hammer: misc: promote  to beta (#8343)
> `keep-pod-on-cancel` feature flag will be enabled in default

### Git Resolver の `git` による浅いクローンとフェッチへの切り替え

- 影響対象: Git Resolver を使う RemoteResolutions
- 必要な対応: ref の先端またはタグにない SHA リビジョンの場合、Git サーバーで有効化された `uploadpack.allowReachableSHA1InWant`

従来は、ファイルの解決、特に匿名 Git クローンを通じた解決に過剰な時間とメモリを要することがあり、`WithTimeout` でもその処理を制限できませんでした。浅いクローンとフェッチに切り替えることで、時間とメモリの両方を削減できます。Gitea を含む一部のプロバイダーでは、ref から到達できない SHA リビジョンのフェッチが引き続き失敗する場合があります。

> * :sparkles: fix: resolve Git Anonymous Resolver excessive memory usage (#8677)
> RemoteResolutions using the Git Resolver now use the `git` binary instead of  the Golang library `go-git` to shallow-clone, shallow-fetch, then checkout the provided repository at the given revision. This reduces resolution time and memory significantly. Some git providers such as Gitea may not support fetching revisions if the revision is a SHA which is not reachable via a ref or is not at a ref/head. In general, no user action is required.
> See also: https://git-scm.com/docs/protocol-capabilities#_allow_reachable_sha1_in_want
> Resolves https://github.com/tektoncd/pipeline/issues/8652

### `ClusterTask` のサポートと CRD の削除

- 影響対象: `ClusterTask` リソースまたはサポートを使用する環境 (推定)

> * :hammer: cleanup: remove clustertask support (#8601)
> Remove ClusterTask support completely

## 非推奨 (1)

### StepActions の正式提供開始と `enable-step-actions` の無効化

- 影響対象: StepActions を使用する、または `enable-step-actions` を設定する環境 (推定)
- 削除予定: 後続のリリース

これまでは StepActions はベータ版で、`Step` に `StepAction` を指定するには `enable-step-actions` を `"true"` に設定する必要がありました。StepActions はデフォルトで利用できるようになったため、このフラグは `Step` に `StepAction` を指定できるかどうかを左右しなくなりました。

> * :sparkles: feat: promote StepActions to GA (#8546)
> StepActions promoted to GA and is available by default. The enable-step-actions feature flag exists as a no-op flag to ensure that existing user workflows which might rely on this flag are not disabled. This flag will be removed completely in a later release.

## 重大な修正 (3)

### バンドルイメージリクエストの再試行バックオフ設定

- 影響対象: バンドルリゾルバーを使用する構成

バンドルイメージの取得中に一時的なネットワーク障害が発生した場合、従来はリクエストに再試行バックオフが設定されておらず、ネットワークの一時的な不安定さの影響を受ける可能性がありました。今後は設定済みのバックオフ値を使用し、値が設定されていない場合は、既定値として2秒、係数2.0、ジッター0.1、2ステップ、上限10秒を使用します。

> * :sparkles: Add configuration for custom bundle resolver backoff (#8574)
> Enables the configuration of backoffs for a bundle resolver requests.

### 結果配列が空の場合のマトリクスタスクの解決

- 影響対象: 前段タスクの結果から値を設定したマトリクスパラメーター (推定)

パラメーターの `ArrayVal` が空の状態で結果参照を使用すると、組み合わせ数が 0 になり、タスクが未解決のまま残って、無効な結果参照として検証に失敗していました。

> * :bug: fix: avoid fan out matrix task failed due to result ref (#8487)
> fix: avoid fan out matrix task failed due to result ref

### 一時的な subPath ディレクトリ作成失敗時の TaskRun 即時失敗の解消

- 影響対象: subPath ディレクトリを使用する TaskRun

以前は、コンテナーが `CreateContainerConfigError` で待機し、そのメッセージに「failed to create subPath directory」が含まれていると、TaskRun は直ちに失敗していました。現在は復旧を待つ間、`ReasonPodPending` の状態で実行中のままになります。

> * :bug: fix: handle subPath directory creation errors gracefully (#8683)

## 機能・改善 (3)

- PipelineRun の `onError` パラメーター置換
- Git resolver の go-git クローンでのトークン認証 (利用条件: 秘密情報名を指定した `gitToken` の設定。`gitTokenKey` でキーを任意指定でき、省略時の既定値は `token`。)
- Hub resolver が kind として `stepaction` を受け入れる変更

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

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

- `* :hammer: Bump go.mod and tools/go.mod to go 1.23 (#8482) Updating go to 1.23`
- `* :hammer: build(deps): bump github/codeql-action from 3.28.15 to 3.28.16 (#8729)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.11.1 to 2.12.0 (#8728)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#8727)`
- `* :hammer: build(deps): bump github.com/sigstore/sigstore from 1.8.15 to 1.9.4 (#8724)`
- `* :hammer: build(deps): bump k8s.io/apimachinery from 0.32.2 to 0.32.4 (#8723)`
- `* :hammer: build(deps): bump the all group in /tekton with 2 updates (#8722)`
- `* :hammer: build(deps): bump tj-actions/changed-files from be393a90381e27c9fec2c8c2e02b00f005710145 to c34c1c13a740b06851baff92ab9a653d93ad6ce7 (#8721)`
- `* :hammer: build(deps): bump github/codeql-action from 3.28.14 to 3.28.15 (#8705)`
- `* :hammer: build(deps): bump tj-actions/changed-files from 6abeaa506a419f85fa9e681260b443adbeebb3d4 to be393a90381e27c9fec2c8c2e02b00f005710145 (#8704)`
- `* :hammer: build(deps): bump ko-build/setup-ko from 0.8 to 0.9 (#8703)`
- `* :hammer: build(deps): bump the all group in /tekton with 4 updates (#8702)`
- `* :hammer: build(deps): bump github/codeql-action from 3.28.13 to 3.28.14 (#8690)`
- `* :hammer: build(deps): bump tj-actions/changed-files from 27ae6b33eaed7bf87272fdeb9f1c54f9facc9d99 to 6abeaa506a419f85fa9e681260b443adbeebb3d4 (#8689)`
- `* :hammer: build(deps): bump actions/dependency-review-action from 4.5.0 to 4.6.0 (#8688)`
- `* :hammer: build(deps): bump step-security/harden-runner from 2.11.0 to 2.11.1 (#8687)`
- `* :hammer: build(deps): bump the all group in /tekton with 2 updates (#8686)`
- `* :hammer: build(deps): bump github.com/go-jose/go-jose/v4 from 4.0.4 to 4.0.5 (#8680)`
- `* :hammer: build(deps): bump github.com/golang-jwt/jwt/v5 from 5.2.1 to 5.2.2 (#8678)`
- `* :hammer: build(deps): bump go.opentelemetry.io/otel from 1.34.0 to 1.35.0 (#8676)`
- `* :hammer: build(deps): bump k8s.io/code-generator from 0.31.6 to 0.31.7 (#8645)`

## その他の変更 (5)

- リリースパイプラインの `ko` とタスクバンドルイメージの GHCR からの取得
- リリースドキュメントへの v0.70 の追加と v0.64・v0.69 の日付修正
- Step-guard の `when` 式に関するドキュメントの Tasks への移動
- リソース要求の上書きと API v1 の用語に関する TaskRun ドキュメントの更新
- `StepAction` `TaskRun` の例に列挙型パラメーターの使用例を追加

---

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