본문으로 건너뛰기
배포와 운영 기초집LESSON 05

GitHub Pages의 구조와 비용 없는 정적 배포

난이도입문 → 초급
예상 시간30분
선수지식이전 강의

5강. GitHub Pages의 구조와 비용 없는 정적 배포

1. 이번 강의에서 해결할 문제​

무료라는 말만 믿고 저장소 공개 범위·사용량 정책·기능 한계를 확인하지 않으면 비밀 코드 노출이나 예상치 못한 제약을 만날 수 있습니다.

2. 학습 목표​

3. 핵심 개념​

프로젝트 Pages는 보통 https://USER.github.io/REPOSITORY/ 경로를 사용합니다. GitHub 공식 문서 기준으로 GitHub Free의 공개 저장소에서 Pages를 사용할 수 있지만 저장소 공개 범위, 사용량, 빌드·Actions 정책은 바뀔 수 있습니다. 실제 사용 전 계정의 Plan, Pages, Actions billing 화면과 공식 문서를 다시 확인합니다.

GitHub Pages 시작 문서는 현재 플랜별 제공 범위를 설명합니다.

4. 단계별 실습​

1. PowerShell​

실행 위치: 저장소 루트

실행 전 확인: 토큰이 포함된 remote URL이 아닌지 확인합니다.

대상: 원격 저장소와 Docusaurus 공개 주소 설정

PowerShell
git remote get-url origin
Select-String -Path .\docusaurus.config.js -Pattern "url:|baseUrl:|organizationName:|projectName:"

예상 결과: GitHub 원격과 프로젝트 Pages 경로를 결정하는 네 설정이 표시됩니다.

2. GitHub 웹 화면​

실행 위치: 저장소 Settings → Pages 및 계정 Billing

실행 전 확인: 결제 수단 추가나 유료 전환 버튼은 누르지 않습니다.

대상: 현재 Pages source·가시성·사용량 정책

GitHub 웹 화면
1. Pages의 배포 원본 확인
2. 저장소 Public/Private 확인
3. Actions 사용량과 포함 한도 확인
4. 공식 Pages limits 링크 열기
5. 확인 날짜를 운영 문서에 기록

예상 결과: 현재 계정 조건에서 비용 없이 운영 가능한 근거와 한계를 기록합니다.

5. 배포·운영 흐름이 동작하는 이유​

GitHub Pages는 저장소의 배포 artifact를 정적 웹 주소에 연결합니다. 공개 저장소와 표준 runner의 현재 정책 범위에서는 비용 없이 운영할 수 있지만 서버 코드, 데이터베이스, 비공개 데이터 처리는 제공하지 않습니다.

6. 자주 하는 실수와 안전한 해결법​

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

GitHub Pages의 구조와 비용 없는 정적 배포 미니 퀴즈

선택 즉시 정답과 해설을 확인할 수 있습니다. 결과는 이 브라우저에만 저장됩니다.

0 / 2
  1. 문제 1“GitHub Pages의 구조와 비용 없는 정적 배포” 기능을 확장하기 좋은 구조로 설명한 것은 무엇인가요?
  2. 문제 2“GitHub Pages의 구조와 비용 없는 정적 배포”의 작업 기준으로 ‘공개 저장소에 비밀을 넣고 Pages만 공개된다고 생각’을 진단하거나 바로잡은 선택은 무엇인가요?

답을 선택하면 진행 결과가 자동으로 저장됩니다.

LESSON STATUS

학습을 마쳤나요?

직접 실습과 점검 질문까지 확인한 뒤 완료로 표시하세요.

5강. GitHub Pages의 구조와 비용 없는 정적 배포 미완료 상태