피드로 돌아가기
Dev.toDevOps
원문 읽기
GitHub Actions 기반 Medium 콘텐츠의 Static Site 자동 동기화 파이프라인 구축
Sync Your Medium Portfolio to a Static Site Automatically
AI 요약
Context
Medium의 높은 도달률과 개인 도메인의 내러티브 제어 권한 사이의 괴리로 인한 포트폴리오 불일치 발생. 수동 업데이트로 인한 관리 공수 증가 및 최신성 유지의 어려움을 해결하기 위해 자동화된 동기화 메커니즘 필요.
Technical Solution
- Medium을 Upstream Feed로 정의하고 정적 사이트 생성기를 Downstream으로 배치한 데이터 흐름 설계
- Handle을 Stable User ID로 변환 후 Article List를 조회하는 2단계 API 호출 구조 채택
- Article ID 기반의 파일 생성 및 파일 존재 여부 확인(fs.access)을 통한 Idempotency 보장
- Front Matter에 Medium ID와 Canonical URL을 포함하여 SEO 최적화 및 데이터 무결성 유지
- GitHub Actions의 Cron Schedule(Daily 06:00)을 통한 무인 자동 업데이트 파이프라인 구현
- Git-auto-commit-action을 활용한 데이터 변경 사항의 자동 커밋 및 CI/CD 트리거 연동
실천 포인트
1. API 호출 시 ID 기반의 파일 시스템 체크를 통해 중복 요청을 방지하는 Idempotency 로직 적용 여부 확인
2. Search Engine Optimization을 위해 Medium과 개인 사이트 중 단일 Canonical URL 설정 전략 수립
3. 외부 API 의존성을 가진 동기화 작업 시 GitHub Actions Secrets를 통한 API Key 보안 관리 적용
4. 정적 사이트 생성기(Hugo, Astro 등)의 파일 구조에 맞춘 Markdown Front Matter 스키마 정의