Cilium

v1.20.0Networking & Messaging

2026년 7월 29일링크 복사

Cilium v1.20.0은 Gateway API v1.6.1, Kubernetes Cluster Network Policy 지원, IPv6 ENI IPAM 베타, 데이터패스 플러그인, 실질적 데이터패스 최적화를 도입하는 메이저 피처 릴리스입니다. docker libnetwork 플러그인, Envoy Go Extensions, Kafka 인식 정책, 비추천 CNI/암호화/로드밸런싱 플래그와 CRD 제거, CNI 구성 기본 버전 변경을 포함한 14개 주요 변경을 포함합니다. grpc-go 보안 업데이트도 포함됩니다. 모든 운영자는 업그레이드 전에 비추천 플래그, CRD 버전, 엔드포인트 식별자 사용을 검토해야 합니다.

• breakingDocker libnetwork 플러그인 제거

  v1.20.0에서 docker libnetwork 플러그인이 제거됩니다. Docker 데몬 네트워킹에 Cilium의 libnetwork 통합을 사용 중이라면 업그레이드 전 또는 시점에 해당 구성을 제거하거나 마이그레이션해야 합니다.

• breakingEnvoy Go Extensions 및 Kafka 인식 정책 제거

  Envoy Go Extensions(proxylib)와 Kafka 인식 네트워크 정책은 v1.20.0에서 제거되며, v1.16부터 비추천 대상이었습니다. Kafka L7 정책 또는 proxylib를 사용 중이라면 업그레이드 전에 CiliumEnvoyConfig 기반 솔루션으로 마이그레이션하세요.

• breakingv2alpha1 CiliumNodeConfig API 제거

  v2alpha1 CiliumNodeConfig API는 v1.20.0에서 제거되며, v1.16에서 v2로 승격되었습니다. cilium.io/v2alpha1 CiliumNodeConfig를 참조하는 매니페스트나 도구를 v2 사용으로 업데이트하세요.

• breakingBeta Mutual Auth 비추천

  Beta Mutual Auth 지원은 v1.20.0에서 비추천되며 향후 릴리스에서 제거될 예정입니다. 이 기능 사용을 중단할 계획을 세우세요.

• breaking암호화 IPsec 인터페이스 옵션 제거

  encryption.ipsec.interface Helm 값과 bpf_network.c 프로그램은 v1.20.0에서 제거됩니다. Helm 구성에 이 값이 있다면 제거하세요. 프로그램은 최소 v1.18 이후로 미사용 상태입니다.

• breaking암호화 strict-mode 플래그 제거

  3개의 암호화-strict-mode 플래그가 v1.20.0에서 제거됩니다: enable-encryption-strict-mode, encryption-strict-mode-cidr, encryption-strict-mode-allow-remote-node-identities. 이들이 에이전트 또는 Helm 구성에 있다면 제거하세요.

• breakingk8s-api-server 플래그 제거

  k8s-api-server 데몬 플래그는 v1.20.0에서 제거됩니다. 에이전트 구성에 있다면 제거하세요.

• breakingAWS 페이지네이션 플래그 대체

  aws-pagination-enabled Cilium operator 플래그는 aws-max-results-per-call로 대체되어 v1.20.0에서 제거됩니다. operator 구성을 그에 따라 업데이트하세요.

• breaking비추천 클라우드 IPAM 필드 제거

  v1.20.0에서 오래되지 않은 클라우드 프로바이더 IPAM 필드가 제거됩니다: spec.eni.instance-id, spec.eni.min-allocate, spec.eni.pre-allocate, spec.eni.max-above-watermark, status.azure.interfaces[].GatewayIP. CiliumNode 스펙에 있다면 제거하세요.

• breakingClustermesh MCS API Helm 값 대체

  clustermesh.enableMCSAPISupport Helm 값은 clustermesh.mcsapi.enabled로 대체되어 v1.20.0에서 제거됩니다. 이전 이름을 참조하고 있다면 Helm 값을 업데이트하세요.

• breaking노드 포트 알고리즘 및 모드 플래그 제거

  2개의 로드밸런싱 플래그가 v1.20.0에서 제거됩니다: node-port-algorithm, node-port-mode. 에이전트 구성에 있다면 제거하세요.

• breakingCES slice-mode 플래그 제거

  ces-slice-mode 플래그는 v1.20.0에서 제거됩니다. 에이전트 구성에 있다면 제거하세요.

• breaking엔드포인트 식별자 조회 마이그레이션 필수

  CNI 플러그인이 생성한 엔드포인트는 v1.20.0에서 더 이상 Cilium Agent API를 통해 레거시 container-id 또는 pod-name 식별자로 주소 지정되지 않습니다. 대신 cni-attachment-id:<containerID>:<ifName> 또는 cep-name:<namespace/name>을 사용하세요.

• breakingCNP/CCNP Proxylib 필드 제거

  Proxylib 관련 필드는 v1.20.0에서 CNP 및 CCNP CRD에서 제거됩니다. 모든 L7 proxylib 정책을 제거하고 CiliumEnvoyConfig로 마이그레이션하세요.

• breakingCNI 구성 버전 기본값 변경

  기본 CNI 구성 버전은 v1.20.0에서 0.3.1에서 1.0.0으로 변경됩니다. 이것이 환경의 CNI 호환성을 방해한다면 cni.customConf Helm 값을 사용하여 0.3.1로 되돌리세요.

• breakingHubble labelsContext 메트릭 형식 변경

  Hubble 메트릭 labelsContext 구문 분석은 이제 쉼표로 구분된 값을 필요로 합니다(예: labelsContext=source_ip,destination_ip). 쉼표와 파이프를 섞은 이전 구성은 실패합니다. labelsContext를 사용 중이라면 구성을 업데이트하세요.

• securitygrpc-go 보안 업데이트

  grpc-go는 보안 문제를 해결하기 위해 v1.82.1로 업데이트됩니다. 수정 사항은 v1.20.0에 포함되며 모든 배포에 적용됩니다.