Skip to main content

사전 빌드 관리

리포지토리에 대한 사전 빌드 구성을 검토, 수정 및 삭제할 수 있습니다.

누가 이 기능을 사용할 수 있는 있나요?

GitHub Codespaces의 리포지토리 수준 설정은 개인 계정이 소유하는 모든 리포지토리에 사용할 수 있습니다.

조직이 소유한 리포지토리의 경우 GitHub Codespaces의 리포지토리 수준 설정은 GitHub Team 및 GitHub Enterprise 플랜의 조직에서 사용할 수 있습니다. 설정에 액세스하려면 조직 또는 부모 엔터프라이즈가 결제 방법을 추가하고 GitHub Codespaces의 지출 한도를 설정해야 합니다. 자세한 내용은 "조직에서 codespace를 소유하고 비용을 지불하는 사람 선택"과 "GitHub의 플랜"을 참조하세요.

사전 빌드 관리 정보

리포지토리에 구성하는 사전 빌드는 GitHub Actions 워크플로를 사용하여 생성 및 업데이트되며 GitHub Codespaces 서비스에서 관리합니다.

사전 빌드 구성의 설정에 따라 다음과 같은 이벤트에 의해 사전 빌드를 업데이트하는 워크플로가 트리거될 수 있습니다.

  • 사전 빌드 구성 만들기 또는 업데이트
  • 사전 빌드를 포함하도록 구성된 분기에 커밋 또는 끌어오기 요청 푸시
  • 개발 컨테이너 구성 파일 변경
  • 사전 빌드 구성에서 정의한 일정
  • 수동으로 워크플로 트리거

사전 빌드 구성의 설정은 사전 빌드의 업데이트를 자동으로 트리거하는 이벤트를 결정합니다. 자세한 내용은 "사전 빌드 구성"을(를) 참조하세요.

리포지토리에 대한 관리자 액세스 권한이 있는 사용자는 사전 빌드의 진행 상황을 확인하고 사전 빌드 구성을 편집 및 삭제할 수 있습니다.

사전 빌드 구성을 호스팅하는 모든 리포지토리를 찾으려면 "GitHub Codespaces 사용량 확인"에 대한 단계에 따라 사용 보고서 복사본을 가져와야 합니다.

사전 빌드 진행 보기

리포지토리 설정의 GitHub Codespaces 페이지에서 설정한 각 사전 빌드 구성에 대한 최신 워크플로 실행의 현재 상태를 볼 수 있습니다. 예를 들어 “현재 실행 중” 또는 “1시간 전 마지막 실행”이 있습니다.

최신 사전 빌드 워크플로 실행에 대한 로그 출력을 보려면 출력 보기를 클릭합니다.

"사전 빌드 구성" 페이지의 스크린샷입니다. 두 개의 사전 빌드 구성이 나열됩니다. 하나의 구성에 대한 "출력 보기" 단추가 강조 표시됩니다.

그러면 작업 탭에 워크플로의 가장 최근 실행 출력이 표시됩니다.

GitHub.com의 "작업" 탭에 있는 사전 빌드 워크플로 출력의 스크린샷입니다.

또는 지정된 분기와 연결된 모든 사전 빌드 워크플로 실행을 보려면 드롭다운 메뉴를 선택하고 실행 보기를 클릭합니다.

세 개의 점 레이블이 지정된 단추를 클릭하여 표시된 구성에 대한 옵션 드롭다운 메뉴의 스크린샷입니다. "실행 보기" 옵션이 선택되어 있습니다.

연결된 분기의 사전 빌드에 대한 워크플로 실행 기록이 표시됩니다.

사전 빌드 워크플로에 대한 실행 기록을 보여 주는 "Codespaces 사전 빌드" 목록의 스크린샷입니다.

