6강. 배포 후 운영 - 글 추가, 검색 상태 점검, 업데이트 습관

배포가 끝난 Astro 사이트를 꾸준히 운영하는 방법을 다룹니다. 새 글 추가와 재배포, 서치 콘솔·서치어드바이저로 색인 상태 확인, 방문자 분석 도구 연결, 링크·속도 점검, Astro 버전 업데이트와 백업까지 운영 루틴을 정리합니다.

·

Astro 강의 6강 - 배포 후 운영

5강까지 따라 하셨다면 사이트가 인터넷에 올라가 있고 검색엔진에도 등록되어 있을 것입니다. 하지만 사이트는 올리는 순간이 끝이 아니라 시작입니다. 이번 강의에서는 배포 후에 무엇을, 얼마나 자주 해야 하는지 운영 루틴을 정리합니다.

1. 새 글 추가하고 재배포하기

운영에서 가장 자주 하는 일은 글을 추가하는 것입니다. 4강에서 만든 콘텐츠 컬렉션 덕분에 과정은 단순합니다.

  1. src/content/blog/ 에 새 마크다운 파일을 만듭니다.
  2. npm run dev 로 로컬에서 확인합니다.
  3. Git 에 커밋하고 push 합니다.
git add .
git commit -m "글 추가: 새 글 제목"
git push

Vercel·Netlify·Cloudflare Pages 에 GitHub 저장소를 연결해 두었다면 push 만으로 자동 재배포되고, 1~2분 뒤 사이트에 반영됩니다. 사이트맵, RSS, llms.txt 도 빌드할 때 함께 다시 만들어지므로 따로 손댈 것이 없습니다.

기존 글을 고쳤을 때

내용을 수정했다면 frontmatter 에 updatedDate 를 적어 주세요.

---
title: '...'
pubDate: 2026-09-01
updatedDate: 2026-10-15
---

이 값이 사이트맵의 lastmod 와 구조화 데이터의 dateModified 에 들어가, 검색엔진이 “이 글이 갱신됐다”는 것을 알고 다시 크롤링합니다. 오타 한두 글자 고친 정도라면 굳이 바꾸지 않아도 됩니다.

아직 공개하고 싶지 않은 글

draft: true 를 넣으면 로컬 개발 서버에서는 보이지만 빌드에서는 제외됩니다. 며칠에 걸쳐 쓰는 긴 글에 유용합니다.

2. 색인 상태 확인하기

등록만 하고 방치하면 문제가 생겨도 모릅니다. 한 달에 한 번 정도 두 곳을 확인하세요.

구글 서치 콘솔

메뉴 확인할 것
색인 생성 → 페이지 “색인이 생성되지 않음” 페이지가 있는지. 태그 페이지처럼 일부러 noindex 한 것은 정상
실적 어떤 검색어로 들어오는지, 노출은 되는데 클릭이 적은 글은 제목·설명을 다듬을 후보
URL 검사 새 글이 색인되지 않았으면 주소를 넣고 “색인 생성 요청”

새 글을 올린 직후에는 URL 검사에서 색인 요청을 한 번 눌러 두면 며칠 빨라집니다.

네이버 서치어드바이저

“리포트 → 사이트 진단” 에서 오류를 확인하고, “요청 → 웹 페이지 수집” 으로 새 글 주소를 직접 제출할 수 있습니다. 네이버는 구글보다 신규 사이트 반영이 느린 편이니 조급해하지 않아도 됩니다.

3. 방문자 분석 도구 연결하기

누가 어떤 글을 보는지 알아야 다음 글의 방향을 정할 수 있습니다. 가벼운 순서로 두 가지를 권합니다.

Cloudflare Web Analytics 는 무료이고 쿠키를 쓰지 않아 동의 배너가 필요 없습니다. Cloudflare 에서 사이트를 추가하면 주는 <script> 한 줄을 레이아웃의 <head> 에 넣으면 끝입니다.

Google Analytics 4 는 더 상세하지만 설정이 무겁습니다. 처음에는 Cloudflare 로 시작하고, 유입이 늘어 세부 분석이 필요해지면 GA4 를 추가하는 것을 권합니다.

