외부 트래픽의 관문 — Ingress, Gateway API, 그리고 cert-manager 자동화

클러스터 안에서 파드들이 서로 통신하고 서비스가 정상 구동되더라도, 외부의 실제 사용자가 인터넷을 통해 서비스에 접속할 수 없다면 아무런 의미가 없습니다.

사용자가 브라우저 주소창에 https://service.example.com을 입력했을 때, 이 요청은 인터넷 망을 건너 클러스터의 경계를 뚫고 수많은 워커 노드 중 정확한 서비스 파드로 안전하게 전달되어야 합니다. 또한 이 과정에서 HTTPS 암호화 통신과 유효한 SSL/TLS 인증서가 필수적으로 수반됩니다.

외부 트래픽을 내부로 끌어들이는 L7 라우팅 계층의 진화와, 인증서 발급 및 갱신을 완전 자동화하는 엔지니어링 표준을 정리합니다.

1. NodePort와 LoadBalancer의 한계: 왜 Ingress가 필요한가?

쿠버네티스 기본 Service 객체에도 외부 트래픽을 받는 방법이 존재합니다. 하지만 실무 운영 환경에서는 치명적인 한계에 부딪힙니다:

  • NodePort의 한계:
    • 모든 워커 노드에 30000~32767 대역의 고정 포트를 강제로 열어야 합니다.
    • 사용자에게 example.com:31452처럼 포트 번호가 붙은 URL을 제공할 수는 없으며, 80/443 표준 포트를 점유하기 어렵습니다.
  • LoadBalancer의 한계:
    • 서비스를 선언할 때마다 퍼블릭 클라우드(AWS, GCP 등)에서 실제 물리/가상 로드밸런서(NLB 등)를 1:1로 새로 생성합니다.
    • 마이크로서비스가 30개라면 30개의 클라우드 로드밸런서가 생성되어 매달 수백만 원의 불필요한 인프라 비용이 청구됩니다.
    • 또한 L4 레벨의 포트 포워딩일 뿐, URL 경로(/api, /users)나 도메인 이름(service.example.com)을 보고 트래픽을 분기하는 L7 라우팅을 수행하지 못합니다.

이러한 비효율을 해결하기 위해 단 하나의 외부 진입점(공인 IP)을 열어두고, 들어오는 HTTP/HTTPS 요청의 호스트 이름과 URL 경로를 분석하여 클러스터 내부의 여러 서비스로 쪼개어 전달해 주는 L7 역방향 프록시(Reverse Proxy) 가 필요해졌습니다. 이것이 바로 인그레스(Ingress) 의 탄생 배경입니다.

2. Ingress와 Ingress Controller의 동작 아키텍처

인그레스를 다룰 때 가장 중요한 개념적 구분이 있습니다:

  • Ingress: “어떤 도메인과 경로로 들어온 트래픽을 어느 내부 서비스로 보낼 것인가”를 정의한 선언적 규칙(YAML 규칙서) 입니다.
  • Ingress Controller: 이 선언된 규칙을 읽고 실제로 외부 트래픽을 받아 라우팅을 수행하는 실제 프록시 서버 애플리케이션 입니다.

쿠버네티스 클러스터를 처음 구축하면 Ingress 규칙을 작성해도 아무 일도 일어나지 않습니다. 반드시 클러스터 앞단에 Ingress Controller를 별도로 배포해야 합니다.

가장 널리 쓰이는 표준은 Ingress-Nginx 와 Traefik 입니다:

flowchart TD
    Client["👤 <b>외부 사용자 요청</b><br/><code>https://api.example.com/v1</code>"]
    LB["☁️ <b>Cloud Load Balancer (NLB)</b><br/>단 1개의 공인 IP (80/443 수신)"]

    subgraph Cluster["☸️ 쿠버네티스 클러스터"]
        direction TB
        IC["🛡️ <b>Ingress Controller (Nginx / Envoy)</b><br/>• SSL/TLS 인증서 종단 (Decryption)<br/>• Host 헤더 및 URL 패스 L7 라우팅"]

        subgraph Routes["L7 라우팅 분기"]
            direction LR
            R1["<b>Host: api.example.com</b><br/>경로: <code>/v1</code>"]
            R2["<b>Host: web.example.com</b><br/>경로: <code>/*</code>"]
        end

        subgraph Pods["백엔드 파드 그룹"]
            direction LR
            Svc1["⚙️ <b>backend-svc:8080</b><br/>(API 파드들)"]
            Svc2["🌐 <b>frontend-svc:80</b><br/>(웹 UI 파드들)"]
        end

        IC --> Routes
        R1 --> Svc1
        R2 --> Svc2
    end

    Client ==> LB
    LB ==> IC