사전 빌드 구성 편집

  1. 리포지토리 설정의 Codespaces 페이지에서 편집하려는 사전 빌드 구성의 오른쪽에 있는 줄임표를 클릭합니다.

  2. 드롭다운 메뉴에서 편집을 클릭합니다.

    세 개의 점 레이블이 지정된 단추를 클릭하여 표시되는 구성에 대한 옵션 드롭다운 메뉴의 스크린샷입니다. "편집" 옵션이 선택되어 있습니다.

  3. 사전 빌드 구성에 필요한 변경 내용을 적용한 다음 업데이트를 클릭합니다.

    리포지토리에 대한 개발 컨테이너 구성에서 다른 리포지토리에 액세스하기 위한 권한을 지정하는 경우 권한 부여 페이지가 표시됩니다. devcontainer.json 파일에서 이것이 지정되는 방법에 대한 자세한 내용은 "Codespace 내의 다른 리포지토리에 대한 액세스 관리"을(를) 참조하세요.

    요청한 사용 권한의 세부 정보를 보려면 을 클릭합니다.

    사전 빌드 구성에 대한 권한 부여 페이지의 스크린샷. 이 요청에는 세 가지 권한이 나열됩니다.

    사전 빌드 생성에 대해 이러한 사용 권한을 부여하려면 권한 부여하고 계속하기를 클릭합니다. 또는 권한 부여 건너뛰고 계속하기를 클릭해도 되지만 이렇게 하면 사전 빌드 결과로 만들어진 codespace가 제대로 작동하지 않을 수 있습니다.

    참고: 이 사전 빌드를 사용하여 codespace를 만드는 사용자에게도 이러한 권한을 부여하라는 메시지가 표시됩니다.

사전 빌드 구성 비활성화

구성에 대한 사전 빌드의 업데이트를 일시 중지하려면 구성에 대한 워크플로 실행을 사용하지 않도록 설정하면 됩니다. 사전 빌드 구성에 대해 워크플로 실행을 사용하지 않도록 설정해도 해당 구성에 대해 이전에 만든 사전 빌드는 삭제되지 않으며, 결과적으로 기존 사전 빌드 템플릿에서 codespace가 계속 생성됩니다.

사전 빌드 구성에 대해 워크플로 실행을 사용하지 않도록 설정하는 것은 사전 빌드 만들기 실패를 조사해야 하는 경우에 유용합니다.

  1. 리포지토리 설정의 Codespaces 페이지에서 비활성화하려는 사전 빌드 구성의 오른쪽에 있는 줄임표를 클릭합니다.

  2. 드롭다운 메뉴에서 실행 사용 안 함을 클릭합니다.

    세 개의 점 레이블이 지정된 단추를 클릭하여 표시된 구성에 대한 옵션 드롭다운 메뉴의 스크린샷입니다. "실행 사용 안 함" 옵션이 선택되어 있습니다.

  3. 이 구성을 사용하지 않음을 확인하기 위해 확인을 클릭합니다.

사전 빌드 구성 삭제

참고: "사용량 보고서"의 복사본을 가져와서 사전 빌드가 포함된 리포지토리 목록을 찾을 수 있습니다.

사전 빌드 구성을 삭제하면 해당 구성에 대해 이전에 만든 모든 사전 빌드도 삭제됩니다. 따라서 구성을 삭제한 직후에 새 codespace를 만들 때 해당 구성에서 생성된 사전 빌드를 더 이상 사용할 수 없습니다.

사전 빌드 구성을 삭제한 후에도 큐에 대기되었거나 시작된 해당 구성에 대한 워크플로는 계속 실행됩니다. 이전에 완료된 워크플로 실행과 함께 워크플로 실행 기록에 나열됩니다.

  1. 리포지토리 설정의 Codespaces 페이지에서 삭제하려는 사전 빌드 구성의 오른쪽에 있는 줄임표를 클릭합니다.

  2. 드롭다운 메뉴에서 삭제를 클릭합니다.

    세 개의 점 레이블이 지정된 단추를 클릭하여 표시되는 구성에 대한 옵션 드롭다운 메뉴의 스크린샷입니다. "삭제" 옵션이 선택되어 있습니다.

  3. 클릭 확인 여 삭제를 확인 합니다.

수동으로 사전 빌드 트리거

사전 빌드 구성에 대한 워크플로 실행을 수동으로 트리거하는 것이 유용할 수 있습니다. 일반적으로 이 작업은 사전 빌드 구성에 대한 워크플로 문제를 디버그하는 경우에만 필요합니다.

  1. 리포지토리 설정의 Codespaces 페이지에서 워크플로를 트리거하려는 사전 빌드 구성의 오른쪽에 있는 줄임표를 클릭합니다.

  2. 드롭다운 메뉴에서 수동으로 트리거를 클릭합니다.

    세 개의 점 레이블이 지정된 단추를 클릭하여 표시된 구성에 대한 옵션 드롭다운 메뉴의 스크린샷입니다. "수동으로 트리거" 옵션이 선택되어 있습니다.

추가 참고 자료