Cilium 1.20.3 업그레이드 점검: SNAT 포트·CNP·DNS 재시작
Cilium 1.20.3의 연결 추적·정책 적용·DNS 재시작 수정 사항을 증상과 연결해 패치 전후 검증 항목을 정리한다.
2026-10-20
정상 상태 점검만으로는 놓치는 수정이다
Cilium 1.20.3에는 살아 있는 연결의 SNAT 소스 포트가 재할당되거나, nodeSelector를 가진 CNP가 조용히 아무것도 강제하지 않거나, 에이전트 재시작 동안 Pod의 DNS 조회가 끊길 수 있던 문제의 수정이 포함됐다.
이 글의 기준은 **cilium/cilium v1.20.3 (2026-10-15)**이며, 근거는 Cilium v1.20.3 공식 릴리스 노트다. 업그레이드 점검도 이 수정들이 작동해야 하는 조건에 맞춰야 한다. 실행 버전이 바뀌었는지 확인하는 일과 연결·정책 동작이 의도대로 유지되는지 확인하는 일은 각각 필요하다.
먼저 운영 환경에 해당하는 조건을 고른다.
| 운영 조건 | 릴리스에 기록된 문제 | 패치 전후 확인할 동작 |
|---|---|---|
| 살아 있는 연결의 conntrack 상태를 GC가 처리하는 경우 | 재개방된 CT 엔트리 삭제가 NAT 매핑 삭제와 SNAT 소스 포트 재할당으로 이어질 수 있음 | 연결 유지와 SNAT 소스 포트 변화 |
nodeSelector를 가진 CNP 사용 |
정책이 조용히 아무것도 강제하지 않음 | 의도한 허용·차단의 실제 적용 |
wildcard toFQDNs 정책 사용 |
에이전트 종료 중 L7 DNS 정책이 datapath에 남아 재시작 동안 DNS 단절 | 재시작 구간의 DNS 조회 |
| Service 백엔드 종료 | 해당 백엔드에 더 이상 연결되지 않은 소켓도 파괴돼 로컬 포트가 변경됨 | 소켓의 연결 대상과 로컬 포트 변화 |
이 가운데 conntrack 수정은 연결이 살아 있다는 사실과 GC가 읽은 상태 사이의 경합을 다룬다. 다음 그림은 수정 전 문제가 발생할 수 있던 인과관계를 보여 준다.
SNAT 포트 변화는 연결 수명과 함께 확인한다
conntrack GC 수정에서 주목할 부분은 배치 읽기와 삭제 사이다. 릴리스 노트는 이 사이에 datapath가 재개방한 CT 엔트리를 GC가 삭제할 수 있었다고 설명한다. 그 삭제는 NAT 매핑 삭제로 이어지고, 살아 있는 연결의 SNAT 소스 포트가 다시 할당되는 결과를 낳을 수 있었다.
따라서 검증할 때는 새 연결이 만들어지는지만 확인하지 말고, 유지 중인 연결을 관찰 대상으로 잡는다. 해당 연결의 SNAT 소스 포트 변화와 연결 유지 여부를 함께 기록해야 릴리스에 적힌 문제와 비교할 수 있다.
다만 일반적인 연결 시험에서 포트 변화가 없었다는 사실만으로 이 경합을 재현하고 검증했다고 보기는 어렵다. 제공된 자료에는 경합을 강제로 만드는 명령이나 발생 빈도가 없다. 검증 기록에도 실제로 관찰한 연결 동작과 경합 재현 여부를 구분해 남긴다.
비슷한 포트 변경 증상으로 묶기 쉬운 별도 수정도 있다. Service 백엔드가 종료될 때, 그 백엔드에 여전히 연결된 소켓이 아닌데도 소켓이 파괴되던 문제다. 연결되지 않은 UDP 소켓이나 이미 연결을 끊었거나 다른 백엔드로 이동한 소켓은 이 때문에 로컬 포트가 조용히 바뀔 수 있었다. 수정 후에는 종료되는 백엔드에 여전히 연결된 소켓에 한해 파괴된다.
포트 변경을 조사할 때 구분해야 할 발생 계기와 관찰 대상은 다음과 같다.
운영 검증에서도 이 조건을 분리한다. 유지 중인 연결의 SNAT 소스 포트를 보는 시험과 Service 백엔드를 종료하면서 소켓의 연결 대상·로컬 포트를 보는 시험은 서로 다른 수정 항목에 대응한다. 한쪽의 정상 결과로 다른 쪽까지 검증했다고 기록하지 않는다.
nodeSelector CNP는 실제 허용·차단으로 확인한다
nodeSelector를 가진 CNP 수정은 정책이 조용히 아무것도 강제하지 않던 문제를 방지한다. 이런 유형의 결함에서는 정책 리소스가 존재하는지 확인하는 것만으로 적용 여부를 판단할 수 없다.
해당 CNP를 사용하는 환경이라면 먼저 그 정책으로 어떤 트래픽을 허용하고 어떤 트래픽을 차단하려 했는지 정리한다. 이어 정책이 적용돼야 하는 대상에서 허용 의도와 차단 의도에 각각 대응하는 트래픽을 발생시켜 결과를 확인한다. 정책의 존재 여부보다 정책이 만들어야 할 차이가 검증 기준이다.
제공된 릴리스 노트에는 무적용 문제가 발생하는 세부 조건이나 특정 상태 필드가 제시돼 있지 않다. 따라서 특정 메시지가 보이면 정상이라는 식의 판정 기준을 덧붙일 수는 없다. 점검 결과에는 사용한 CNP, 의도한 결과, 실제 트래픽 결과를 남기는 편이 이 수정의 목적에 직접 대응한다.
같은 릴리스에는 정책 검증에 함께 반영할 항목도 있다.
| 항목 | 수정 내용 | 점검에 반영할 내용 |
|---|---|---|
| Hubble 흐름의 정책 표시 | 흐름을 허용하거나 차단한 정책이 잘못 표시될 수 있던 문제 수정 | 표시된 정책을 실제 허용·차단 결과와 대조 |
CiliumCIDRGroups의 0.0.0.0/0 |
해당 CIDR이 의도치 않게 아무 트래픽도 선택하지 않던 문제 수정 | 이 CIDR을 사용하는 경우 트래픽 선택 결과 확인 |
CiliumLocalRedirectPolicy의 빈 redirectBackend.toPorts 배열 |
에이전트 panic 대신 해당 정책을 거부하도록 수정 | 해당 입력에 대한 정책 거부와 에이전트 동작 확인 |
특히 Hubble의 정책 표시에도 수정이 들어갔으므로, 정책 이름이 화면에 보인다는 사실만으로 강제가 정상이라고 판단하지 않는다. 트래픽 결과와 정책 표시를 함께 대조해야 관찰 정보와 실제 동작이 맞는지 확인할 수 있다.
wildcard toFQDNs는 재시작하는 동안 조회한다
DNS 수정의 대상은 에이전트 종료 과정이다. L7 DNS 정책이 datapath에 남아, wildcard toFQDNs 정책 아래의 Pod가 에이전트 재시작 동안 DNS 이름 해석을 잃을 수 있었다.
재시작이 끝난 뒤 DNS가 정상이라는 결과만으로는 이 수정 항목을 검증하기 어렵다. 장애 구간 자체가 재시작 중이기 때문이다. 해당 정책을 사용하는 Pod에서 재시작 전부터 DNS 조회 결과를 기록하고, 재시작이 진행되는 동안과 완료된 뒤의 결과를 이어서 비교한다.
다음 그림은 수정 전의 장애 원인과 검증에서 놓치지 말아야 할 관찰 구간을 연결한다.
검증 결과에는 재시작 완료 후의 성공 여부뿐 아니라 재시작 구간에 실패가 있었는지를 남긴다. 실패가 관찰됐다면 그 시점이 에이전트 재시작 구간과 겹치는지도 대조한다.
이 수정만으로 모든 DNS 실패가 해결된다고 확대해서 해석해서는 안 된다. 자료가 명시한 범위는 wildcard toFQDNs 정책과 에이전트 종료 중 잔존한 L7 DNS 정책의 조합이다. 다른 조건에서의 DNS 실패까지 이 항목으로 설명할 근거는 없다.
사용하는 기능에 맞춰 검증 범위를 더한다
핵심 증상 외에도 운영 중인 기능에 따라 패치 검증에 포함할 수정이 있다. Gateway API를 사용한다면 HTTP 라우트 순서의 결정화와 ExternalAuth의 요청 본문 처리 수정을 구분해서 본다.
| 사용 조건 | 릴리스에 적힌 변경 | 확인할 결과 |
|---|---|---|
| Gateway API HTTP 라우트 사용 | HTTP 라우트 순서를 결정적으로 처리 | 기존 라우트 구성에서 요청이 의도한 대상으로 전달되는지 확인 |
ExternalAuth에서 allowedResponseHeaders 미설정 |
요청 본문이 누락되던 문제 수정 | 본문을 포함한 요청의 전달 결과 확인 |
| BackendTLSPolicy 사용 | 시스템 CA 인증서 지원 | 시스템 CA 인증서를 사용하는 구성의 동작 확인 |
| 재시작 중 종료 상태의 백엔드가 다시 활성화 | 활성화된 백엔드가 잘못 격리 상태로 남던 문제 수정 | 재시작 후 백엔드 상태와 요청 전달 확인 |
| Azure에서 빈 MAC 필드가 있는 인터페이스 | 경로 설정 중 에이전트 시작 시 crash 수정 | 해당 인터페이스 조건에서 시작과 경로 설정 확인 |
| dual stack 사용 | IPv6 라우팅 규칙 설정 수정 | 해당 구성의 IPv6 라우팅 결과 확인 |
이 표는 모든 환경에 동일한 시험을 추가하라는 뜻이 아니다. 실제 사용하는 기능과 구성에 해당하는 행을 검증 범위에 넣는다. 예를 들어 ExternalAuth를 사용하더라도 allowedResponseHeaders를 생략한 경우의 본문 누락 수정은 그 조건에 맞는 요청으로 확인해야 한다.
HTTP 라우트 순서가 결정적으로 바뀌었다는 사실만으로 구체적인 우선순위 규칙까지 알 수는 없다. 제공된 자료에는 그 규칙이 없으므로, 운영 중인 라우트에서 의도한 요청 전달이 유지되는지를 기준으로 점검한다.
배포 이미지 확인과 동작 검증을 함께 남긴다
패치 배포 기록에는 버전 표기와 함께 실제 이미지 식별자를 남긴다. 릴리스 노트의 Docker Manifests에 제시된 Cilium 이미지 참조는 다음과 같다.
quay.io/cilium/cilium:v1.20.3@sha256:95cfa5c2427cc6b452c00908778d0566311f572589284af949d06a013db1a849
운영 환경에서 사용하는 Cilium 이미지가 이 참조와 일치하는지 대조한다. Operator나 Hubble Relay 등도 배포하고 있다면 같은 릴리스 노트에 제공된 각 구성요소의 이미지 참조를 별도로 확인한다. Cilium 이미지의 digest를 다른 구성요소에 적용해서는 안 된다.
업그레이드 완료 판단에는 다음과 같은 동작 증거를 함께 남긴다.
- 유지 중인 연결에서 관찰한 SNAT 소스 포트와 연결 상태.
- Service 백엔드 종료 시 소켓의 연결 대상과 로컬 포트 변화.
nodeSelectorCNP가 의도한 트래픽을 실제로 허용하거나 차단한 결과.- wildcard
toFQDNs정책 아래 Pod의 에이전트 재시작 전·중·후 DNS 조회 결과. - 사용하는 Gateway API 및 백엔드 복원 기능의 해당 조건별 검증 결과.
경합을 재현하지 못했거나 특정 기능을 시험하지 않았다면 그 범위도 기록한다. Cilium 1.20.3의 패치 효과는 버전 문자열만으로 입증되지 않는다. 이번에 고쳐진 조건을 운영 구성과 연결하고, 그 조건에서 관찰한 결과까지 남겨야 다음 장애 조사에서도 쓸 수 있는 업그레이드 기록이 된다.