# Tekton v1.0.0

2025-05-01 · [릴리스 노트 원문](https://github.com/tektoncd/pipeline/releases/tag/v1.0.0) · [전체 정리](https://ratatosk.io/ko/releases/tekton/v1.0.0)

호환성 변경 4 · 폐기 예정 1 · 중요 수정 3 · 기능·개선 3 · 의존성 갱신 21 · 기타 5

## 업그레이드 전 확인

### 릴리스 이후 확인된 결함

- Git 리졸버 시스템 토큰 유출 수정 · v1.0.2에서 수정됨
- HTTP 리졸버 응답 본문 크기 제한으로 메모리 고갈 방지 · v1.0.2에서 수정됨

## 호환성 변경 (4)

### `disable-affinity-assistant` 제거 및 `coschedule` 대체

- 영향 대상: `disable-affinity-assistant`를 사용하는 Tekton 설정 (추정)
- 필요 조치: 대신 `coschedule` 사용; 이전 기본 동작을 유지하려면 `disabled`로 설정

이 필드는 v0.51에서 지원 중단 예정으로 처리된 뒤에도 클라이언트 코드와의 호환성을 위해 유지되었습니다. 이번 릴리스에서는 웹훅이 이 필드를 거부하고, 나머지 코드는 이를 무시합니다.

근거: “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` 기반 shallow clone 및 fetch 전환

- 영향 대상: Git Resolver를 사용하는 RemoteResolutions
- 필요 조치: ref 헤드나 태그에 없는 SHA 리비전을 위해 Git 서버에서 `uploadpack.allowReachableSHA1InWant` 활성화

이전에는 파일을 리졸브할 때, 특히 익명 Git clone을 사용하면 시간과 메모리를 지나치게 많이 사용할 수 있었고 `WithTimeout`으로도 해당 작업에 제한 시간을 적용할 수 없었습니다. shallow clone과 fetch를 사용하면 시간과 메모리 사용량을 모두 줄일 수 있습니다. Gitea를 비롯한 일부 제공업체에서는 ref로 도달할 수 없는 SHA 리비전을 fetch할 때 여전히 실패할 수 있습니다.

> * :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 GA 진입 및 `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초, factor 2.0, jitter 0.1, 2단계, 최대 10초를 사용합니다.

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

### 빈 결과 배열을 사용하는 Matrix 작업의 resolve

- 영향 대상: 이전 작업 결과로 채워지는 matrix 파라미터 (추정)

결과 참조를 사용하면서 파라미터의 `ArrayVal`이 비어 있으면 조합 수가 0이 되어 작업을 resolve하지 못하고, 유효하지 않은 결과 참조로 검증에 실패했습니다.

> * :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 리졸버의 `stepaction` kind 지원

## 의존성 갱신 (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)

- 릴리스 파이프라인에서 GHCR로 `ko` 및 태스크 번들 이미지 가져오기
- 릴리스 문서에 v0.70 추가 및 v0.64·v0.69 날짜 수정
- Step-guard의 `when` 표현식 문서를 Tasks로 이동
- TaskRun 문서의 리소스 요청 오버라이드 및 API v1 용어 업데이트
- `StepAction` `TaskRun` 예시에 enum 파라미터 사용 추가

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
