문제
AI에게 “배포해”라고만 말하면 애매합니다.
AI가 임시 주소만 확인하고, 정작 사람들이 들어갈 실제 주소는 확인하지 않을 수 있습니다.
예를 들어 아래 두 주소는 비슷해 보이지만 서로 다르게 설정됩니다.
https://www.systemlab.co.krhttps://systemlab.co.kr
하나는 열리고 다른 하나는 안 열릴 수 있습니다.
그래서 배포는 “업로드했다”가 아니라 “실제 주소에서 열리는지 확인했다”까지 해야 끝입니다.
먼저 알 것
Astro 사이트는 글을 HTML 파일에 직접 쓰는 방식이 아닙니다.
- 글 원본은
src/content/.../*.md파일입니다. - 화면 모양은
src/pages/.../*.astro파일이 만듭니다. dist폴더는 빌드하면 자동으로 생기는 결과물입니다.
Astro가 뭔가요?
Astro는 웹사이트를 만드는 도구입니다.
블로그나 문서 사이트처럼 글이 많은 사이트를 만들 때 자주 씁니다.
초보자 기준으로 보면 이렇게 이해하면 됩니다.
.md파일은 글 원고입니다..astro파일은 글을 어떻게 보여줄지 정하는 틀입니다.npm run build는 원고와 틀을 합쳐서 실제 웹페이지를 만드는 명령입니다.dist폴더는 그 결과로 나온 완성본입니다.
비유하면 이렇습니다.
Markdown 글 = 원고
Astro 파일 = 편집 디자인
npm run build = 인쇄
dist 폴더 = 인쇄된 책
배포 = 책을 서점에 올리는 일그래서 글을 고칠 때는 인쇄된 책을 칼로 오려 붙이는 게 아니라, 원고를 고친 뒤 다시 인쇄해야 합니다.
Astro 사이트에서 dist 안의 HTML을 직접 고치면 당장은 바뀐 것처럼 보여도, 다음 빌드 때 사라질 수 있습니다.
따라서 AI에게 맡길 때는 이렇게 말해야 합니다.
Astro 원본만 수정해.
dist 폴더 안의 HTML은 직접 고치지 마.요청 예시
AI에게는 이렇게 요청하면 됩니다.
Astro 원본만 수정해.
dist 직접 수정 금지.
1. 글을 src/content에 저장해.
2. npm run build를 실행해.
3. Cloudflare Pages에 배포해.
4. 아래 주소가 열리는지 확인해.
- https://www.systemlab.co.kr/
- https://www.systemlab.co.kr/systems/
- 새 글 주소
루트 주소도 확인해.
- https://systemlab.co.kr/
안 열리는 주소가 있으면 배포 문제인지 DNS 문제인지 나눠서 말해.주소 확인법
배포 후에는 주소를 세 종류로 나눠 봅니다.
1. 임시 배포 주소
예:
https://72fb1a59.system-lab-site.pages.dev/이 주소가 안 열리면 배포 자체가 실패한 것입니다.
2. www 주소
예:
https://www.systemlab.co.kr/사람들에게 보통 공유할 주소입니다.
이 주소가 열리면 사이트는 기본적으로 올라간 것입니다.
3. 루트 주소
예:
https://systemlab.co.kr/www 없는 주소입니다.
이 주소만 안 열리면 배포 문제가 아니라 DNS 설정 문제일 가능성이 큽니다.
DNS가 뭔가요?
DNS는 주소 안내판입니다.
브라우저가 systemlab.co.kr에 들어갔을 때 어느 서버로 가야 하는지 알려줍니다.
Cloudflare Pages에서는 이런 식으로 연결해야 합니다.
www.systemlab.co.kr -> system-lab-site.pages.dev
systemlab.co.kr -> system-lab-site.pages.dev둘 중 하나만 연결하면 하나만 열립니다.
AI가 보고해야 할 것
좋은 배포 보고는 이렇게 생겼습니다.
소스 수정 완료.
Astro build 통과.
Cloudflare Pages 배포 완료.
검증:
- 임시 배포 주소: 열림
- www 주소: 열림
- 새 글 주소: 열림
- 루트 주소: DNS 문제로 안 열림
남은 작업:
Cloudflare DNS에서 루트 주소를 Pages에 연결해야 함.핵심은 간단합니다.
배포는 “올렸다”가 아니라 “사용자가 들어갈 주소에서 열리는지 확인했다”까지가 완료입니다.