[python] FastAPI에서 배포 전략 설정하기

01 Dec 2023

python

FastAPI는 빠른 속도와 간편한 개발 경험을 제공하는 파이썬 기반의 웹 프레임워크입니다. 이번 포스트에서는 FastAPI 애플리케이션의 배포 전략을 설정하는 방법에 대해 알아보겠습니다.

배포 환경 구성

FastAPI 애플리케이션을 배포하기 전에, 우선 배포 환경을 구성해야 합니다. 이는 애플리케이션이 실행될 서버의 설정과 종속성 관리를 포함합니다.

서버 환경 설정:
- 원하는 운영체제(예: Ubuntu, CentOS)를 선택하고 설치합니다.
- 필요한 패키지(예: Docker, Nginx)를 설치합니다.
- 필요에 따라 SSL 인증서를 생성하여 HTTPS를 사용할 수 있도록 설정합니다.
애플리케이션 종속성 관리:
- requirements.txt 파일을 생성하고, 애플리케이션에 필요한 패키지와 버전을 명시합니다.
- pip 명령어를 사용하여 종속성을 설치합니다.

WSGI 서버를 사용하여 배포하기

FastAPI 애플리케이션을 배포하기 위해 가장 일반적으로 사용되는 방법은 WSGI(Web Server Gateway Interface) 서버를 사용하는 것입니다. WSGI 서버는 요청을 받아 FastAPI 애플리케이션과의 통신을 관리하는 역할을 합니다.

Gunicorn 설치:
```
$ pip install gunicorn
```
Gunicorn으로 FastAPI 애플리케이션 실행:
```
$ gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker
```
- main은 FastAPI 애플리케이션 객체를 정의한 파일의 이름입니다.
- -w 4는 4개의 워커 프로세스를 생성하여 배포 성능을 향상시킵니다.
- -k uvicorn.workers.UvicornWorker는 Uvicorn 워커를 사용하여 FastAPI 애플리케이션과 통신합니다.

Nginx를 사용하여 Reverse Proxy 설정:

$ sudo apt-get install nginx

/etc/nginx/sites-available/default 파일을 열고 다음과 같이 수정합니다:

server {
  listen 80;
  server_name YOUR_DOMAIN;

  location / {
      proxy_pass http://127.0.0.1:8000;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Forwarded-Proto $scheme;
  }
}

Nginx를 다시 시작하여 설정 적용:
```
$ sudo service nginx restart
```

이제 FastAPI 애플리케이션이 배포되었습니다. Nginx는 클라이언트로부터의 요청을 받아 FastAPI 서버로 전달하고, Gunicorn은 FastAPI 애플리케이션과의 통신을 관리합니다.

추가적인 배포 전략 설정

FastAPI 애플리케이션을 배포하는 동안 추가적으로 고려해야 할 사항들이 있습니다. 예를 들어, 로깅을 설정하여 오류를 모니터링하고, 액세스 제어를 위한 인증과 권한 부여를 구현하는 것 등이 있습니다.

애플리케이션 로깅:
- Python Logging 모듈을 사용하여 로깅 설정합니다.
- 로그 파일의 경로와 로깅 레벨 등을 설정할 수 있습니다.
인증과 권한 부여:
- FastAPI 인증을 사용하여 사용자 인증과 권한 부여를 구현할 수 있습니다.
- JWT(JSON Web Tokens) 또는 세션 기반 인증 등을 사용할 수 있습니다.

배포 전략 설정은 애플리케이션의 안정성과 확장성에 매우 중요합니다. FastAPI와 함께 이러한 전략들을 설정하여 안정적이고 확장 가능한 애플리케이션을 배포할 수 있습니다.