그림 1. Ingress Controller 기반 L7 트래픽 라우팅 및 SSL 종단 아키텍처
  1. 클라우드의 로드밸런서(단 1개)가 80/443 포트로 들어오는 모든 외부 트래픽을 Ingress Controller 파드들로 전달합니다.
  2. Ingress Controller 내부의 Nginx 프로세스는 쿠버네티스 API 서버를 감시하다가, 새로운 Ingress 매니페스트가 생성되면 자신의 nginx.conf 설정을 동적으로 재작성(Reload)합니다.
  3. 들어온 요청의 헤더를 검사하여 Host: api.example.com이고 경로가 /v1이면 백엔드 서비스의 파드 IP로 즉시 프록시 전달합니다.

3. 차세대 인그레스 표준: Gateway API

오랜 기간 Ingress는 훌륭하게 동작했지만, 대규모 엔터프라이즈 환경에서는 구조적인 한계를 드러냈습니다. 단일 Ingress 리소스 안에 도메인 라우팅, SSL 인증서, 타임아웃, 헤더 조작, 서킷 브레이커 등 온갖 설정이 복잡한 annotations 형태로 뒤섞였기 때문입니다.

또한 클러스터의 네트워크 인프라를 총괄하는 시스템 엔지니어와, 특정 비즈니스 API 경로만 배포하려는 서비스 개발자의 권한이 분리되지 않는 문제가 있었습니다.

이를 해결하기 위해 쿠버네티스 공식 네트워킹 SIG는 차세대 표준인 Gateway API 를 제정했습니다:

  • GatewayClass (인프라 제공자): 클러스터에 사용 가능한 로드밸런서 인프라 종류(Envoy, Cilium, AWS VPC Lattice 등)를 정의합니다.
  • Gateway (클러스터 운영자/SRE): 80/443 포트를 열고 공인 IP와 공용 와일드카드 TLS 인증서를 묶어 물리적 진입점을 선언합니다.
  • HTTPRoute / GRPCRoute (애플리케이션 개발자): 인프라 설정에는 손대지 않고, 자신이 담당하는 서비스의 도메인(api.example.com)과 라우팅 룰만 독립적으로 선언하여 Gateway에 연결합니다.

Gateway API는 역할 기반 권한 분리(RBAC)를 완벽히 지원하고, 가중치 기반 카나리 트래픽 분할(예: v1에 90%, v2에 10%)을 어노테이션 편법 없이 공식 스펙으로 지원하여 최신 쿠버네티스 구축의 핵심 표준으로 급부상하고 있습니다.

4. Let’s Encrypt 무료 SSL 인증서 자동화: cert-manager

HTTPS를 서비스하려면 신뢰할 수 있는 공인 인증 기관(CA)으로부터 발급받은 TLS 인증서가 필요합니다. 과거에는 1년마다 비싼 비용을 내고 수동으로 인증서를 갱신하느라 인증서 만료 사고가 빈번했습니다.

쿠버네티스 생태계에서는 cert-manager 와 비영리 CA인 Let’s Encrypt 를 결합하여 인증서 발급과 갱신을 100% 무인 자동화합니다.

cert-manager의 핵심 CRD 구조

  • ClusterIssuer: Let’s Encrypt와 통신할 계정 정보(이메일)와 소유권 검증(Challenge) 방식을 정의하는 전역 발급자입니다.
  • Certificate: 특정 도메인(service.example.com)에 대한 인증서를 요청하는 선언서입니다.

도메인 소유권 검증 (Challenge)의 두 가지 방식

