[예제] 웹 서버(Nginx)를 파드(Pod)로 띄워보기

JSCODE 박재성

2025-12-06

✅ 웹 서버(Nginx)를 파드(Pod)로 띄워보기

1. yaml 파일 생성하기
nginx-pod.yaml

apiVersion: v1 # Pod를 생성할 때는 v1이라고 기재한다. (공식 문서)
kind: Pod # Pod를 생성한다고 명시
metadata:
  name: nginx-pod # Pod에 이름 붙이는 기능
spec:
  containers:
    - name: nginx-container # 생성할 컨테이너의 이름
      image: nginx # 컨테이너를 생성할 때 사용할 Docker 이미지
      ports:
        - containerPort: 80 # 해당 컨테이너가 어떤 포트를 사용하는 지 명시적으로 표현

• 주의) YAML 문법상 들여쓰기를 할 때 Tab을 사용하면 안 되고 반드시 띄어쓰기를 활용해야 한다.
• spec.containers.ports.containerPort : 실제 작동에는 영향을 미치지 않는다. 단순히 컨테이너가 어떤 포트를 사용하는 지 명시적으로 나타내기 위한 문서화용이다. (Dockerfile의 EXPOSE와 비슷한 역할이다.)
 

2. yaml 파일을 기반으로 파드(Pod) 생성하기

$ kubectl apply -f nginx-pod.yaml # yaml 파일에 적혀져있는 리소스(파드)를 생성

3. 파드(Pod)가 잘 생성됐는 지 확인

$ kubectl get pods # 파드(Pod) 조회



• NAME : Pod의 이름
• READY : (파드 내 준비 완료된 컨테이너 수)/(파드 내 총 컨테이너 수)
• STATUS : 파드의 상태 (Running : 정상적으로 실행 중)
• RESTARTS : 해당 파드의 컨테이너가 재시작된 횟수
• AGE : 파드가 생성되어 실행된 시간

4. Nginx에 정상적으로 접속이 되는 지 확인하기



분명 파드(Pod)로 Nginx를 띄웠는 데 접속이 안 된다. 왜 그럴까?