GitHub 푸시마다 README의 “Last Updated” 날짜 자동 업데이트

Source: Dev.to

GitHub 푸시 시 “Last Updated” 날짜 자동 업데이트

이 가이드는 GitHub Actions를 사용해 코드를 GitHub에 푸시할 때마다 README.md에 있는 Last updated 날짜를 자동으로 업데이트하는 방법을 보여줍니다.

왜 필요한가?

GitHub은 푸시 시 파일 내용을 자동으로 수정하지 않습니다.
다음과 같은 줄을 최신 상태로 유지하려면:

_Last updated: 2026-01-14_

자동화가 필요합니다.

최종 결과

설정 후:

• 모든 푸시마다 GitHub Action이 실행됩니다.
• README 날짜가 자동으로 업데이트됩니다.
• github-actions 계정으로 커밋이 생성됩니다.
• 수동 편집이 필요하지 않습니다.

Step 1️⃣ README에 플레이스홀더 추가

레포지토리 루트에 있는 README.md에 다음을 추가합니다:

_Last updated: AUTO_

⚠️ 이 줄은 정확히 (대소문자 구분) 일치해야 합니다.

Step 2️⃣ GitHub Actions 폴더 만들기

레포지토리에 다음 구조를 만듭니다:

.github/
└── workflows/

Step 3️⃣ 워크플로 파일 만들기

다음 파일을 생성합니다:

.github/workflows/update-date.yml

아래 내용을 붙여넣으세요:

name: Update README date

on:
  push:
    branches:
      - main
      - master

jobs:
  update-date:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repo
        uses: actions/checkout@v4
        with:
          persist-credentials: true

      - name: Update date
        run: |
          DATE=$(date +"%Y-%m-%d")
          sed -i "s/_Last updated:.*_/_Last updated: ${DATE}_/" README.md

      - name: Commit and push
        run: |
          git config user.name "github-actions"
          git config user.email "github-actions@github.com"
          git add README.md
          git commit -m "chore: auto update last updated date" || echo "No changes"
          git push

Step 4️⃣ 워크플로 권한 활성화 (매우 중요)

1. Repo → Settings → Actions → General 로 이동합니다.
2. Workflow permissions 아래에서 Read and write permissions 를 선택합니다.
3. Save 를 클릭합니다.

이 설정이 없으면 워크플로가 조용히 실패합니다.

Step 5️⃣ 워크플로 트리거하기

워크플로는 새 푸시 시에만 실행됩니다. 작은 변경을 하고 푸시하세요:

git add README.md
git commit -m "trigger workflow"
git push

Step 6️⃣ 확인하기

• 레포지토리의 Actions 탭을 엽니다.
• 최신 워크플로 실행을 열어 모든 단계가 초록색인지 확인합니다.
• README.md를 확인하면 다음과 같은 내용이 보일 것입니다:

_Last updated: 2026-01-14_

TL;DR

• GitHub은 파일을 자동으로 업데이트하지 않습니다.
• GitHub Actions가 이를 할 수 있습니다.
• 작은 워크플로 하나로 README 날짜를 정확하게 유지합니다.
• 설정 후 수동 작업이 전혀 필요 없습니다.