Let’s Encrypt는 인증서를 발급하기 전에 “네가 정말 이 도메인의 진짜 주인이 맞느냐”를 증명하도록 요구합니다:

  • HTTP-01 챌린지:
    • cert-manager가 임시 파드를 띄우고, Ingress에 http://example.com/.well-known/acme-challenge/<토큰> 경로를 임시로 만듭니다.
    • Let’s Encrypt 서버가 외부에서 이 URL로 접근하여 토큰 값을 확인하면 검증이 완료됩니다.
    • 간편하지만 와일드카드 인증서(*.example.com)를 발급받을 수 없으며, 방화벽 외부에서 80 포트로 접근이 가능해야 합니다.
  • DNS-01 챌린지:
    • cert-manager가 DNS 제공업체(AWS Route53, Cloudflare 등)의 API를 호출하여 도메인의 TXT 레코드(_acme-challenge.example.com)에 지정된 난수 값을 자동으로 작성합니다.
    • Let’s Encrypt가 DNS를 조회해 해당 TXT 레코드를 확인하면 발급을 승인합니다.
    • 사설망이나 폐쇄망 클러스터에서도 사용 가능하며, 모든 서브도메인을 아우르는 와일드카드 인증서(*.example.com) 발급이 가능하여 기업 환경에서 가장 선호됩니다.

발급된 인증서는 쿠버네티스의 Secret 객체에 저장되고, Ingress Controller가 이를 물고 암호화 통신을 수행합니다. 인증서 만료 30일 전이 되면 cert-manager가 알아서 백그라운드에서 재발급을 완수하므로 엔지니어가 인증서 만료로 새벽에 호출받을 일이 영원히 사라집니다.

5. DNS 레코드 자동 동기화: ExternalDNS

인그레스에 새 도메인(new-service.example.com)을 선언했을 때, 관리자가 AWS Route53이나 Cloudflare 콘솔에 일일이 로그인하여 CNAME 레코드를 수동으로 등록하는 것은 클라우드 네이티브의 자동화 철학에 맞지 않습니다.

ExternalDNS 는 쿠버네티스 인그레스나 서비스 리소스를 실시간 감시하다가, 매니페스트에 적힌 호스트 이름을 읽어 외부 클라우드 DNS 제공업체의 DNS 레코드를 자동으로 생성, 수정, 삭제해 줍니다.

엔지니어가 Git에 인그레스 YAML 파일 하나만 머지하면, [DNS 레코드 등록 ➔ Ingress L7 라우팅 연결 ➔ cert-manager SSL 인증서 발급 ➔ HTTPS 서빙] 까지의 전 과정이 단 1분 만에 전자동으로 완성됩니다.

6. 프로덕션 Ingress & TLS 표준 매니페스트

Let’s Encrypt 프로덕션 발급자와 Ingress-Nginx를 결합한 실무 표준 매니페스트입니다:

# 1. Let's Encrypt ClusterIssuer (HTTP-01 challenge)
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-prod
spec:
  acme:
    server: https://acme-v02.api.letsencrypt.org/directory
    email: admin@example.com
    privateKeySecretRef:
      name: letsencrypt-prod-account-key
    solvers:
    - http01:
        ingress:
          class: nginx
---
# 2. Production Ingress manifest with TLS enabled
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: production-service-ingress
  annotations:
    kubernetes.io/ingress.class: nginx
    # Automatically request certificate via cert-manager
    cert-manager.io/cluster-issuer: letsencrypt-prod
    # Redirect HTTP traffic to HTTPS
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
    # Proxy timeout tuning for long-polling/upload
    nginx.ingress.kubernetes.io/proxy-connect-timeout: "15"
    nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
spec:
  tls:
  - hosts:
    - service.example.com
    secretName: service-example-tls # Secret where issued cert will be saved
  rules:
  - host: service.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: production-web-svc
            port:
              number: 80

7. 정리: 선언만으로 완성되는 외부 트래픽 파이프라인

외부 트래픽을 안전하게 클러스터로 끌어들이는 과정은 개별 도구의 나열이 아니라, 하나의 유기적인 자동화 파이프라인입니다:

  • Ingress / Gateway API: 복잡한 L7 호스트 및 URL 경로 기반의 역방향 프록시 라우팅을 선언적으로 규정합니다.
  • cert-manager: Let’s Encrypt와의 ACME 프로토콜 통신을 통해 신뢰할 수 있는 공인 SSL/TLS 인증서를 무인 발급 및 무중단 갱신합니다.
  • ExternalDNS: 클러스터 안의 도메인 선언을 외부 인터넷 DNS 레코드와 실시간으로 동기화합니다.

인프라 엔지니어가 이 삼각 편대를 클러스터에 견고하게 세팅해 두면, 애플리케이션 개발자는 도메인 발급이나 네트워크 설정에 신경 쓸 필요 없이 단 한 장의 인그레스 매니페스트 작성만으로 안전한 글로벌 HTTPS 서비스를 세상에 공개할 수 있게 됩니다.