구글 클라우드 콘솔 vm에 FastAPI서버 구축 따라잡기(카톡봇용)

소개

스터디장님의 DigitalOcean 기반 FastAPI 구축 사례를 참고해서, 이번엔 구글 클라우드 콘솔(GCP) VM을 활용해 FastAPI 서버를 구축해보았습니다.

저는 스터디 오프라인 모임을 놓쳐 아쉬웠던 마음을 실천력으로 전환! 직접 진도를 따라잡으며 실습했습니다. 목표는 나중에 카카오톡 챗봇과 연동할 FastAPI 서버를 손수 띄워보는 것이었습니다.

진행 방법

🛠️ VM 인스턴스 생성 (요약)

구글 클라우드 콘솔(GCP) 접속
"VM 인스턴스" 메뉴에서 인스턴스 생성
Ubuntu 20.04/22.04 선택, 머신 사양은 최소로
포트 8000 열기 위해 방화벽 설정 체크 ✅

➡️ VM 생성 방법은 공식 문서 또는 유튜브에 잘 나와 있어요!

🧑‍💻 SSH 접속 후 FastAPI 서버 구성

1. 서버 업데이트

sudo apt update && sudo apt upgrade -y

2. 기본 패키지 설치

sudo apt install -y python3 python3-pip python3-venv

3. FastAPI 프로젝트 폴더 만들기 및 가상환경 실행

mkdir fastapi-project
cd fastapi-project
python3 -m venv venv
source venv/bin/activate

4. FastAPI 및 Uvicorn 설치

pip install fastapi "uvicorn[standard]"

5. main.py 파일 만들기

nano main.py

6. 아래 코드 복사/붙여넣기 후 저장

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello World", "status": "FastAPI is running!"}

@app.get("/health")
def health_check():
    return {"status": "healthy"}

7. 서버 실행

uvicorn main:app --reload --host 0.0.0.0 --port 8000

8. 방화벽 규칙으로 외부 접속 허용 (포트 8000)

GCP → VPC 네트워크 → 방화벽 규칙 → 새 규칙 만들기
포트: 8000
소스 IP: 0.0.0.0/0

결과와 배운 점

✅ 성공 화면 확인

http://내서버IP:8000/ → 아래와 같이 응답:

💡 배운 점 & 깨달음

구글 클라우드에서도 FastAPI 서버를 쉽게 띄울 수 있다!
앞으로 여기에 카톡봇을 뭘 오똫게 연결할지? 찾아봐야겠다.

🧱 질문 : 아래 내용이 이해가 잘 안갑니다~

도움 받은 글

스터디장님의 FastAPI 서버 구축기 👉 사례 보러 가기

AI의 파도, 함께하면 이뤄낼 수 있어요! 22기 스터디 사전판매 시작 🚀