Vercel은 Serverless 서비스를 제공하는 플랫폼으로, 정적 페이지를 프록시하거나 간단한 API를 만드는 데 특히 적합합니다. 무료 플랜은 개인 프로젝트에 매우 친화적이며, 특히 중국 지역에서 우수한 CDN 지원을 제공합니다. 그러나 GitHub 조직에 호스팅된 프로젝트의 경우 Vercel은 일반적으로 유료 Pro 플랜으로 업그레이드할 것을 요구합니다. 이 글에서는 이러한 제한을 우회하여 Vercel 서비스를 무료로 사용하는 방법을 소개합니다.

배경 소개

Vercel의 Hobby 플랜은 개인 프로젝트에 무료 호스팅 서비스를 제공하여 개발자들에게 큰 인기를 얻고 있습니다. 그러나 프로젝트가 GitHub 조직에 호스팅되어 있으면 Vercel은 기본적으로 유료 업그레이드를 요구합니다. 이는 소규모 팀이나 예산이 제한된 개발자에게 분명 부담을 가중합니다. 따라서 GitHub에 연결되지 않은 Vercel 프로젝트를 생성하여 무료 서비스를 활용할 방법을 찾아야 합니다.

GitHub에 연결되지 않은 Vercel 프로젝트 생성

먼저 Vercel 명령줄 도구를 통해 GitHub와 독립적인 프로젝트를 생성해야 합니다.

Vercel CLI 설치

터미널에서 다음 명령을 실행하여 Vercel CLI를 전역으로 설치합니다.

npm install -g vercel

Vercel 프로젝트 생성

프로젝트 디렉터리로 이동한 다음 다음 명령을 실행합니다.

vercel login
vercel

이 과정에서 대화형 터미널 인터페이스가 표시됩니다. 안내에 따라 단계별로 진행하면 Vercel에서 어떤 GitHub 프로젝트에도 연결되지 않은 서비스를 생성할 수 있습니다. 배포에 성공하면 Vercel 웹 인터페이스를 통해 배포된 서비스에 액세스할 수 있습니다. 이제 작업의 절반을 완료한 것입니다.

자동 배포 설정

다음으로 코드를 커밋할 때마다 Vercel에 자동으로 배포되도록 설정해야 합니다. 이 기능은 GitHub Actions를 활용하여 구현합니다.

GitHub Actions 구성

GitHub 저장소에 CI 구성 파일을 생성하고 빌드 작업 후 다음 단계를 추가합니다.

- name: Deploy to Vercel
  uses: amondnet/vercel-action@master
  env:
    VERSION: ${{ env.GITHUB_SHA }}
  with:
    vercel-token: ${{ secrets.VERCEL_TOKEN }}
    vercel-org-id: ${{ secrets.ORG_ID }}
    vercel-project-id: ${{ secrets.PROJECT_ID }}
    working-directory: ./
    vercel-args: '--prod' # 可选参数

GitHub Secrets 준비

위 GitHub Action을 사용하기 전에 GitHub Secrets에 다음 매개변수를 설정해야 합니다.

• VERCEL_TOKEN: Vercel 계정 페이지에서 생성합니다.
• ORG_ID 및 PROJECT_ID: 프로젝트 루트 디렉터리의 .vercel/project.json 파일에서 찾을 수 있습니다.

위 단계를 통해 팀 프로젝트의 자동화된 배포를 구현하고 Vercel 서비스를 완전히 무료로 이용할 수 있습니다.

요약

Vercel CLI와 GitHub Actions를巧妙하게 사용하면 GitHub 조직 프로젝트에 대한 Vercel의 유료 제한을 우회할 수 있습니다. 이 방법은 비용을 절감할 뿐만 아니라 프로젝트의 자동 배포 효율도 향상하므로 소규모 팀이나 개인 개발자에게 매우 적합합니다. 이 글이 도움이 되어 팀 프로젝트를 예산을 늘리지 않고 빠르게 출시할 수 있기를 바랍니다!