studio.soluta

먼저 볼 카드 — 커밋·푸시·머지를 그림으로 이해하기, 실전 투입

개념 Deploy

저장과 배포는 다른 일

이 카드를 다루는 수업 좋은 프롬프트로 이미지와 영상 만들기 파리 거리에서 자전거 타기

주황색 퍼핏이 물건을 상자에 담는 자리와 깃발이 꽂힌 기계를 점선으로 연결한 그림
GitHub에 코드를 올리는 저장 단계와 실제 사이트를 띄우는 배포 단계는 따로 확인합니다

코드를 GitHub에 올려도 사이트는 그대로일 수 있습니다. 올리는 것과 띄우는 것이 다른 단계이기 때문입니다.

  • GitHub이 하는 일 — 코드를 저장하고, 바뀐 내용을 기록하고, 검토해서 합칩니다.
  • 그다음에 필요한 일 — 코드를 브라우저가 읽을 파일로 조립하고(빌드), 인터넷에 올려요(배포).

빌드와 배포는 어디서 도나요

내 컴퓨터가 아니라 배포 자동화 서비스의 컴퓨터에서 돌아갑니다. 코드를 GitHub에 올리면 연결된 서비스가 그 코드를 읽어 사이트로 만들고 주소에 올립니다.

남의 컴퓨터를 빌려 쓰는 것이라 무료 한도가 있습니다. 한도를 넘기면 결제 정보가 없을 때 실행이 막힙니다.

한 곳에 묶어 두면 생기는 일

배포 자동화가 코드 저장소와 같은 서비스에 묶여 있으면, 그 서비스의 결제나 한도 문제로 배포까지 함께 멈춥니다. 코드는 멀쩡한데 사이트만 옛날 것으로 남습니다.

저장하는 곳과 배포를 돌리는 곳을 나눠 두면 이런 동반 정지가 없습니다. 예를 들어 사이트를 Cloudflare에 올린다면 Cloudflare 자체 빌드 기능으로 배포를 돌려, GitHub 쪽 한도와 떼어 놓을 수 있습니다.

지금 작업 중인 저장소가 어디서 배포되는지부터 확인해 보세요.

배포가 성공해도 화면은 확인합니다

배포 자동화가 성공으로 끝나도 화면이 비어 있을 수 있습니다. 저장소에 없는 파일은 배포에 따라오지 않기 때문입니다. 무엇을 어떻게 확인하는지는 다음 카드에서 다룹니다.

직접 해보기

그대로 붙여넣기
이 저장소에 배포 자동화가 붙어 있는지 확인해 줘. 어떤 서비스가 어떤 조건에서 실행되는지, 설정 파일 경로와 함께 알려 줘.

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

내 상황에 맞춰
내가 만들려는 건 [한 줄로 설명]이야. 이걸 인터넷에 올리려면 코드를 올리는 것 말고 어떤 단계가 더 필요한지 순서대로 알려 줘.
한 단계 더
지금 배포 자동화가 멈추면 무엇이 같이 멈추는지 짚어 줘. 코드 저장과 배포가 같은 서비스에 묶여 있는지도 확인해 줘.

지금 작업 중인 저장소에 위 첫 프롬프트를 넣어, 배포가 어디서 도는지 이름으로 확인해 보세요.

헷갈리기 쉬운 것

코드를 올렸는데 사이트가 그대로면 배포가 아직 안 돌았거나 실패한 것이므로, 저장소 화면의 실행 기록부터 확인합니다. 배포 자동화는 무료 한도가 있고, 한도를 넘기면 결제 정보가 없을 때 실행이 막힙니다. 이때는 코드가 멀쩡해도 사이트가 갱신되지 않습니다.

용어 풀이

전체 용어집 →
빌드
작성한 코드를 브라우저가 읽을 수 있는 파일 묶음으로 조립하는 단계입니다.
배포
조립된 파일을 인터넷에 올려 주소로 열리게 하는 단계입니다.
배포 자동화
코드를 올리면 빌드와 배포를 대신 실행해 주는 서비스입니다. GitHub Actions, Cloudflare Workers Builds 같은 것이 있습니다.

2026-07-26 기준 · 출처 · GitHub Actions billing, Cloudflare Workers Builds