JamesIves/github-pages-deploy-action

어떤 프로젝트인가요?

핵심 기능

• 01gh-pages와 docs를 포함해 임의의 폴더를 원하는 브랜치에 배포합니다.
• 02Personal Access Token을 사용한 저장소 간 배포를 지원합니다.
• 03기본 GITHUB_TOKEN, PAT 또는 SSH 배포 키로 인증합니다.
• 04제외한 파일은 유지하면서 배포 브랜치의 오래된 파일을 정리합니다.
• 05드라이런 모드, 단일 커밋 히스토리, deployment-status 출력을 제공합니다.

활용 사례

• 푸시할 때마다 React나 Vue 같은 프레임워크로 빌드한 정적 사이트를 GitHub Pages에 게시합니다.
• 빌드 도구로 생성한 문서를 docs 브랜치에 배포합니다.
• 한 저장소의 빌드 결과물을 다른 저장소의 Pages 사이트로 푸시합니다.
• Windows 빌드 작업에서 아티팩트를 Ubuntu 배포 작업으로 전달해 배포합니다.

빠른 시작

1. 1

   저장소를 체크아웃하고 사이트를 빌드한 다음 action으로 배포하는 workflow 파일을 추가합니다

2. 2

   workflow 권한을 contents: write로 설정하고 folder에 빌드 출력 경로를 지정합니다

3. 3

   저장소 설정에서 Pages를 선택한 다음 Deploy from a Branch를 선택하고 배포 브랜치(보통 gh-pages)를 지정합니다

포함된 컬렉션

토픽

자주 묻는 질문

github-pages-deploy-action은(는) 무엇인가요?

프로젝트를 자동으로 빌드해 GitHub Pages에 배포하고, 빌드 결과물을 gh-pages나 docs 같은 브랜치에 푸시하는 GitHub Actions 액션입니다. GitHub Pages Deploy Action은 워크플로의 폴더(예: 빌드 결과물 디렉터리)를 GitHub Pages에 게시하는 GitHub Actions 단계입니다. gh-pages나 docs를 포함해 대상 브랜치를 선택할 수 있으며, 해당 브랜치가 없으면 액션이 생성합니다. 저장소 간 배포도 지원하고 GitHub Enterprise에서도 작동합니다.

github-pages-deploy-action은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

github-pages-deploy-action은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

github-pages-deploy-action은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. github-pages-deploy-action의 마지막 커밋은 2026년 11월 2일입니다.

github-pages-deploy-action은(는) 어디에 사용할 수 있나요?

푸시할 때마다 React나 Vue 같은 프레임워크로 빌드한 정적 사이트를 GitHub Pages에 게시합니다. 빌드 도구로 생성한 문서를 docs 브랜치에 배포합니다. 한 저장소의 빌드 결과물을 다른 저장소의 Pages 사이트로 푸시합니다. Windows 빌드 작업에서 아티팩트를 Ubuntu 배포 작업으로 전달해 배포합니다.

github-pages-deploy-action는 어떻게 설치하나요?

저장소를 체크아웃하고 사이트를 빌드한 다음 action으로 배포하는 workflow 파일을 추가합니다 workflow 권한을 contents: write로 설정하고 folder에 빌드 출력 경로를 지정합니다 저장소 설정에서 Pages를 선택한 다음 Deploy from a Branch를 선택하고 배포 브랜치(보통 gh-pages)를 지정합니다

github-pages-deploy-action은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/JamesIves/github-pages-deploy-action