본문 바로가기
Q&A해결2026년 4월 22일1분 읽기

Istio 1.24 → 1.25 업그레이드 후 mTLS 인증서 갱신이 실패합니다

서
서비스메시담당
조회 1053댓글 1

운영 중인 Istio 1.24를 1.25로 업그레이드한 뒤, citadel이 발급하던 워크로드 인증서 갱신이 일부 namespace에서 실패합니다.

로그에는 "failed to validate trust bundle"이 떨어지고, Pod 로그에는 x509: certificate signed by unknown authority가 종종 나옵니다.

전체는 아니고 일부 namespace만 영향 받는 게 이상합니다. 어떻게 진단해야 하나요?

댓글 1

김김영삼7개월 전

Istio 1.25에서 root CA 자동 회전 메커니즘이 변경됐습니다. 일부 namespace에서만 발생한다는 것은 trust domain 또는 cacert 분리 운영의 잔재 때문일 가능성이 큽니다.

1) trust bundle 동기화 상태 확인

# 모든 namespace의 trust bundle 비교
for ns in $(kubectl get ns -o name | cut -d/ -f2); do
echo "=== $ns ==="
kubectl get configmap istio-ca-root-cert -n $ns -o jsonpath='{.data.root-cert\.pem}' | openssl x509 -noout -fingerprint -sha256 2>/dev/null
done

모든 namespace의 fingerprint가 동일해야 합니다. 다르면 trust bundle 동기화가 깨진 상태입니다.

2) Multi-root 운영 여부 확인

kubectl get secret cacerts -n istio-system 2>/dev/null
# 있으면: 외부 CA로 root 분리 운영 중 (간소화 안 됨)
# 없으면: Istio 자체 자가서명 (간소화)

1.25부터는 cacerts secret 형식이 일부 변경됐습니다. 기존 secret을 그대로 두면 새 control plane이 로드 못 합니다.

해결 — cacerts 재생성

# istioctl 1.25 이상 필요
istioctl install --set profile=default \
--set values.global.caAddress=istiod.istio-system.svc:15012 \
--set values.pilot.env.PILOT_ENABLE_CA_SERVER=true \
--revision=1-25

3) Pod별 cert 회전 강제

# 영향 받는 namespace에서 Pod rolling restart
kubectl rollout restart deployment -n <affected-ns>

# 또는 sidecar만 재로딩
istioctl proxy-config secret <pod>.<ns>

4) namespace 레이블링 점검

kubectl get ns -L istio.io/rev -L istio-injection
# istio-injection=enabled 또는 istio.io/rev=1-25 둘 중 하나만 있어야 함

1.25 release notes에 따르면 두 라벨이 동시에 있는 namespace는 구버전 sidecar가 주입되는데, 신규 Pod의 trust domain이 root와 안 맞을 수 있습니다.

5) 응급 대응 — root rotation 강제

# Istiod 재시작으로 root 재배포 트리거
kubectl rollout restart deployment/istiod -n istio-system

# 5분 대기 후
kubectl get configmap istio-ca-root-cert -A -o jsonpath='{range .items[*]}{.metadata.namespace}{"\t"}{.data.root-cert\.pem}{"\n"}{end}' | md5sum -c

실무 체크리스트:

  1. 모든 namespace의 istio-ca-root-cert configmap fingerprint 동일 확인
  2. cacerts secret이 있으면 1.25 형식으로 재생성
  3. istio-injection vs istio.io/rev 라벨 충돌 점검
  4. Pod rolling restart로 새 cert 발급 강제
  5. root rotation 자동화 — istiod 매 30일 자동 재시작 (cronjob)

장기 권장: 1.25부터 SPIFFE 통합이 강화됐으니 root CA를 외부 인증서 관리 시스템(cert-manager + ClusterIssuer)에 위임하는 것이 운영 부담을 크게 줄입니다. 1.26 이후 Istio 자체 CA는 점진적으로 권장 외 자리로 갈 가능성이 큽니다.

Ctrl+Enter로 등록