먼저 볼 카드 — 커밋·푸시·머지를 그림으로 이해하기
개념 Deploy
저장과 배포는 다른 일
이 카드를 다루는 수업 좋은 프롬프트로 이미지와 영상 만들기 파리 거리에서 자전거 타기
- 코드를 GitHub에 올려도 사이트는 그대로일 수 있습니다. 올리기와 띄우기는 다른 단계입니다
- GitHub이 하는 일 — 코드를 저장하고, 바뀐 내용을 기록하고, 검토해서 합칩니다.
- 그다음에 필요한 일 — 코드를 브라우저가 읽을 파일로 조립하고(빌드), 인터넷에 올립니다(배포).
빌드와 배포는 어디서 도나요
- 도는 곳: 내 컴퓨터가 아니라 배포 자동화 서비스의 컴퓨터
- 코드를 GitHub에 올리면 연결된 서비스가 그 코드를 읽어 사이트로 만들고 주소에 올립니다
- 남의 컴퓨터를 빌려 쓰는 것이라 무료 한도가 있습니다
- 한도를 넘기면 결제 정보가 없을 때 실행이 막힙니다
한 곳에 묶어 두면 생기는 일
- 배포 자동화가 코드 저장소와 같은 서비스에 묶이면, 그 서비스의 결제·한도 문제로 배포까지 함께 멈춥니다
- 결과: 코드는 멀쩡한데 사이트만 옛날 것으로 남습니다
- 저장하는 곳과 배포를 돌리는 곳을 나누면 동반 정지가 없습니다
- 예: 사이트를 Cloudflare에 올린다면 Cloudflare 자체 빌드 기능으로 배포를 돌려 GitHub 쪽 한도와 떼어 놓습니다
- 지금 작업 중인 저장소가 어디서 배포되는지부터 확인해 보세요
배포가 성공해도 화면은 확인합니다
- 배포 자동화가 성공으로 끝나도 화면이 비어 있을 수 있습니다
- 이유: 저장소에 없는 파일은 배포에 따라오지 않습니다
- 확인 방법: 「배포했다는 말과 화면이 살아 있는 것」 카드
직접 해보기
그대로 붙여넣기
이 저장소에 배포 자동화가 붙어 있는지 확인해 줘. 어떤 서비스가 어떤 조건에서 실행되는지, 설정 파일 경로와 함께 알려 줘.
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
내 상황에 맞춰
내가 만들려는 건 [한 줄로 설명]이야. 이걸 인터넷에 올리려면 코드를 올리는 것 말고 어떤 단계가 더 필요한지 순서대로 알려 줘.
한 단계 더
지금 배포 자동화가 멈추면 무엇이 같이 멈추는지 짚어 줘. 코드 저장과 배포가 같은 서비스에 묶여 있는지도 확인해 줘.
지금 작업 중인 저장소에 위 첫 프롬프트를 넣어, 배포가 어디서 도는지 이름으로 확인해 보세요.
헷갈리기 쉬운 것
코드를 올렸는데 사이트가 그대로면 배포가 아직 안 돌았거나 실패한 것이므로, 저장소 화면의 실행 기록부터 확인합니다. 배포 자동화는 무료 한도가 있고, 한도를 넘기면 결제 정보가 없을 때 실행이 막힙니다. 이때는 코드가 멀쩡해도 사이트가 갱신되지 않습니다.
용어 풀이
전체 용어집 →2026-07-26 기준 · 출처 · GitHub Actions billing, Cloudflare Workers Builds