Nginx Docker & Kubernetes 배포 가이드¶

이 문서는 Docker 및 Kubernetes 환경에서 Nginx를 배포하고 운용하기 위한 설정 방법(Dockerfile, YAML 매니페스트 등)을 다룹니다.

1. Dockerfile을 이용한 Nginx 이미지 구성¶

Nginx 애플리케이션을 컨테이너로 패키징하기 위해 Dockerfile을 작성합니다.

기본 이미지 지정: FROM nginx:latest를 사용합니다.
컨텐츠 수정: RUN 명령어로 정적 파일을 수정하거나 설정할 수 있습니다.
포트 노출: EXPOSE 80으로 포트를 명시합니다.

작성 예시:

# Nginx 이미지를 기본 이미지로 사용
FROM nginx:latest

# index.html의 내용을 "hello world"로 교체
RUN echo "hello world" > /usr/share/nginx/html/index.html

# 컨테이너의 80번 포트 외부 노출 허용
EXPOSE 80

docker build -t hello . 명령어로 이미지를 빌드합니다.

2. Kubernetes Deployment 설정 (YAML)¶

Kubernetes에서 Nginx를 배포하고 관리하기 위해 Deployment 리소스를 정의합니다.

replicas: 파드 개수 설정.
selector: 관리할 파드 식별.
template: 파드 명세 (이미지, 리소스 등).

작성 예시:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
  labels:
    app: nginx
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 3
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:alpine
        resources:
          requests:
            cpu: 100m
            memory: 200Mi
          limits:
            cpu: 100m
            memory: 200Mi

kubectl create -f <filename>.yaml 명령어로 생성합니다.

3. Kubernetes Service 설정 (네트워크 노출)¶

배포된 Nginx 파드에 접근하기 위해 Service를 설정합니다.

selector: app: nginx 등을 지정하여 트래픽 전달 대상 파드 선택.
ports: 서비스 포트와 타겟 포트 매핑.
type: ClusterIP, NodePort, LoadBalancer 중 선택.

작성 예시:

apiVersion: v1
kind: Service
metadata:
  name: nginx
spec:
  selector:
    app: nginx
  ports:
  - name: service0
    targetPort: 80   # 파드 포트
    port: 8080       # 서비스 접근 포트
    protocol: TCP
  type: ClusterIP

클러스터 내부에서 nginx:8080으로 접근 가능합니다.

4. Kubernetes Ingress 설정 (HTTP 라우팅)¶

외부 도메인이나 경로를 통해 접근하려면 Ingress를 사용합니다.

rules: 호스트와 경로를 정의하고 백엔드 서비스로 라우팅.

작성 예시:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: test-ingress
spec:
  rules:
    - host: www.example.com
      http:
        paths:
          - path: /
            pathType: ImplementationSpecific
            backend:
              service:
                name: nginx
                port:
                  number: 8080

www.example.com 트래픽을 nginx 서비스의 8080 포트로 전달합니다.

5. ConfigMap을 활용한 설정 관리¶

설정 파일(nginx.conf 등)을 이미지와 분리하여 ConfigMap으로 관리할 수 있습니다.

활용: ConfigMap을 생성하고 파드 볼륨으로 마운트하여 설정 파일처럼 사용합니다.
장점: 이미지를 다시 빌드하지 않고도 설정을 변경할 수 있습니다.