React, Django, Nginx 배포 이슈 정리

1. Docker 및 Docker Compose 관련 문제

• 문제 1: Nginx 설정 오류 (nginx -t 명령어 관련)

  • 설명: nginx -t 명령어를 실행했을 때 web:8000 호스트를 찾을 수 없다는 오류가 발생함.
  • 해결 방법: Docker Compose 파일에서 web 서비스가 정상적으로 실행 중인지 확인하고, 서비스 이름이 올바르게 설정되었는지 점검. docker-compose ps 명령어로 컨테이너 상태를 확인하고, 필요한 경우 docker-compose up -d로 서비스를 다시 시작한다.

• 문제 2: Docker 컨테이너 접근 시 권한 문제

  • 설명: Docker 컨테이너에 접근할 때 Permission denied 오류가 발생함.
  • 해결 방법: sudo 명령어를 사용하여 Docker 명령어를 실행하거나, 현재 사용자를 docker 그룹에 추가하여 권한 문제를 해결. 사용자를 그룹에 추가하려면 sudo usermod -aG docker $USER 명령어를 사용.

• 문제 3: Docker Compose 컨테이너 중 하나가 종료됨

  • 설명: web 컨테이너가 종료되고, upstream 설정에서 호스트를 찾을 수 없는 문제가 발생함.
  • 해결 방법: docker-compose logs web 명령어로 종료된 컨테이너의 로그를 확인하여 문제를 파악한 후, 문제를 해결하고 컨테이너를 재시작.

2. Certbot 및 SSL 인증 관련 문제

• 문제 1: Certbot 갱신 시도가 실패하거나 필요하지 않음

  • 설명: Certbot 로그에 갱신할 인증서가 없다는 메시지가 표시됨.
  • 해결 방법: 현재 사용 중인 인증서가 만료되지 않았거나 갱신이 필요하지 않음을 의미. 인증서 갱신이 필요하다면 sudo docker-compose run certbot certonly --webroot -w /var/www/certbot -d 도메인명 명령어로 강제 갱신을 시도 가능.

• 문제 2: Certbot 로그 확인

  • 설명: Certbot 로그를 통해 갱신 및 발급 상태를 확인하고 싶을 때.
  • 해결 방법: Certbot 컨테이너에 접속하여 /var/log/letsencrypt/letsencrypt.log 파일을 확인. 해당 로그 파일에서 인증서 발급 또는 갱신 상태를 확인 가능.

3. Git 관련 문제

• 문제 1: GitHub 푸시 시 인증 오류

  • 설명: GitHub에서 HTTPS를 통해 푸시할 때 비밀번호 인증이 실패함.
  • 해결 방법: GitHub에서 PAT(Personal Access Token)를 생성하여 사용해야함. 비밀번호 대신 토큰을 사용하여 인증 문제를 해결.

• 문제 2: Git 브랜치 푸시 설정 오류

  • 설명: git push --set-upstream origin dev 명령어로 dev 브랜치를 원격에 연결하는 과정에서 혼란이 발생함.
  • 해결 방법: 이 명령어는 현재 브랜치를 원격 저장소의 dev 브랜치와 연결해주는 역할을 함. 만약 이 설정을 해제하고 싶다면 git branch --unset-upstream 명령어를 사용하여 원격 트래킹 설정을 해제 가능.

• 문제 3: Git 파일 추가 시 권한 문제

  • 설명: 특정 파일을 Git에 추가할 때 권한 문제로 인해 실패함.
  • 해결 방법: sudo를 사용하여 파일을 추가하거나, 해당 파일의 권한을 변경한 후 다시 시도.

4. Build 및 퍼포먼스 관련 문제

• 문제 1: Lightsail에서 Docker 컨테이너 빌드 속도가 느림
  • 설명: AWS Lightsail에서 Docker 컨테이너를 빌드할 때 빌드 속도가 매우 느림.
  • 해결 방법: Lightsail의 리소스(특히 RAM과 CPU)가 빌드 과정에 충분하지 않을 수 있음. 해결 방법으로는 로컬에서 빌드를 완료한 후 결과물을 서버에 업로드하는 방법, Lightsail의 인스턴스 크기를 업그레이드하는 방법이 있음.