ingress2gateway

1 개요

ingress2gateway (i2gw)

• Ingress → Gateway API 변환 도구
• 기존 Ingress 및 구현체별 어노테이션/CRD를 Gateway API 리소스(예: Gateway, HTTPRoute, TCPRoute, UDPRoute, TLSRoute)로 변환해 주는 도구
• SIG-Network 산하 서브프로젝트로 관리되며, Ingress에서 Gateway API로의 마이그레이션을 단순화한다.
• 목적: Ingress 규칙과 구현체별 설정을 동등한 Gateway API 모델로 재구성
• 한 번의 변환(원본 보존) 워크플로우를 권장하며, 생성된 매니페스트를 검토·보완하여 사용한다.

2 기능

• Ingress 스펙과 구현체별 확장(어노테이션/CRD)을 해석하여 Gateway API 리소스 조합으로 변환
• 변환 결과를 YAML로 출력(파일/STDOUT), GitOps 파이프라인 연계 용이
• 일부 널리 쓰이는 구현체별 옵션을 지원(미지원 옵션은 수동 보완 필요)

3 동작

1. 변환 소스(클러스터의 Ingress 리소스 또는 Ingress YAML) 준비
2. ingress2gateway 실행 → 등가의 Gateway/Route 매니페스트 생성
3. 결과 YAML을 검토(리소스 분리·어노테이션 대체·정책 보완) 후 적용
4. 게이트웨이 컨트롤러 환경에서 동작 확인 및 점진 전환

4 지원/제한

• 지원: 표준 Ingress 규칙의 HTTP 라우팅 대부분, 주요 구현체에서 쓰이는 일부 어노테이션/CRD
• 제한: 모든 구현체별 고유 기능이 1:1 매핑되지는 않는다(미지원 항목은 수동 변환 필요)
• 변환 원칙: “모델 변환”을 우선시(어노테이션 단순 복제 지양)

5 사용 예시(개요)

• “모든 Ingress를 Gateway+HTTPRoute로 변환”
• TCP/UDP 인그레스의 경우 Gateway+TCPRoute/UDPRoute(+필요 시 TLSRoute)로 분할 변환
• 변환 후, 클래스/리스너/라벨링/정책(보안·관찰성)을 환경에 맞게 보정

6 같이 보기

• InGate
• Gateway API
• k8s Ingress
• k8s Gateway
• k8s HTTPRoute
• k8s TCPRoute
• k8s UDPRoute
• k8s TLSRoute

7 참고

• https://github.com/kubernetes-sigs/ingress2gateway
• https://kubernetes.io/blog/2023/10/25/introducing-ingress2gateway/
• https://gateway-api.sigs.k8s.io/guides/migrating-from-ingress/
• https://developer.konghq.com/kubernetes-ingress-controller/migrate/ingress-to-gateway/
• https://docs.cilium.io/en/stable/network/servicemesh/ingress-to-gateway/ingress-to-gateway.html
• https://kubernetes.io/docs/concepts/services-networking/gateway/