# SPIRE v1.14.0

2025-12-11 · [릴리스 노트 원문](https://github.com/spiffe/spire/releases/tag/v1.14.0) · [전체 정리](https://ratatosk.io/ko/releases/spire/v1.14.0)

호환성 변경 4 · 중요 수정 2 · 기능·개선 6 · 기타 5

## 호환성 변경 (4)

### SPIRE 에이전트의 `retry_bootstrap` 설정과 `retryBootstrap` 플래그 제거

- 영향 대상: `retry_bootstrap`을 false로 설정한 SPIRE 에이전트
- 필요 조치: 업그레이드 전 플래그 없이 테스트

이전에는 `retry_bootstrap`이 false이면 부트스트랩 어테스테이션과 매니저 초기화를 재시도하지 않았고, true로 설정하면 백오프를 적용해 재시도했습니다.

근거: “- flags.BoolVar(&retryBootstrap, "retryBootstrap", true, "If true, the agent retries bootstrap with backoff")” https://github.com/spiffe/spire/pull/6431

> - Removed the deprecated 'retry_rebootstrap' agent config (#6431)

### `spire-server validate`에 플러그인 설정 검증 추가

- 영향 대상: 플러그인 설정이 있는 서버 구성

이전에는 이 명령이 플러그인 설정을 검증하지 않았습니다. 이제 플러그인 검증 오류를 보고하고, 오류가 있으면 1을 반환합니다. 오류가 없으면 설정이 유효하다는 메시지를 출력합니다.

> - `spire-server validate` now supports validating plugin configuration (#6355)

### Disk KeyManager의 시작 시 디렉터리 검증

- 영향 대상: `disk` KeyManager 플러그인을 사용하도록 설정된 SPIRE 에이전트

설정된 디렉터리가 없으면 새로 생성합니다. 디렉터리를 생성할 수 없거나 쓸 수 없으면 시작 시 `FailedPrecondition` 오류가 발생할 수 있습니다.

> - The KeyManager directory is now validated to exist and be writeable on agent startup (#6397)

### SQL 데이터스토어 버전 및 CTE 쿼리에서 설정 컨텍스트 사용

- 영향 대상: SQL 데이터스토어를 사용하는 배포 (추정)

이전에는 SQL 버전과 CTE 지원 여부를 조회하는 쿼리에서 설정을 통해 전달된 컨텍스트를 사용하지 않았습니다.

> - QueryContext is now used for querying the version database version and CTE support (#6461)

## 중요 수정 (2)

### GCP CAS, Enterprise 티어 CA 호환성을 위한 인증서 ID 추가

- 영향 대상: Enterprise 티어 CA 풀을 사용하는 GCP CAS UpstreamAuthority

`certificate_id`는 CSR 공개 키 해시에서 생성되어 각 요청에 호환성을 위한 결정론적 식별자를 부여합니다.

> - GCP CAs now specify a `certificate_id` in `CreateCertificateRequest` for Enterprise tier compatibility (#6392)

### `k8s` 및 `docker` 워크로드 어테스터의 컨테이너 위치 확인 수정

- 영향 대상: cgroup mountinfo를 사용하는 `k8s` 또는 `docker` 워크로드 어테스터 구성

컨테이너에 cgroup 마운트가 여러 개 있고 그중 루트가 `/`인 항목도 있으면, 로케이터가 비어 있는 컨테이너 ID와 Pod UID를 찾아 `FailedPrecondition` 오류를 반환할 수 있었습니다. 이제 루트가 `/`인 항목은 건너뜁니다. 다른 항목에서 컨테이너 정보를 얻을 수 있으면 이 오류가 발생하지 않습니다.

> - The `k8s` and `docker` workload attestors now ignore cgroup mountinfo with root == / (#6462)

## 기능·개선 (6)

- Azure VM 및 VM Scale Set용 Azure IMDS 증명 (사용 조건: 에이전트 측 `azure_imds` 플러그인을 서버 측 `azure_imds` 플러그인과 함께 사용)
- `aws_kms`가 생성한 KMS 키의 사용자 정의 태그 (사용 조건: 태그를 사용하려면 `aws_kms` 플러그인의 `key_tags` 옵션을 구성해야 합니다.)
- JWT-SVID 기능 비활성화 서버 옵션 (사용 조건: 서버 설정 옵션 `disable_jwt_svids`를 `true`로 설정해 JWT-SVID 기능 비활성화)
- P-384 워크로드 X.509 SVID 키에 대한 SPIRE 에이전트 지원
- Docker 워크로드 어테스테이터에 이미지 config digest 셀렉터 추가 (사용 조건: 이미지 검사 성공)
- PostgreSQL SQL 데이터스토어의 Cloud SQL Proxy 지원 (사용 조건: Cloud SQL 연결 문자열)

## 기타 (5)

- 서버에 더미 WIT-SVID RPC 구현 추가
- 취소 후 이벤트 조회를 멈추는 SPIRE 서버
- SQL 데이터스토어에서 사용되지 않는 `V3AttestedNode` 모델 제거
- `k8s_configmap` BundlePublisher 문서
- SPIRE Agent에 `tpm_devid` 노드 어테스터 지원 추가

---

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