"배포 입문 (6/7) — 무료 배포 3: Railway로 백엔드와 풀스택 앱 운영하기"

-

앱이 "파일을 보여 주는 것"을 넘어 "계속 살아 있는 프로세스"가 되는 순간, 배포의 기준도 바뀐다.

핵심 요약

  • Railway는 정적 파일 공개보다 서비스 프로세스 운영에 가까운 플랫폼이다.
  • GitHub 저장소를 연결하면 특정 브랜치의 새 커밋에 맞춰 autodeploy를 걸 수 있다.
  • 2026-05-18 기준 Railway는 완전한 free forever 플랫폼이라기보다, 30일/USD 5 free trial 후 월 USD 1 free credit 구조를 제공한다.
  • Wait for CI를 켜면 GitHub Actions가 성공한 뒤에만 Railway 배포가 진행되도록 만들 수 있다.

1. 왜 Railway는 앞선 두 플랫폼과 다를까

GitHub Pages는 정적 사이트, Streamlit Community Cloud는 Python 앱 공개에 가깝다. Railway는 그보다 한 단계 더 운영 쪽이다. 웹 서버, API 서버, 워커, 데이터베이스와 함께 돌아가는 서비스를 생각할 때 더 어울린다.

즉, "페이지를 보여 주는 배포"가 아니라 "프로세스를 운영하는 배포"다.

2. 어떤 흐름으로 배포하나

Railway Docs 기준으로 GitHub에 연결된 서비스는 선택된 브랜치에 새 커밋이 푸시될 때 자동 배포를 트리거할 수 있다. 구조를 단순하게 그리면 이렇다.

git push to selected branch
  -> Railway build
  -> Railway deploy
  -> 로그와 상태 확인

이 구조는 백엔드 서비스에 잘 맞는다. 빌드가 성공해야 하고, 런타임이 살아 있어야 하고, 장애가 나면 다시 시작해야 하기 때문이다.

3. "무료 배포"라고 부를 때 주의할 점

Railway는 2026-05-18 기준 공식 문서에서 free trial과 free plan을 분리해 설명한다.

  • 시작 시 30일 동안 쓸 수 있는 USD 5 trial credit
  • trial 종료 후 매달 USD 1 free credit

그래서 Vercel Hobby처럼 "free forever tier"로 단순하게 묶으면 오해가 생긴다. 소규모 실험이나 학습용 배포는 가능하지만, 서비스 성격과 사용량을 반드시 같이 봐야 한다.

즉, Railway는 "무료라서 고른다"보다 백엔드형 구조에 맞기 때문에 고른다가 더 정확하다.

4. Wait for CI가 중요한 이유

Railway 문서에서 특히 실무적인 포인트가 하나 있다. Wait for CI를 켜면 GitHub Actions 워크플로가 성공할 때까지 Railway 배포를 기다릴 수 있다.

이 설정이 중요한 이유는 분명하다.

  • 테스트가 실패했는데도 배포되는 일을 막는다
  • 배포와 검증의 순서를 강제한다
  • 혼자 개발할 때도 최소한의 안전장치를 갖게 한다

즉, "푸시하면 바로 반영"보다 검증 후 반영이 더 좋은 기본값이라는 뜻이다.

5. Railway가 잘 맞는 경우

아래 상황이면 Railway가 유력하다.

  • Node, Python, Go 같은 백엔드 서버를 띄워야 한다
  • 웹훅을 받아야 한다
  • 장시간 프로세스나 워커가 필요하다
  • 환경 변수, 로그, 재배포, 재시작을 한 화면에서 보고 싶다

반대로 문서 사이트나 단순 포트폴리오에는 Railway가 과하다. 이런 경우는 Pages나 Vercel이 더 단순하다.

6. 자주 틀리는 지점

첫째, 정적 사이트와 서비스 호스팅을 같은 문제로 보는 것. Railway는 런타임이 살아 있어야 하는 앱에 더 적합하다.

둘째, 환경 변수 없이 로컬 값에 기대는 것. 서버 환경에서는 거의 바로 드러난다.

셋째, CI 없이 바로 autodeploy를 거는 것. 혼자 할 때는 편해 보여도, 작은 실수가 그대로 production으로 들어간다.

넷째, 무료 크레딧 구조를 충분히 보지 않는 것. "무료"라고만 이해하면 사용량이 늘어날 때 판단을 잘못하기 쉽다.

참고 자료

  • Railway Docs, Controlling GitHub Autodeploys — https://docs.railway.com/deployments/github-autodeploys
  • Railway Docs, Deployments — https://docs.railway.com/deploy/deployments
  • Railway Docs, Free Trial — https://docs.railway.com/pricing/free-trial

이 글은 배포 입문 시리즈의 6/7 편입니다. 다음 편: PR, 테스트, preview, production이 이어지는 자동 배포 파이프라인 구축.

댓글

댓글 쓰기