FastAPI Cloud 훑어보기: fastapi deploy 한 줄로 배포까지

FastAPI 공식 튜토리얼을 따라가다 보면 "앱 배포하기(선택 사항)" 섹션에서 낯선 명령어를 하나 만난다.

$ uv run fastapi deploy

Deploying to FastAPI Cloud...

✅ Deployment successful!

🐔 Ready the chicken! Your app is ready at https://myapp.fastapicloud.dev

uv run fastapi dev까지는 익숙한데 fastapi deploy는 처음 보여서 찾아봤다. FastAPI Cloud(fastapicloud.com)에 대한 정리.

FastAPI Cloud란

FastAPI Cloud는 FastAPI를 만든 저자와 팀이 직접 만든 배포 플랫폼이다. FastAPI로 앱을 만들 때 느꼈던 개발자 경험(DX)을 그대로 배포 단계까지 이어가겠다는 게 목표다.

FastAPI Cloud는 FastAPI and friends 오픈소스 프로젝트의 주요 스폰서이자 자금 제공자이기도 하다.

핵심 문장은 공식 문서에 있는 이 한 줄이다.

선택적으로 FastAPI 앱을 한 번의 명령어로 FastAPI Cloud에 배포할 수 있다.

즉 Docker 이미지를 빌드하고, 레지스트리에 올리고, 인프라를 설정하는 과정 없이 fastapi deploy 한 번으로 끝낸다는 컨셉이다.

왜 필요한가

FastAPI 자체는 오픈소스고 표준(ASGI, OpenAPI)을 따르기 때문에 원래도 아무 클라우드에나 배포할 수 있다. 다만 그 과정에서 컨테이너화, 오토스케일링 설정, HTTPS 인증서, 환경 변수 관리 같은 반복 작업이 매번 들어간다.

FastAPI Cloud는 이 반복 작업을 CLI 한 줄 뒤로 감춘다. 랜딩 페이지에서 강조하는 지점도 결국 "설정 없는 배포"다.

• Effortless deploys: 설정 파일 없이 배포
• On-demand scaling: 요청량에 따른 오토스케일링
• Scale to zero: 트래픽이 없으면 0으로 줄여서 비용 절감
• Secure by default: 기본 HTTPS 적용

어떻게 동작하는가

과정은 세 단계로 요약된다.

1. FastAPI 앱을 평소처럼 작성한다.

   from fastapi import FastAPI
   
   app = FastAPI()
   
   @app.get("/")
   def main():
       return {"message": "Hello World"}

2. 터미널에서 명령 하나를 실행한다.

   uv run fastapi deploy

3. 프로덕션에 올라간다.

   {"message": "Hello World"}

CLI가 프로젝트 구조를 자동으로 감지해서 배포하고, 로그인이 안 되어 있으면 인증을 위해 브라우저가 자동으로 열린다. pyproject.toml, uv.lock, requirements.txt 어떤 조합이든 표준 파이썬 프로젝트라면 그대로 인식한다.

fastapi-cloud-cli는 이미 딸려온다

여기가 개인적으로 제일 흥미로웠던 부분이다. uv add "fastapi[standard]"로 설치하면 fastapi-cli[standard]가 같이 깔리는데, 여기에 fastapi-cloud-cli가 기본 포함되어 있다. 즉 별도 설치 없이 fastapi deploy 명령을 바로 쓸 수 있는 이유가 여기 있다.

굳이 빼고 싶다면 이렇게 설치하면 된다.

uv add "fastapi[standard-no-fastapi-cloud-cli]"

요금제 (Public Beta 기준)

항목	Hobby	Pro
가격	$0/월	$20/좌석/월
앱 개수	3개	25개
커스텀 도메인	1개	20개
리소스	0.1 vCPU / 512MB (공유)	0.1 vCPU / 512MB
오토스케일	최대 3 replica	최대 10 replica
로그·메트릭 보관	1일	14일
팀원	1명	최대 10명
지원	커뮤니티 Slack	우선 Slack 지원

Hobby는 신용카드 없이 바로 시작 가능하고, 개인 프로젝트나 학습용으로 충분한 스펙이다. 팀 단위 협업(RBAC, 우선 지원)이 필요해지면 Pro로 넘어가는 구조.

다른 클라우드에 배포하고 싶다면

FastAPI Cloud를 꼭 써야 하는 건 아니다. FastAPI는 오픈소스고 표준 기반이라 원하는 클라우드 제공자 가이드를 따라 어디에든 배포할 수 있다. 공식 문서도 이 부분을 명확히 하고 있다. FastAPI Cloud는 "가장 빠른 기본 경로" 정도로 이해하면 될 것 같다.

정리

• fastapi deploy는 FastAPI 공식 튜토리얼 마지막에 등장하는 선택 사항이다.
• FastAPI Cloud는 FastAPI 저자 팀이 만든, FastAPI 전용 배포 플랫폼이다.
• 설정 파일 없이 CLI 한 줄로 배포, 오토스케일링, scale-to-zero, 기본 HTTPS를 제공한다.
• fastapi[standard]를 설치하면 fastapi-cloud-cli가 기본 포함되어 있어 바로 fastapi deploy를 쓸 수 있다.
• Public Beta 기준 Hobby(무료)/Pro($20/좌석) 두 플랜이 있고, 다른 클라우드로 배포하는 것도 여전히 자유롭다.

참고: fastapicloud.com, FastAPI 공식 문서 - 앱 배포하기