어느 쪽이든 스크립트는 src/layouts/BaseLayout.astro 의 <head> 에 넣으면 모든 페이지에 적용됩니다. 로컬 개발 중에는 집계되지 않도록 import.meta.env.PROD 로 감싸 두면 좋습니다.

{import.meta.env.PROD && (
  <script defer src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "여기에-토큰"}'></script>
)}

4. 깨진 링크와 속도 점검

글이 쌓이면 옛 글의 링크가 깨지거나 외부 사이트가 사라지는 일이 생깁니다. 분기에 한 번 정도 점검합니다.

빌드된 사이트의 링크를 한 번에 검사하려면 링크 검사 도구를 씁니다.

npm run build
npx linkinator ./dist --recurse

깨진 주소가 목록으로 나옵니다. 내부 링크가 깨졌다면 글을 고치고, 옛 주소로 들어오는 방문자가 있다면 호스팅 서비스의 리다이렉트 설정(Vercel 은 vercel.json, Netlify 는 _redirects 파일)으로 새 주소로 보내 줍니다.

속도는 pagespeed.web.dev 에서 확인합니다. Astro 는 기본이 빠르지만, 본문에 큰 이미지를 그대로 넣으면 점수가 떨어집니다. 이미지는 src/content/blog/images/ 에 넣고 상대경로로 불러와야 자동 최적화됩니다.

5. Astro 와 패키지 업데이트

Astro 는 업데이트가 잦습니다. 보안 수정이 포함되기도 하므로 두세 달에 한 번은 올려 주세요.

# 현재 버전과 최신 버전 비교
npm outdated

# Astro 와 공식 통합을 한 번에 업데이트
npx @astrojs/upgrade

업데이트 후에는 반드시 npm run build 로 빌드가 통과하는지, npm run dev 로 화면이 깨지지 않는지 확인한 뒤 push 하세요. 메이저 버전(예: 7 → 8)이 바뀔 때는 공식 업그레이드 가이드를 먼저 읽는 것이 안전합니다.

6. 백업과 복구

GitHub 에 올려 두었다면 소스 코드는 이미 백업된 것입니다. 글도 마크다운 파일이므로 저장소 안에 함께 있습니다. 컴퓨터가 고장 나도 아래 두 줄이면 복구됩니다.

git clone https://github.com/내계정/내저장소.git
npm install

주의할 것은 site.config.ts 의 카카오 키나 분석 도구 토큰처럼 공개 저장소에 올리면 안 되는 값입니다. 이런 값은 .env 파일에 넣고 import.meta.env.PUBLIC_... 으로 읽으면 저장소에는 남지 않습니다. 호스팅 서비스의 환경 변수 설정에 같은 값을 등록해 두면 빌드 때 주입됩니다.

7. 운영 루틴 한눈에 보기

주기 할 일
글 올릴 때마다 로컬 확인 → push → 서치 콘솔 URL 검사에서 색인 요청
매달 서치 콘솔·서치어드바이저 오류 확인, 실적 리포트로 인기 글·검색어 확인
분기마다 깨진 링크 검사, PageSpeed 점검, 오래된 글 내용 갱신(updatedDate)
두세 달마다 npx @astrojs/upgrade 로 업데이트 후 빌드 확인

강의를 마치며

6개 강의를 통해 Astro 설치부터 페이지 작성, 컴포넌트와 레이아웃, 마크다운 블로그, SEO 와 배포, 그리고 운영까지 사이트 하나를 만들고 키워 가는 전 과정을 다뤘습니다.

검색 노출은 기술 설정보다 꾸준히 쌓이는 글이 결정합니다. 완벽한 글 하나보다 조금 부족해도 꾸준히 올리는 글 열 개가 더 많은 방문자를 데려옵니다. 이제 여러분만의 주제로 사이트를 만들고, 오늘 배운 루틴으로 키워 보세요. 막히는 부분이 있다면 FAQ 를 확인해 보세요.