웹 운영
작은 팀을 위한 정적 사이트 배포 확인 체크리스트
정적 사이트 배포 후 공개 URL, 내부 링크, 메타 정보, 스크린샷을 확인하고 완료 보고 전에 점검할 실무 체크리스트입니다.
검색 의도: 빌드는 통과했지만 공개 사이트 확인은 따로 필요하다
정적 사이트 배포는 터미널에서 끝난 것처럼 보여도 공개 페이지 기준의 확인이 필요합니다. 빌드가 통과하고, 커밋이 올라가고, CI 작업이 초록색이어도 방문자가 보는 것은 최종 URL, 브라우저 탭의 제목, 첫 화면, 링크, 이미지, 폼입니다. 배포 완료 판단은 이 보이는 결과를 기준으로 해야 합니다.
작은 팀에서는 짧은 배포 확인 체크리스트가 가장 실용적입니다. 배포 후 회사 페이지 https://sambro.space/, 브라우저 도구 목록 https://tools.sambro.space/ko/tools, 블로그 인덱스 https://blog.sambro.space/ko/ 를 열어 봅니다. 그리고 이번에 바꾼 페이지가 실제로 접근 가능하고, 읽히고, 다른 사이트 영역과 연결되어 있는지 확인합니다.
변경된 정확한 URL부터 확인하기
홈페이지를 바꾼 것이 아니라면 홈페이지 확인만으로는 부족합니다. 새로 추가하거나 수정한 정확한 경로를 열어야 하고, 다국어 사이트라면 언어 경로까지 포함해 봐야 합니다. 블로그 글, 도구 페이지, 게임 페이지, 회사 문의 페이지는 같은 배포 파이프라인을 타더라도 서로 다른 방식으로 실패할 수 있습니다. 메타 정보가 빠질 수도 있고, 내부 링크가 깨질 수도 있고, 이미지가 오래된 파일을 가리킬 수도 있고, 라우트가 생성되지 않았을 수도 있습니다.
확인한 최종 공개 URL은 릴리스 노트나 티켓에 그대로 남깁니다. URL에 쿼리 문자열, 한글, 리다이렉트 값이 있다면 공유 전에 구조를 확인해야 합니다. https://tools.sambro.space/ko/tools 의 URL 인코딩 변환기를 쓰면 경로, 쿼리 값, 인코딩된 문자를 분리해서 볼 수 있어 깨지기 쉬운 링크를 그대로 전파하는 일을 줄일 수 있습니다.
검색엔진과 사용자가 함께 보는 요소 확인하기
배포 확인에는 화면에 보이는 본문과 검색 결과에 쓰일 수 있는 메타 정보가 함께 들어가야 합니다. H1, title, meta description, 가능한 경우 canonical URL, 다국어 링크를 봅니다. 블로그 글이라면 설명 문구가 실제 체크리스트나 가이드 내용과 맞는지 확인하고, 다른 글의 기본 설명이 복사된 상태로 남아 있지 않은지 봐야 합니다.
그다음 첫 화면을 사용자처럼 훑어봅니다. CTA는 실제로 도움이 되는 곳으로 이어져야 하고, 내부 링크는 가능하면 현재 언어와 맞아야 하며, 비공개 미리보기 URL에 기대고 있으면 안 됩니다. Markdown 형식의 릴리스 노트나 도움말을 공개 글로 옮기는 작업이라면 https://tools.sambro.space/ko/tools/markdown-preview 에서 렌더링을 먼저 확인하는 편이 안전합니다.
전체 사이트를 과하게 테스트하지 않고 링크와 이미지를 확인하기
작은 변경마다 모든 라우트를 수동 점검할 필요는 없습니다. 대신 이번 변경이 건드린 경로는 확인해야 합니다. 주요 CTA 하나, 관련 내부 링크 하나, 새 콘텐츠에서 언급한 도구나 회사 링크를 눌러 봅니다. 이미지 변경이 있다면 공개 페이지에서 파일이 로드되는지, 좁은 화면에서 의도한 크기로 보이는지 확인합니다.
릴리스 보고에 스크린샷을 붙여야 한다면 브라우저의 개인 정보 영역을 잘라내고 파일 크기를 줄입니다. https://tools.sambro.space/ko/tools/image-compressor 의 이미지 압축 도구는 티켓이나 채팅에 올릴 스크린샷을 가볍게 만드는 데 유용합니다. 너무 큰 전체 화면 캡처보다 작고 명확한 스크린샷이 보통 더 도움이 됩니다.
짧은 배포 보고 패턴
실무 배포 보고는 짧아도 됩니다. 수정 파일, 확인한 공개 페이지, 빌드 결과, CI 실행 상태, 알려진 제한 사항을 적으면 충분합니다. 작업이 아직 queued 또는 in_progress라면 통과할 것이라고 추측하지 말고 run id와 현재 상태를 적습니다. 로컬에 기존 dirty 파일이 있었지만 이번 릴리스에 포함하지 않았다면 그 사실도 남겨야 다음 운영자가 저장소 상태를 오해하지 않습니다.
Sambro 운영에서는 회사 맥락은 https://sambro.space/, 도구는 https://tools.sambro.space/ko/tools, 블로그 콘텐츠는 https://blog.sambro.space/ko/ 를 기준으로 정리합니다. 기준은 단순합니다. 빌드 통과, 정확한 공개 경로 확인, 내부 링크 점검, 메타 정보 일치, 그리고 다음 사람이 회의 없이 이해할 수 있는 배포 근거를 남기는 것입니다.