🚦 포트 지옥에서 탈출하기 – Kubernetes Ingress Controller 구축

서비스가 여러 개 생기면 NodePort 관리가 꽤 귀찮아집니다. 서비스 A는 30080, 서비스 B는 30081, 서비스 C는 30082… IP + 포트 조합을 외우거나 어딘가 적어둬야 합니다. 실제 운영에서는 클라이언트에게 포트 번호를 노출하는 것 자체가 좋지 않습니다. 이걸 해결하는 게 Ingress입니다. 하나의 IP와 80/443 포트로 모든 서비스를 라우팅할 수 있습니다.

---

🗺️ Ingress가 하는 일

클라이언트 → myapp.local:32626 (단일 진입점)
    ↓
Ingress Controller (Nginx)
    ↓ Host: myapp.local → /
    ↓
web-service (백엔드 서비스)
    ↓
web-app Pod들

• 단일 진입점: 여러 서비스를 하나의 IP/포트로 통합
• L7 라우팅: 도메인 이름과 경로(/api, /web 등)로 트래픽 분기
• HTTP/HTTPS 지원: TLS 인증서 관리도 Ingress에서 처리 가능

---

🛠️ 설치 및 구성

Ingress Controller 설치 (베어메탈용)

# 베어메탈 환경용 Nginx Ingress Controller 배포
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.10.1/deploy/static/provider/baremetal/deploy.yaml

# 파드 상태 확인
kubectl get pods -n ingress-nginx

# 외부 노출 포트 확인 (중요!)
kubectl get svc -n ingress-nginx

설치 후 서비스 포트를 확인하면 랜덤한 NodePort가 할당됩니다. 이 실습에서는 32626번으로 할당됐습니다.

백엔드 앱 배포

# web-app.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
      - name: web
        image: nginx:1.21
---
apiVersion: v1
kind: Service
metadata:
  name: web-service
spec:
  selector:
    app: web
  ports:
  - port: 80
    targetPort: 80

Ingress 규칙 정의

# app-ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: app-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: myapp.local              # 도메인 기반 라우팅
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: web-service
            port:
              number: 80

DNS 우회 설정 (로컬 테스트용)

실제 DNS가 없으니 /etc/hosts에 직접 추가합니다.

# Linux/Mac
echo "192.168.56.10 myapp.local" | sudo tee -a /etc/hosts

# Windows: C:\Windows\System32\drivers\etc\hosts 에 추가
# 192.168.56.10 myapp.local

# 접속 테스트
curl http://myapp.local:32626

---

🚨 삽질 포인트 1 — “30080으로 접속이 된다?”

Ingress를 설정했는데 이전 실습에서 만들었던 NodePort(30080)로 접속하니 여전히 됩니다. 처음엔 “Ingress가 잘 설정됐나?” 하고 착각했는데, 실제로는 Ingress를 전혀 거치지 않고 과거 NodePort 서비스로 직접 연결되고 있던 겁니다.

# 이전 실습 잔재 정리
kubectl delete svc nginx-nodeport

정리 후 30080은 Connection Refused가 되고, Ingress 포트 32626으로만 접속이 됩니다. 리소스 정리를 습관화해야 한다는 교훈이었습니다.

---

🚨 삽질 포인트 2 — IP로 직접 접속하면 404

http://192.168.56.10:32626으로 접속하면 404 Not Found가 뜹니다.

원인: Ingress는 HTTP 요청의 Host 헤더를 보고 라우팅합니다. IP로 접속하면 Host 헤더가 IP 주소가 되어 규칙과 일치하지 않습니다.

# IP로 접속할 때 Host 헤더를 명시하면 작동
curl -H "Host: myapp.local" http://192.168.56.10:32626

브라우저 테스트는 반드시 도메인 이름으로 해야 합니다.

---

💡 NodePort vs Ingress 비교

항목	NodePort	Ingress
포트 관리	서비스마다 별도 포트	단일 80/443 포트
도메인 기반 라우팅	❌	✅
경로 기반 라우팅	❌	✅
TLS 인증서	별도 처리 필요	Ingress에서 통합 관리
사용 케이스	개발/간단한 테스트	프로덕션

---

✅ 정리

Ingress Controller를 쓰면 “단일 진입점”이 생깁니다. L7 계층의 지능형 라우팅 덕분에 도메인과 경로만으로 수십 개의 서비스를 깔끔하게 관리할 수 있습니다.

다음 글에서는 파드가 재시작돼도 데이터가 사라지지 않도록 하는 PV/PVC와 StatefulSet을 다룹니다.