[250314] AWS Docker 배포 정리

AWS Docker 배포 개요

Django 프로젝트를 Docker 컨테이너로 패키징한 후, AWS EC2에 배포하는 과정은 다음과 같습니다.

1. Django 프로젝트 준비
   • 프로젝트 정상 실행 확인
   • requirements.txt 생성
2. Docker 컨테이너화
   • Dockerfile & docker-compose.yml 작성
   • Docker 이미지 빌드 및 실행
3. AWS 계정 생성 및 IAM 설정
   • AWS 계정 생성
   • IAM 사용자 생성 (보안 키 발급)
   • AWS CLI 설정
4. EC2 인스턴스 생성 및 접속
   • Ubuntu 기반 서버 만들기
   • Windows & Mac에서 SSH 접속
5. Docker & Docker Compose 설치
   • AWS EC2에 Docker 환경 구축
6. Docker 컨테이너 배포
   • Docker 이미지 AWS 서버로 전송
   • Docker Compose로 컨테이너 실행
7. PostgreSQL RDS 데이터베이스 설정
   • AWS RDS에서 PostgreSQL 생성
   • Django와 연결
8. NGINX + HTTPS 적용 (선택 사항)
   • NGINX 리버스 프록시 설정
   • Let's Encrypt로 HTTPS 적용

---

1️⃣ Django 프로젝트 준비

🔹 1-1. 프로젝트 정상 실행 확인

로컬에서 프로젝트가 정상적으로 실행되는지 확인할 것.

python manage.py runserver

✔ 정상 실행되면 브라우저에서 http://127.0.0.1:8000 확인

---

🔹 1-2. requirements.txt 파일 생성

AWS에서 필요한 패키지를 설치할 수 있도록 리스트를 만들기.

pip freeze > requirements.txt

✔ 이 파일을 Docker 컨테이너에서도 사용할 예정

---

2️⃣ Docker 컨테이너화

이제 Django 프로젝트를 Docker로 컨테이너화.

🔹 2-1. Dockerfile 작성

루트 디렉터리에 Dockerfile을 만들고 다음 내용을 추가해야함.

# 1. 베이스 이미지 설정
FROM python:3.9

# 2. 작업 디렉토리 설정
WORKDIR /app

# 3. 필요한 패키지 설치
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 4. 프로젝트 파일 복사
COPY . .

# 5. 포트 개방
EXPOSE 8000

# 6. Django 서버 실행 명령
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "myproject.wsgi:application"]

---

🔹 2-2. docker-compose.yml 작성

Django + PostgreSQL을 컨테이너로 실행하려면 docker-compose를 사용.

version: '3.8'

services:
  web:
    build: .
    container_name: django_app
    restart: always
    depends_on:
      - db
    ports:
      - "8000:8000"
    environment:
      - DEBUG=True
      - DATABASE_URL=postgres://myuser:mypassword@db:5432/mydatabase

  db:
    image: postgres:13
    container_name: postgres_db
    restart: always
    environment:
      POSTGRES_DB: mydatabase
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
    ports:
      - "5432:5432"

---

🔹 2-3. Docker 컨테이너 빌드 및 실행

1) Docker 이미지 빌드

docker build -t my-django-app .

2) Docker Compose로 컨테이너 실행

docker-compose up -d

✔ 이제 컨테이너가 실행되고, localhost:8000에서 Django 확인 가능

---

3️⃣ AWS 계정 생성 및 IAM 설정

AWS 서비스를 사용하려면 계정을 생성하고 IAM 사용자 생성.

🔹 3-1. AWS CLI 설정 (Windows & Mac)

1) AWS CLI 설치

• AWS CLI 다운로드 후 설치

2) IAM 사용자 연결

aws configure

이후 아래 정보를 입력:

AWS Access Key ID [None]: (액세스 키 입력)
AWS Secret Access Key [None]: (시크릿 액세스 키 입력)
Default region name [None]: ap-northeast-2 (서울)
Default output format [None]: json

---

4️⃣ EC2 인스턴스 생성 및 접속

