이미지를 repo에 같이 두는 방식
초기에는 파일 기반으로 충분합니다. R2나 Images는 업로드 기능이 필요할 때 붙입니다.
파일을 같이 두는 이유
초기 블로그에서는 글과 이미지를 같은 저장소에 두면 경로와 변경 이력을 함께 확인할 수 있습니다. 별도 업로드 화면이나 데이터베이스도 필요하지 않습니다.
이미지는 assets 아래에 두고 Markdown front matter에서 로컬 경로와 크기를 지정합니다.
별도 저장소가 필요한 때
이미지가 많아져 저장소 크기가 부담되거나 작성자가 브라우저에서 직접 업로드해야 할 때 R2 또는 Cloudflare Images를 검토합니다.
그 전에는 새로운 운영 계층을 추가하지 않는 편이 배포와 복구를 단순하게 유지합니다.
작성 흐름
- 이미지를
assets에 추가합니다. - Markdown 파일의 hero 필드에 경로와 크기를 기록합니다.
pnpm test로 파일과 출력 구조를 검증합니다.- Cloudflare Pages가 생성된
dist를 배포합니다.