pile·
인프라 / DevOps·vercel-blogVercel Blog·

Vercel Functions에서 Dockerfile로 컨테이너 배포하기

Vercel Functions가 이제 Dockerfile 또는 Containerfile을 사용해 HTTP 서버를 Fluid compute에 직접 배포할 수 있게 됐다. OCI 호환 이미지라면 언어 제약 없이(Go, Rust, Python 등) 배포 가능하며, 커밋마다 이미지를 자동으로 빌드·VCR 푸시·배포한다.

핵심 포인트
  • Dockerfile.vercel 또는 Containerfile.vercel 파일에 HTTP 서버를 정의하면 Vercel이 자동으로 빌드·Vercel Container Registry 푸시·배포 진행
  • $PORT 환경변수에서 수신하도록 HTTP 서버 설정 필수
  • OCI 호환 이미지라면 언어 무관(Go, Rust, Python 등 모두 지원) — 기존 JavaScript 중심 제약에서 벗어남
  • 기존 Vercel 인프라(preview 배포, structured logging, intelligent routing, auto scaling) 그대로 활용
상세 정리
  • 배경: 기존 Vercel Functions는 JavaScript/TypeScript 중심이었고, 다른 언어 런타임 배포는 별도 설정이 필요했다
  • 지원 형식: Dockerfile 또는 Containerfile(Dockerfile.vercel / Containerfile.vercel 파일명), OCI 호환 이미지 — Docker 표준 그대로 사용
  • 설정 요건: $PORT 환경변수에서 listen하는 HTTP 서버 구성 필수 — 포트를 하드코딩하면 동작하지 않음
  • Go 예시: 멀티스테이지 빌드 — golang:1.24-alpine에서 컴파일 후 alpine:3.20 최소 이미지에 바이너리만 포함해 배포, 이미지 크기 최소화
  • 자동화: 커밋 푸시 시 이미지 자동 빌드 → VCR(Vercel Container Registry) 자동 푸시 → 배포 완료 — 수동 Docker 작업 불필요
  • Fluid compute 통합: Fluid compute 위에서 실행되므로 Active CPU 과금과 autoscaling이 그대로 적용
왜 읽나Go, Rust 등 JavaScript 외 언어로 HTTP 서버를 작성하면서 Vercel의 배포 편의성과 인프라를 그대로 활용하고 싶은 개발자에게 유용하다.
vercel-blog
Vercel Blog 블로그
원문은 여기서 이어서 읽을 수 있어요
원문 읽기
읽음 (0)

이 글과 비슷한

  1. 인프라 / DevOps·vercel-blogVercel Blog·

    Vercel CLI 드라이런 배포로 실제 배포 전 구성 미리 확인하기

    Vercel CLI v54.17.2부터 vercel deploy --dry 명령으로 실제 파일 업로드 없이 배포 구성을 미리 검사할 수 있다. 프레임워크 감지 결과, 포함/제외 파일 목록, 디렉터리 크기 분포, 콘텐츠 해시까지 사전에 확인하고 나서 배포를 결정할 수 있어 의도치 않은 배포 실패를 예방한다.

    #deployment#ci-cd#vercel-cli+1