Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

GitHub Pages 사이트에 대한 게시 원본 구성

변경 내용이 특정 분기에 푸시될 때 게시하도록 GitHub Pages 사이트를 구성하거나 GitHub Actions 워크플로를 작성하여 사이트를 게시할 수 있습니다.

이 기능을 사용할 수 있는 사용자

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

GitHub Pages는 GitHub Free 및 조직에 대한 GitHub Free가 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server가 있는 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다. 자세한 내용은 “GitHub 제품”을 참조하세요.

게시 원본 정보

변경 내용이 특정 분기로 푸시될 때 사이트를 게시하거나 GitHub Actions 워크플로를 작성하여 사이트를 게시할 수 있습니다.

사이트의 빌드 프로세스를 제어할 필요가 없는 경우 변경 내용이 특정 분기로 푸시될 때 사이트를 게시하는 것이 좋습니다. 게시 원본으로 사용할 분기 및 폴더를 지정할 수 있습니다. 원본 분기는 리포지토리의 모든 분기일 수 있으며 원본 폴더는 원본 분기에 있는 리포지토리(/)의 루트이거나 원본 분기의 /docs 폴더일 수 있습니다. 변경 내용이 원본 분기로 푸시될 때마다 원본 폴더의 변경 내용이 GitHub Pages 사이트에 게시됩니다.

Jekyll 이외의 빌드 프로세스를 사용하거나 전용 분기에서 컴파일된 정적 파일을 보관하지 않으려면 GitHub Actions 워크플로를 작성하여 사이트를 게시하는 것이 좋습니다. GitHub은(는) 워크플로를 작성하는 데 도움이 되는 일반적인 게시 시나리오를 위한 시작 워크플로를 제공합니다.

경고: 사이트의 리포지토리가 프라이빗인 경우에도 GitHub Pages 사이트는 인터넷에서 공개적으로 사용할 수 있습니다. 사이트의 리포지토리에 중요한 데이터가 있는 경우 게시하기 전에 데이터를 제거할 수 있습니다. 자세한 내용은 “리포지토리 정보”를 참조하세요.

분기에서 게시

  1. 게시 원본으로 사용할 분기가 리포지토리에 이미 있는지 확인합니다.

  2. GitHub에서 사이트의 리포지토리로 이동합니다. 1. 리포지토리 이름 아래에서 설정을 클릭합니다. 리포지토리 설정 단추

  3. 사이드바의 “코드 및 자동화” 섹션에서 페이지를 클릭합니다.

  4. "빌드 및 배포"의 "원본"에서 분기에서 배포를 선택합니다.

  5. "빌드 및 배포"의 "분기"에서 없음 또는 분기 드롭다운 메뉴를 사용하여 게시 원본을 선택합니다.

    게시 원본을 선택할 수 있는 드롭다운 메뉴

  6. 필요에 따라 드롭다운 메뉴를 사용하여 게시 원본의 폴더를 선택합니다. 게시 원본의 폴더를 선택할 수 있는 드롭다운 메뉴

  7. 저장을 클릭합니다. 게시 원본 설정에 대한 변경 내용을 저장하는 단추

분기에서 게시 문제 해결

참고: 분기에서 게시하는 경우 및 관리자 권한과 확인된 메일 주소를 가진 사람이 게시 원본으로 푸시되었는지 확인합니다.

분기의 docs 폴더를 게시 원본으로 선택하고 나중에 리포지토리의 해당 분기에서 /docs 폴더를 제거한 경우 사이트가 빌드되지 않으며 누락된 /docs 폴더에 대한 페이지 빌드 오류 메시지가 표시됩니다. 자세한 내용은 “GitHub Pages 사이트에 대한 Jekyll 빌드 오류 문제 해결”을 참조하세요.

다른 CI 도구를 사용하여 GitHub Pages 사이트를 빌드하도록 구성한 경우에도 GitHub Pages 사이트는 항상 GitHub Actions 워크플로 실행과 함께 배포됩니다. 대부분의 외부 CI 워크플로는 빌드 출력을 리포지토리의 gh-pages 분기에 커밋하여 GitHub Pages에 “배포”하며 일반적으로 .nojekyll 파일을 포함합니다. 이 경우 GitHub Actions 워크플로는 분기에 빌드 단계가 필요하지 않은 상태를 검색하고 사이트를 GitHub Pages 서버에 배포하는 데 필요한 단계만 실행합니다.