AWS에서 Django를 실행할 서버(EC2)를 만들어야함.

🔹 4-1. EC2 인스턴스 생성

1. AWS 콘솔 → EC2 서비스 이동
2. Ubuntu 22.04 LTS 선택
3. t2.micro (무료 티어) 선택
4. 보안 그룹에서 HTTP(80), HTTPS(443), SSH(22), 8000 포트 열기
5. 키 페어 생성 후 다운로드

---

🔹 4-2. Windows & Mac에서 SSH 접속

ssh -i "mykey.pem" ubuntu@<EC2 퍼블릭 IP>

---

5️⃣ Docker & Docker Compose 설치

EC2 서버에 Docker 환경을 구축.

sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker

---

6️⃣ Docker 컨테이너 배포

1) 로컬에서 EC2로 프로젝트 전송

scp -i "mykey.pem" -r myproject ubuntu@<EC2 퍼블릭 IP>:~

2) EC2에서 컨테이너 실행

cd myproject
docker-compose up -d --build

✔ EC2 퍼블릭 IP:8000에서 Django가 실행됨

---

7️⃣ AWS RDS PostgreSQL 연결

1. AWS 콘솔 → RDS 서비스 이동
2. PostgreSQL 데이터베이스 생성
3. settings.py 수정:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_db_name',
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_password',
        'HOST': 'your_rds_endpoint',
        'PORT': '5432',
    }
}

1. 마이그레이션 적용

python manage.py migrate

---

8️⃣ NGINX + HTTPS 적용 (선택 사항)

1) NGINX 설정

sudo nano /etc/nginx/sites-available/django

server {
    listen 80;
    server_name <EC2 퍼블릭 IP>;

    location / {
        proxy_pass http://127.0.0.1:8000;
    }
}

sudo ln -s /etc/nginx/sites-available/django /etc/nginx/sites-enabled
sudo systemctl restart nginx

---

✅ Django + Docker + AWS 배포

이제 http://<EC2 퍼블릭 IP>에서 Django 프로젝트를 확인 가능
추가로 Route 53으로 도메인 연결 및 HTTPS 적용도 가능

💻배포 방법 종류 비교

AWS 배포: Elastic Beanstalk vs App Runner vs EC2 + Docker (우리는 뭘 해야 할까?)

AWS에서 Django + Docker 프로젝트를 배포할 때 사용할 수 있는 옵션은 크게 3가지:

1. EC2 + Docker (기본적인 배포 방법 - 우리가 지금 사용 중!)
2. Elastic Beanstalk (AWS에서 자동 배포 + 관리 제공)
3. App Runner (완전 자동화된 컨테이너 배포 - 단, 제약 많음)

---

🔹 1. EC2 + Docker (우리가 지금 사용 중)

우리가 현재 진행하는 방식

✅ 장점

• 완전한 자유도 (서버 설정, DB 연동, NGINX 등 모두 직접 설정 가능)
• 비용이 저렴함 (무료 티어 사용 가능)
• 확장성이 뛰어남 (필요하면 직접 로드 밸런싱 추가 가능)

❌ 단점

• 설정이 많음 (서버, Docker, NGINX, HTTPS 등 직접 설정해야 함)
• 서버 관리 필요 (보안 업데이트, 스케일링 등 직접 처리해야 함)

---

🔹 2. AWS Elastic Beanstalk (EB)

• AWS가 서버, 로드 밸런싱, 배포까지 자동으로 설정해주는 서비스
• Docker를 지원하므로, Docker 컨테이너를 올려서 배포 가능

✅ 장점

• 배포가 간단함 (AWS가 자동으로 설정)
• 로드 밸런싱 & 스케일링 자동 지원
• Docker 지원 → Docker 컨테이너를 올리면 끝!

❌ 단점

• 커스텀 설정이 어렵다 (NGINX, 보안, 배포 방식 등을 세세하게 조정하기 어려움)
• 비용이 EC2보다 비쌈 (무료 티어 사용 가능하지만, 추가적인 AWS 리소스 사용 가능성 높음)

