7장. 배포 — GitHub Pages로 공개하기
필수 이 단계를 따라가려면 꼭 읽으세요.한 줄 요약: GitHub Pages는 저장소의 웹 파일을 그대로 인터넷 사이트로 올려 주는 무료 서비스입니다. 무료 계정에서는 공개 저장소여야 씁니다. 배포는 바깥 세상에 영향을 주는 행동이라 Claude Code의 되감기로 되돌릴 수 없습니다. 공개해도 되는지는 사람이 확인하고 누릅니다.
이 장은 2026년 11월 1일에 확인한 GitHub·Claude Code 공식 문서를 바탕으로 썼습니다. GitHub 화면은 영어 기준으로 적었습니다.
GitHub Pages란
GitHub Pages는 저장소에 있는 웹 파일(HTML·CSS·JavaScript, 웹 페이지를 이루는 파일)을 받아 웹사이트로 게시하는 서비스입니다.[1] 필요하면 게시 전에 빌드(파일을 사이트에 올릴 모양으로 바꾸는 과정)를 거칩니다. 할 일 보드는 파일을 그대로 올리면 되니 빌드를 신경 쓰지 않아도 됩니다.
Pages는 정적 사이트(Static site)를 올리는 곳입니다. 정적 사이트는 방문자마다 내용이 바뀌는 서버 없이, 정해진 파일을 그대로 보여 주는 사이트입니다. 할 일 보드처럼 표를 보여 주는 페이지에 잘 맞습니다.
2장에서 본 것처럼, 무료 계정은 공개 저장소에서만 Pages를 쓸 수 있습니다.[2] 그리고 Pages 사이트는 인터넷에 공개됩니다. 요금제가 허락해 비공개 저장소로 만들어도 사이트는 공개되므로, 민감한 데이터는 게시 전에 지워야 합니다.[3]
확인 퀴즈
무료 계정의 GitHub Pages에 대한 설명으로 맞는 것은 무엇일까요?
게시하는 두 가지 방법
| 방법 | 언제 |
|---|---|
| 브랜치에서 게시 | 빌드 과정을 따로 손볼 필요가 없을 때(권장) |
| GitHub Actions로 게시 | 빌드 과정을 직접 정하고 싶을 때 |
출처: GitHub 공식 문서(일부만 옮김)[4]
두 번째 방법의 GitHub Actions는 5장에서 본 기능입니다. 올릴 때마다 정해 둔 일을 GitHub이 자동으로 돌려 줍니다. 이 방법은 그 기능으로 게시까지 맡깁니다.
할 일 보드처럼 파일을 그대로 보여 주는 페이지는 브랜치에서 게시로 충분합니다. 공식 문서도 빌드 과정을 손볼 필요가 없으면 이 방법을 권합니다.[4:1] 브랜치와 폴더(저장소 맨 위 / 또는 /docs)를 고르면, 그 브랜치에 올릴 때마다 그 폴더의 내용이 게시됩니다.[5]
게시된 사이트의 주소는 https://내아이디.github.io/저장소이름/ 모양입니다.
자세히: GitHub Actions로 게시하는 방법 (눌러서 펼치기)
이 가이드의 「직접 해 보기」에서는 쓰지 않습니다. GitHub의 입문 튜토리얼이 이 방법을 쓰기 때문에, 튜토리얼을 볼 때 헷갈리지 않도록 적어 둡니다.
설정의 Pages에서 Source를 GitHub Actions로 바꾸고 배포 설정 파일을 넣으면, 그 뒤로 main에 올릴 때마다 사이트가 다시 배포됩니다.[6]
확인 퀴즈
할 일 보드처럼 빌드 과정을 손볼 필요가 없는 페이지에 공식 문서가 권하는 게시 방법은 무엇일까요?
한도와 금지 사항
무료지만 쓰면 안 되는 곳이 있습니다. 먼저 이 두 가지만 기억하세요.
- 사업에 쓰지 않기: 사업·쇼핑몰·상업용 서비스(SaaS, 돈을 받고 제공하는 온라인 서비스) 운영은 금지입니다.[7]
- 비밀번호를 받지 않기: 비밀번호·카드 번호를 주고받는 페이지에는 쓰지 마세요.[8]
연습용 할 일 보드는 둘 다 해당하지 않습니다.
방문자의 IP 주소가 기록됩니다. IP 주소는 인터넷에 접속한 기기마다 붙는 번호입니다. Pages 사이트에 누가 들어오면, 로그인 여부와 관계없이 보안 목적으로 방문자의 IP 주소가 기록·저장됩니다.[9] 내 페이지에 "아무것도 모으지 않습니다"라고 쓰고 싶다면 이 점도 함께 적으세요.
자세히: 크기·시간 한도와 연습 사이트 조건 (눌러서 펼치기)
| 구분 | 한도 |
|---|---|
| 크기 | 게시된 사이트 1GB 이하 |
| 시간 | 배포가 10분을 넘으면 실패 |
| 대역폭 | 한 달 100GB(느슨한 한도) |
출처: GitHub 공식 문서(일부만 옮김)[10][11][12]
대역폭은 방문자에게 보낸 데이터의 양입니다.
실제 서비스를 흉내 낸 연습 사이트에는 조건이 있습니다. 배우려고 베껴 만드는 것 자체는 금지가 아니지만, 코드를 직접 쓰고, 사용자 데이터를 모으지 않고, 원본과 관계없는 교육용이라는 눈에 띄는 안내를 달아야 합니다.[13]
확인 퀴즈
GitHub Pages에 쓰면 안 되는 용도는 무엇일까요?
배포는 되감기로 되돌릴 수 없다
3단계에서 배운 Claude Code의 되감기(체크포인트)는 세션 안의 빠른 복구용입니다. 영구적인 기록은 Git이 맡습니다.[14] 그리고 데이터베이스·외부 서비스·배포처럼 바깥 시스템에 영향을 주는 행동은 체크포인트로 되돌릴 수 없습니다.[15]
그래서 배포 직전에 사람이 확인합니다. 공식 문서도 제안된 명령이 안전한지 승인 전에 검토할 책임은 사용자에게 있다고 적습니다.[16]
배포 전에 이 질문을 해 보세요.
- 5장의 확인 장치가 통과했나?
- 6장의 리뷰를 마치고 PR을 합쳤나?
- 공개 저장소와 페이지에 실명·연락처·비밀번호가 없나?(9장)
민감한 것을 올렸다면 되돌리는 것만으로는 부족합니다. 공개 저장소의 Git 기록에 남기 때문입니다. 9장의 순서(먼저 폐기·교체)를 따르세요.
확인 퀴즈
배포를 Claude Code의 되감기(체크포인트)로 되돌릴 수 없는 이유는 무엇일까요?
직접 해 보기
- 먼저 9장의 공개 전 점검표로 비밀값·개인 정보를 확인한다.
- GitHub에서
cafe-todo-board저장소의 Settings → Pages를 연다. - 「Build and deployment」의 Source에서 Deploy from a branch를 고르고, Branch에서
main브랜치와/(맨 위) 폴더를 고른다.[17] - 저장소 맨 위에
index.html이 있는지 확인한다. GitHub Pages는 게시 폴더 맨 위에서 이 파일을 찾는다.[18] 그다음https://내아이디.github.io/cafe-todo-board/를 연다. 올린 뒤 반영까지 최대 10분쯤 걸릴 수 있다.[17:1] 할 일 보드가 보이면 성공이다. - 휴대폰에서도 열어 본다.
- 페이지 아래에 "연습용으로 만든 페이지이며 방문 정보를 모으지 않습니다(GitHub Pages는 보안 목적으로 방문자 IP를 기록함)" 같은 안내를 달지 생각해 본다.
이어지는 과제: 8장에서는 "기한 지난 할 일을 빨간색으로" 같은 개선을 이슈로 적고, 한 바퀴를 더 돕니다.
정리
- GitHub Pages는 저장소의 웹 파일을 사이트로 올린다. 무료 계정은 공개 저장소에서만 되고, 사이트는 늘 공개된다.
- 빌드를 손볼 필요가 없으면 브랜치에서 게시한다.
- 사업·쇼핑몰·비밀번호 입력에는 쓰지 않는다. 크기·시간 한도가 있고, 방문자 IP가 기록된다.
- 배포는 되감기로 되돌릴 수 없다. 확인·리뷰·공개 점검을 마치고 사람이 누른다.
용어 정리
| 용어 | 읽는 법 | 한 줄 뜻 |
|---|---|---|
| GitHub Pages | 깃허브 페이지스 | 저장소 파일을 무료 웹사이트로 올리는 서비스 |
| Static site | 스태틱 사이트 | 정해진 파일을 그대로 보여 주는 사이트(정적 사이트) |
| Hosting | 호스팅 | 사이트를 인터넷에 올려 두는 일 |
| Bandwidth | 밴드위스 | 방문자에게 보낸 데이터의 양(대역폭) |
이 장을 다 읽었나요?
기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.
다음 장: 8장. 운영과 개선
참고 자료 (18개)
GitHub 공식 문서, 「What is GitHub Pages?」. "GitHub Pages is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository on GitHub, optionally runs the files through a build process, and publishes a website." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「What is GitHub Pages?」. "GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「Configuring a publishing source for your GitHub Pages site」. "GitHub Pages sites are publicly available on the internet, even if the repository for the site is private (if your plan or organization allows it)." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「Configuring a publishing source for your GitHub Pages site」. "You can publish your site when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site." / "If you do not need any control over the build process for your site, we recommend that you publish your site when changes are pushed to a specific branch." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「Configuring a publishing source for your GitHub Pages site」. "Whenever changes are pushed to the source branch, the changes in the source folder will be published to your GitHub Pages site." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「Deploying your website automatically」. "Under "Build and deployment", from the Source dropdown, select GitHub Actions." / "From now on, every push to
mainredeploys your site with your latest changes." docs.github.com (확인일 2026-11-01) ↩︎GitHub 공식 문서, 「GitHub Pages limits」. "GitHub Pages is not intended for or allowed to be used as a free web-hosting service to run your online business, e-commerce site, or any other website that is primarily directed at either facilitating commercial transactions or providing commercial software as a service (SaaS)." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「GitHub Pages limits」. "GitHub Pages sites shouldn't be used for sensitive transactions like sending passwords or credit card numbers." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「What is GitHub Pages?」. "When a GitHub Pages site is visited, the visitor's IP address is logged and stored for security purposes, regardless of whether the visitor has signed into GitHub or not." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「GitHub Pages limits」. "Published GitHub Pages sites may be no larger than 1 GB." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「GitHub Pages limits」. "GitHub Pages deployments will timeout if they take longer than 10 minutes." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「GitHub Pages limits」. "GitHub Pages sites have a soft bandwidth limit of 100 GB per month." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「GitHub Pages limits」. "Using GitHub Pages to create a copy of an existing website as a learning exercise is not prohibited." / "you must write the code yourself, the site must not collect any user data, and you must include a prominent disclaimer on the site indicating that the project is not associated with the original and was only created for educational purposes." docs.github.com (확인일 2026-11-01) ↩︎
Claude Code 공식 문서, 「Checkpointing」. "Checkpoints are designed for quick, session-level recovery. For permanent version history and collaboration, continue using version control, such as Git, for commits, branches, and long-term history." code.claude.com (확인일 2026-11-01) ↩︎
Claude Code 공식 문서, 「How Claude Code works」. "Actions that affect remote systems (databases, APIs, deployments) can't be checkpointed. You control those with your permission mode and permission rules." code.claude.com (확인일 2026-11-01) ↩︎
Claude Code 공식 문서, 「Security」. "You're responsible for reviewing proposed code and commands for safety before approval." code.claude.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「Quickstart for GitHub Pages」. "Under "Build and deployment", under "Source", select Deploy from a branch." / "Note that it can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub." docs.github.com (확인일 2026-11-01) ↩︎
GitHub 공식 문서, 「Creating a GitHub Pages site」. "GitHub Pages will look for an
index.html,index.md, orREADME.mdfile as the entry file for your site." docs.github.com (확인일 2026-11-01) ↩︎