Cloud Run 배포 가이드

1 사전 준비

Cloud Run 배포에 필요한 것들:

Google Cloud 계정 (무료 크레딧 $300 제공)
Google Cloud CLI (gcloud) 설치
Docker (선택사항 - 로컬 테스트용)

2 Dockerfile 작성

백엔드 폴더에 Dockerfile을 생성합니다:

Dockerfile

FROM python:3.11-slim

WORKDIR /app

# 의존성 설치
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 애플리케이션 복사
COPY . .

# Cloud Run은 PORT 환경변수를 사용
ENV PORT=8080
EXPOSE 8080

# 서버 실행
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8080"]

3 배포하기

터미널

# Google Cloud 로그인
gcloud auth login

# 프로젝트 설정 (YOUR_PROJECT_ID를 본인의 프로젝트 ID로 변경)
gcloud config set project YOUR_PROJECT_ID

# Cloud Run에 배포
gcloud run deploy my-admin-api \
  --source . \
  --region asia-northeast3 \
  --allow-unauthenticated

배포가 완료되면 https://my-admin-api-xxxxx.run.app 형태의 URL이 생성됩니다.

4 프론트엔드 연결

Cloudflare Pages의 환경변수에 백엔드 URL을 설정합니다:

Variable name

VITE_API_URL

Value

https://my-admin-api-xxxxx.run.app

비용 안내

Cloud Run은 요청이 없을 때는 비용이 발생하지 않습니다 (scale to zero). 무료 티어로 월 200만 건의 요청까지 무료입니다. 자세한 가격 정책 →