✅ Elastic Beanstalk을 사용해야 할 때

• 빠르게 배포하고 싶을 때
• 서버 관리를 AWS에게 맡기고 싶을 때
• 자동 스케일링 & 로드 밸런싱이 필요한 경우

---

🔹 3. AWS App Runner

완전히 관리형 서비스 → Docker 컨테이너를 올리면 AWS가 알아서 배포!

✅ 장점

• 설정이 거의 필요 없음 (완전 자동화)
• 로드 밸런싱 & HTTPS 자동 지원
• 배포가 가장 빠름 (컨테이너만 올리면 끝)

❌ 단점

• PostgreSQL RDS 연결이 번거로움 (VPC 설정 필요)
• 비용이 가장 비쌈 (무료 티어 없음)
• 세부 설정이 불가능함 (NGINX, 환경 변수 설정 제한)

✅ App Runner를 사용해야 할 때

• 정말 빠르고 간단하게 배포하고 싶을 때
• 서버 관리를 완전히 AWS에게 맡기고 싶을 때
• 돈이 좀 더 들더라도 쉽게 운영하고 싶을 때

---

우리는 뭘 선택해야 할까?

항목	EC2 + Docker	Elastic Beanstalk	App Runner
설정 난이도	어려움 (모든 설정 직접)	중간 (AWS가 자동 설정)	가장 쉬움 (완전 자동)
배포 속도	느림 (서버 구축 필요)	빠름 (자동화)	매우 빠름 (컨테이너만 올리면 끝)
커스텀 가능성	높음 (자유롭게 설정 가능)	중간 (AWS 기본 설정 따름)	거의 없음 (AWS가 알아서 설정)
서버 관리	직접 해야 함	일부 AWS가 관리	AWS가 모두 관리
비용	저렴함 (무료 티어 가능)	중간 (EC2보다 비쌈)	가장 비쌈 (무료 티어 없음)
확장성	직접 설정 가능	자동 스케일링 지원	자동 스케일링 지원

---

결론: 우리는 어떤 방법을 사용해야 할까?

1) 직접 서버를 설정하면서 "배포 개념"을 배우고 싶다면 → EC2 + Docker (현재 진행 중!)

• 우리가 지금 하고 있는 방식이야!
• Docker 컨테이너를 AWS EC2에 배포하는 경험을 쌓을 수 있음
• AWS 서버 설정, NGINX, PostgreSQL 연결까지 직접 경험 가능
• 배포 자동화(추후 CI/CD 적용)도 가능함

2) "빠르고 간편한 배포"를 원한다면 → Elastic Beanstalk (EB)

• Docker 컨테이너만 올려서 배포 가능
• 로드 밸런싱 & 스케일링 자동 지원
• 서버 설정을 AWS가 알아서 해줌
• Django + PostgreSQL RDS 연결이 쉬움
  ✔ "빠르고 간단하게 배포하고 싶다!"면 Elastic Beanstalk 추천

3) "최대한 쉽게 & 서버 관리 없이 배포"하고 싶다면 → AWS App Runner

• Docker 컨테이너만 올리면 AWS가 자동 배포
• 설정이 거의 필요 없음 (가장 쉬운 배포 방법)
• 비용이 가장 비싸지만, 서버 관리 없이 운영 가능
  ✔ "서버 설정을 전혀 하고 싶지 않다!"면 App Runner 추천

---

우리가 선택해야 할 AWS 배포 방법

• 단기적으로는? → EC2 + Docker로 배포 (현재 진행 중!)
• 장기적으로는? → Elastic Beanstalk (EB)로 배포 자동화 고려

---

최종 결론

• "AWS를 배우면서 직접 배포 & 설정을 익히자!" → EC2 + Docker 배포 진행 (현재 방식 유지!)
• "나중에 배포를 자동화하고 싶다!" → Elastic Beanstalk 사용 고려 (자동 배포 가능!)
• "서버 관리 없이 제일 쉽게 배포하고 싶다!" → App Runner 가능 (하지만 비용 ↑)