Docker 실전 가이드: Nginx 컨테이너 실습

  • 최초 작성일: 2025년 2월 6일 (목)


목차

  1. 실습 개요
  2. 도커 환경 확인
  3. Nginx 컨테이너 실행
  4. 웹페이지 접속 및 확인
  5. 컨테이너 종료 및 삭제
  6. 정리


실습 개요

이 실습에서는 Docker를 이용하여 Nginx 웹 서버 컨테이너를 실행하고 접속하는 방법을 설명한다.

실습 목표

  1. Docker 명령어를 사용하여 컨테이너 실행
  2. Nginx 컨테이너가 제공하는 웹페이지 접속
  3. 컨테이너 종료 및 삭제 방법 학습

Nginx는 전 세계적으로 많이 사용되는 웹 서버이며, 컨테이너 환경에서 빠르고 간편하게 배포할 수 있다.

도커 환경 확인

1. Docker 버전 확인

먼저 도커가 정상적으로 실행되고 있는지 확인한다.

docker version

이 명령어를 실행하면 클라이언트와 서버의 버전 정보를 확인할 수 있다.

image

2. Docker 시스템 정보 확인

현재 실행 중인 Docker 환경에 대한 자세한 정보를 확인하려면 다음 명령어를 실행한다.

docker info

이 명령어를 실행하면 다음과 같은 정보를 확인할 수 있다:

  • 실행 중인 컨테이너 개수
  • 사용 중인 이미지 개수
  • 시스템의 OS 및 CPU 정보

image


Nginx 컨테이너 실행

1. 기본적인 Docker 실행 명령어

컨테이너를 실행하려면 docker run 명령어를 사용한다.

docker run -p 80:80 --name hellonginx nginx

2. 실행 옵션 설명

  • -p 80:80 → 호스트의 80 포트를 컨테이너의 80 포트로 연결
  • --name hellonginx → 컨테이너 이름을 hellonginx로 지정
  • nginx → 사용할 이미지(웹서버 소프트웨어) 지정

이 명령어를 실행하면 Nginx 웹 서버가 컨테이너 내부에서 실행된다.

image


웹페이지 접속 및 확인

Nginx가 실행되었으면 웹 브라우저를 열고 localhost 또는 127.0.0.1에 접속한다.

http://localhost

정상적으로 실행되었다면 “Welcome to Nginx!”라는 기본 웹페이지가 표시된다.

image

또한, 터미널에서 다음 명령어를 사용하여 컨테이너 내부 로그를 확인할 수도 있다:

docker logs hellonginx


컨테이너 종료 및 삭제

1. 실행 중인 컨테이너 중지

컨테이너 실행을 중지하려면 다음 명령을 실행한다:

ctrl + c  # 실행 중인 컨테이너 종료 (터미널 점유 상태에서)

또는 아래 명령어를 사용하여 특정 컨테이너를 종료할 수도 있다:

docker stop hellonginx


2. 컨테이너 삭제

실행이 종료된 컨테이너를 삭제하려면 다음 명령을 실행한다:

docker rm hellonginx

이제 컨테이너가 완전히 제거되었다.


정리

이 실습에서는 Docker를 사용하여 Nginx 웹 서버 컨테이너를 실행하고 관리하는 방법을 설명했다.

주요 내용 정리

  1. Docker 버전 및 환경 확인
  2. Nginx 컨테이너 실행 및 웹페이지 접속
  3. 컨테이너 로그 확인 및 종료, 삭제

컨테이너를 사용하면 단순한 명령어 한 줄로 빠르게 웹 서버를 실행할 수 있으며, 별도의 환경 설정 없이 다양한 서비스를 배포할 수 있다.

다음 파트에서는 Docker 이미지의 개념과 관리 방법에 대해 자세히 다룬다.