Build-time 컴파일 방식 전환을 통한 Zero-build Privacy Policy 구현

Zero-build privacy policies with Astro

2026년 4월 10일3분intermediate

AI 요약

Context

기존 Astro Integration 기반의 Markdown 생성 방식은 빌드 타임에 중간 파일을 생성하는 Side-effect 구조를 가짐. 이로 인해 불필요한 .gitignore 관리와 File-watching 단계가 추가되어 개발 경험의 마찰이 발생함.

Technical Solution

Build-time 파일 생성 방식에서 Frontmatter 내 Inline Compilation 구조로 전환
@openpolicy/core 및 renderers 라이브러리를 통한 Config의 직접적인 HTML 변환 프로세스 구축
expandOpenPolicyConfig 함수를 이용해 단일 Unified Config를 개별 정책 단위로 분리하는 로직 적용
Astro의 set:html 지시어를 활용하여 컴파일된 정적 HTML을 클라이언트 JS 없이 즉시 렌더링
Plugin 의존성을 제거하고 SDK 기반의 Deterministic한 설정 관리 체계 도입

실천 포인트

- 중간 파일 생성으로 인한 Git 관리 복잡성 발생 시 Inline Compilation 검토 - 정적 페이지 생성 시 Client-side JS 배제 가능 여부를 판단하여 Zero-JS 아키텍처 설계 - 설정 데이터의 결정론적(Deterministic) 특성을 활용한 AI 기반 Config 생성 자동화 파이프라인 구축

태그

#Static Site Generation #Astro #Build-time Compilation #Zero-JS #Developer Experience

원문 읽기