2026-03-11 · astro / github-actions / deploy

Astro에서 콘텐츠를 빠르게 배포하는 방법

요즘은 글을 쓰는 흐름이 끊기지 않는 게 중요하다고 느낀다.
그래서 /write에서 바로 글을 작성하고, 커밋 후 자동 배포까지 연결했다.

왜 이렇게 구성했나

기존에는 글 작성 후 로컬 빌드와 수동 배포가 필요해서 단계가 많았다.
이번에는 main 브랜치에 콘텐츠가 올라오면 GitHub Actions가 자동으로 빌드와 배포를 수행하도록 정리했다.

현재 배포 흐름

1. /write에서 포스트 작성
2. src/content/posts/*.mdx로 커밋
3. main 푸시 감지
4. Astro 빌드 실행
5. gh-pages 브랜치 자동 반영

얻은 효과

• 작성부터 반영까지 시간이 짧아졌다.
• 배포 누락 가능성이 줄었다.
• 글 발행 프로세스가 단순해졌다.

다음에 개선할 점

코드블록 하이라이트 테마와 포스트 목차(TOC)를 추가해서 읽기 경험을 더 개선할 계획이다.