빌드 또는 배포에서 잠재적인 오류를 찾으려면 리포지토리의 워크플로 실행을 검토하여 GitHub Pages 사이트에 대한 워크플로 실행을 검사할 수 있습니다. 자세한 내용은 “워크플로 실행 기록 보기”를 참조하세요. 오류가 발생할 경우 워크플로를 다시 실행하는 방법에 대한 자세한 내용은 “워크플로 및 작업 다시 실행”을 참조하세요.

사용자 지정 GitHub Actions 워크플로를 사용하여 게시

참고: 사용자 지정 GitHub Actions 워크플로를 사용하여 GitHub Pages 사이트를 게시하는 것은 베타이며 변경될 수 있습니다.

GitHub Actions을(를) 사용하여 게시하도록 사이트를 구성하려면 다음을 수행합니다.

  1. GitHub에서 사이트의 리포지토리로 이동합니다. 1. 리포지토리 이름 아래에서 설정을 클릭합니다. 리포지토리 설정 단추

  2. 사이드바의 “코드 및 자동화” 섹션에서 페이지를 클릭합니다.

  3. "빌드 및 배포"의 "원본"에서 GitHub Actions 을(를) 선택합니다.

  4. GitHub은(는) 몇 가지 시작 워크플로를 제안합니다. 사이트를 게시할 워크플로가 이미 있는 경우 이 단계를 건너뛸 수 있습니다. 그렇지 않으면 GitHub Actions 워크플로를 만드는 옵션 중 하나를 선택합니다. 사용자 지정 워크플로를 만드는 방법에 대한 자세한 내용은 "사이트를 게시하는 사용자 지정 GitHub Actions 워크플로 만들기"를 참조하세요.

    GitHub Pages은(는) 특정 워크플로를 GitHub Pages 설정에 연결하지 않습니다. 그러나 GitHub Pages 설정은 가장 최근에 사이트를 배포한 워크플로 실행에 연결됩니다.

사용자 지정 GitHub Actions 워크플로를 만들어 사이트 게시

GitHub Actions에 대한 자세한 내용은 "작업"을(를) 참조하세요.

GitHub Actions을(를) 사용하여 게시하도록 사이트를 구성할 때 GitHub은(는) 일반적인 게시 시나리오에 대한 시작 워크플로를 제안합니다. 워크플로의 일반적인 흐름은 다음과 같습니다.

  1. 리포지토리의 기본 분기에 푸시가 있거나 작업 탭에서 워크플로를 수동으로 실행할 때마다 트리거됩니다.
  2. actions/checkout 작업을 사용하여 리포지토리 콘텐츠를 확인합니다.
  3. 사이트에서 필요한 경우 정적 사이트 파일을 빌드합니다.
  4. actions/upload-pages-artifact 작업을 사용하여 정적 파일을 아티팩트로 업로드합니다.
  5. 워크플로가 기본 분기로 푸시하여 트리거된 경우 actions/deploy-pages 작업을 사용하여 아티팩트를 배포합니다. 워크플로가 끌어오기 요청에 의해 트리거된 경우 이 단계를 건너뜁니다.

시작 워크플로는 github-pages라는 배포 환경을 사용합니다. 리포지토리에 아직 github-pages라는 환경이 포함되어 있지 않으면 환경이 자동으로 만들어집니다. 기본 분기만 이 환경에 배포할 수 있도록 환경 보호 규칙을 추가하는 것이 좋습니다. 자세한 내용은 “배포에 환경 사용”을 참조하세요.

참고: 리포지토리 파일의 CNAME 파일은 사용자 지정 도메인을 자동으로 추가하거나 제거하지 않습니다. 대신 리포지토리 설정 또는 API를 통해 사용자 지정 도메인을 구성해야 합니다. 자세한 내용은 "GitHub Pages 사이트의 사용자 지정 도메인 관리" 및 Pages API 참조 설명서를 참조하세요.

사용자 지정 GitHub Actions 워크플로를 사용하여 게시 문제 해결

GitHub Actions 워크플로의 문제를 해결하는 방법에 대한 자세한 내용은 "모니터링 및 문제 해결 정보"를 참조하세요.