2편. Netlify 사이트 이전 전 체크리스트: 도메인·GitHub·DNS 점검
이 글의 목차
- 이전 전에 준비하면 실패가 줄어드는 이유
- 사이트 정보 백업하기
- 커스텀 도메인과 DNS 점검
- GitHub 저장소 연동 점검
- 이전 당일 작업 순서
- 한 줄 요약
1. 이전 전에 준비하면 실패가 줄어드는 이유
Netlify 사이트 이전은 버튼 한 번으로 끝나는 경우가 많지만, 도메인과 저장소 연동이 얽혀 있으면 의외의 지점에서 멈춥니다. 반대로 사전 점검만 해 두면 대부분의 문제를 피할 수 있습니다. 이 글은 실제 이전 전에 확인할 항목을 순서대로 정리한 체크리스트입니다.
2. 사이트 정보 백업하기
이전 자체가 데이터를 지우는 작업은 아니지만, 만약을 대비해 아래 항목은 따로 기록해 두세요.
- 사이트 이름과 기본 주소(예: 사이트명.netlify.app)
- 환경 변수(Environment variables) 목록과 값
- 연결된 GitHub 저장소와 배포 브랜치
- 빌드 명령어, 게시 디렉터리(publish directory), Functions 폴더 경로
- 커스텀 도메인과 DNS 레코드 전체
💡 팁
빌드 설정은 저장소의 netlify.toml 파일에 코드로 남겨 두면 어느 팀으로 옮겨도 설정이 따라갑니다.
3. 커스텀 도메인과 DNS 점검
도메인은 한 번에 하나의 사이트에만 연결할 수 있습니다. 그래서 새 사이트를 만들어 옮기는 방식이라면 기존 사이트에서 도메인을 먼저 제거해야 합니다. 반면 공식 Transfer 기능을 쓰면 같은 사이트가 소속 팀만 바꾸므로 도메인 충돌이 생기지 않는 것이 일반적입니다.
단, Netlify DNS를 쓰고 있다면 확인할 것이 하나 더 있습니다. 도메인의 DNS 영역(DNS zone)도 팀 소속이기 때문에, 사이트를 다른 팀으로 옮겼다면 DNS zone도 같은 팀으로 옮겨야 한다는 안내가 커뮤니티에 있습니다. 외부 DNS(가비아, Cloudflare 등)를 쓴다면 레코드를 바꿀 필요가 없는 경우가 대부분입니다.
⚠️ 주의
A 레코드로 Netlify에 직접 연결한 경우에도, 이전 후 HTTPS 인증서와 도메인 상태를 반드시 다시 확인하세요.
4. GitHub 저장소 연동 점검
대부분의 사이트는 GitHub와 연결되어 푸시할 때마다 자동 배포됩니다. 이전 후에는 Netlify GitHub 앱의 접근 권한이 새 팀에서도 유효한지 확인해야 합니다. 저장소를 바꾸고 싶다면 사이트의 Build & deploy 설정에서 저장소 연결을 다른 저장소로 변경할 수 있습니다.
주의할 예외도 있습니다. GitHub Enterprise 서버나 GitLab 자체 호스팅 저장소는 팀 단위 연결을 쓰기 때문에 셀프 이전이 안 되고 지원팀 도움이 필요합니다. 오래된 Global 사이트 플랜도 마찬가지입니다.
5. 이전 당일 작업 순서
- 대상 팀 준비와 권한 확인
- 위 백업 목록 저장
- 배포 중인 작업이 없는지 확인(진행 중이면 완료 대기)
- Transfer 실행
- 도메인, DNS, HTTPS, 환경 변수 확인
- 수동 배포 1회로 최종 검증
✅ 체크 포인트
이전 당일에는 새 코드 푸시를 잠시 멈추면 원인 파악이 훨씬 쉽습니다.
6. 한 줄 요약
백업 → 권한 → 도메인·DNS → GitHub 연동 순서로 점검하면 Netlify 사이트 이전은 안전하게 끝납니다.
🔑 핵심 키워드
Netlify 도메인 이전 · Netlify DNS zone · GitHub 연동 · 환경 변수 · 사이트 이전 체크리스트
