깃허브 액션으로 커밋 로그를 블로그에 띄우기: Nuxt와 Vercel 활용법

깃허브 액션을 통해 커밋 데이터를 자동으로 수집하고, Nuxt와 Vercel로 UI에 노출하는 방법을 소개합니다.

소개: 커밋 로그를 UI에 표시하는 이유

깃허브 커밋 히스토리는 프로젝트 진행 상황을 보여주고, 작업 흐름을 공유하는 중요한 자료입니다. 블로그에 커밋 로그를 자동으로 표시하고 싶어 깃허브 액션과 Nuxt, Vercel을 활용해 구현했습니다.

1단계: 깃허브 액션으로 커밋 데이터 수집

깃허브 액션을 사용해 매일 자정(UTC 00:00)에 최신 20개 커밋을 JSON 파일로 저장하고 자동으로 푸시합니다.

.github/workflows/update-commits.yml

name: Update Commits Log
on:
  schedule:
    - cron: "0 0 * * *"
  workflow_dispatch:
permissions:
  contents: write
jobs:
  update-commits:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: |
          curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
            "https://api.github.com/repos/${{ github.repository }}/commits?per_page=20" | \
          jq '[.[] | {message: .commit.message, date: .commit.author.date, sha: .sha, url: .html_url}]' > public/commits.json
      - run: |
          git config --global user.name "GitHub Action"
          git config --global user.email "action@github.com"
          git diff --quiet || (git add public/commits.json && git commit -m "Update commits log [skip ci]" && git push)

업데이트 (2026.10.16): 두 가지 시행착오를 더 적어 둔다.

  • permissions: contents: write가 없으면 마지막 git push가 권한 오류로 실패한다. 워크플로가 쓰는 GITHUB_TOKEN은 기본으로 읽기 권한만 있을 수 있어서, 저장소에 쓰려면 이 줄로 쓰기 권한을 따로 줘야 한다.
  • 처음에는 내 모든 저장소의 커밋을 모았다(/users/{사용자}/repos로 저장소 목록을 받고 하나씩 조회). 이 블로그와 상관없는 커밋까지 섞여서, 지금처럼 이 저장소(github.repository)의 커밋만 가져오게 바꿨다.

2단계: Nuxt로 UI 표시

정적 파일 방식

  • public/commits.json을 Nuxt에서 직접 불러옵니다.
  • server/api/commits.js를 사용한 API 방식은 Vercel 배포 시 ENOENT 오류 발생으로 제거했습니다.
    • 에러 내용은 ENOENT: no such file or directory, open '/var/task/public/commits.json'였습니다. Vercel은 public/ 폴더의 파일을 CDN에서 정적 파일로 내보내고, 서버 함수(/var/task) 안에는 넣지 않습니다. 그래서 서버 코드가 public/commits.json을 파일로 읽으려 하면 파일이 없다는 에러가 납니다.
    • vercel.json에 /api/commits 경로 재작성(rewrite)을 넣어 보기도 했지만 해결되지 않았고, 나중에 API 파일과 함께 지웠습니다. 브라우저에서 /commits.json을 그냥 요청하면 CDN이 바로 내주니, API가 필요 없었습니다.
  • useAsyncData를 활용해 프론트엔드에서 데이터를 가져옵니다.
<script setup>
const { data: commits } = useAsyncData("commits", () =>
  $fetch("/commits.json")
);
</script>

<template>
  <ul>
    <li v-for="commit in commits" :key="commit.sha">
      <a :href="commit.url" target="_blank">{{ commit.message }}</a> -
      {{ commit.date }}
    </li>
  </ul>
</template>

3단계: 캐싱 문제 해결

업데이트 (2026.10.16): 처음에 적은 해결법은 틀렸다. 처음에는 아래처럼 key에 Math.random()을 넣어 "매번 새 데이터를 가져오게" 했다. 실제 코드도 한동안 비슷하게(Date.now()) 되어 있다가 2026년 9월에 버그로 확인돼 고쳤다.

// ❌ 이렇게 하면 안 된다
const { data: commits } = useAsyncData(`commits-${Math.random()}`, async () => {
  const response = await fetch("/commits.json");
  return response.json();
});
문제이유
서버가 가져온 데이터를 버린다서버 렌더링 때 만든 key와 브라우저에서 만든 key가 서로 다르다. 브라우저는 서버가 넘겨준 데이터를 key로 찾는데, 못 찾으니 같은 요청을 한 번 더 보낸다
화면이 깜빡이거나 어긋날 수 있다서버 HTML에는 데이터가 있는데 브라우저는 처음에 빈 값으로 시작한다
캐시가 의미 없어진다key가 매번 달라 캐시를 한 번도 쓰지 않는다

"새로고침해도 갱신되지 않는" 문제의 진짜 원인은 캐시가 아니었다. commits.json은 배포할 때의 파일이라, 다음 배포 전까지는 원래 바뀌지 않는다. 깃허브 액션이 하루에 한 번 커밋하면 Vercel이 다시 배포하고, 그때 새 파일이 나간다.

그래서 key는 고정된 이름을 쓰는 게 맞다. 지금 코드는 이렇다.

// ✅ 지금 코드 (pages/log/index.vue)
const { data: commits } = useAsyncData("commits-log", () => $fetch("/commits.json"), {
  default: () => [],  // 불러오기 전에는 빈 목록
  lazy: true,         // 데이터를 기다리느라 페이지 이동을 막지 않는다
});

key는 "이 데이터가 무엇인지"를 나타내는 이름이어야 한다. 경로마다 다른 데이터라면 blog-post-${route.path}처럼 경로를 넣고, 페이지 하나에 데이터 하나라면 고정 이름이면 된다. 시간이나 난수를 넣으면 안 된다. key에 대한 더 자세한 내용은 useAsyncData 캐싱 문제와 Key 동적 설정 글에 있다.

결론

깃허브 액션으로 자동화된 커밋 데이터 수집, Nuxt로 UI 구성, Vercel로 배포하는 과정을 정리했습니다. 초기 API 방식의 문제를 정적 파일 방식으로 해결하고, 캐싱 문제도 보완했습니다. 이를 통해 깃허브 커밋 로그를 블로그에 자동으로 표시할 수 있습니다. 단, 실시간은 아닙니다. 하루에 한 번 갱신되고, 봇이 푸시한 뒤 Vercel이 다시 배포해야 화면에 반영됩니다.