{"meta":{"title":"사전 빌드 문제 해결","intro":"사전 빌드를 사용하여 Codespace를 빠르게 만들 수 있습니다. 이 문서에서는 사전 빌드의 일반적인 문제에 대한 문제 해결 단계를 제공합니다.","product":"Codespaces","breadcrumbs":[{"href":"/ko/codespaces","title":"Codespaces"},{"href":"/ko/codespaces/troubleshooting","title":"문제 해결"},{"href":"/ko/codespaces/troubleshooting/troubleshooting-prebuilds","title":"Codespaces 사전 빌드"}],"documentType":"article"},"body":"# 사전 빌드 문제 해결\n\n사전 빌드를 사용하여 Codespace를 빠르게 만들 수 있습니다. 이 문서에서는 사전 빌드의 일반적인 문제에 대한 문제 해결 단계를 제공합니다.\n\nGitHub Codespaces 사전 빌드에 대한 자세한 내용은 [코드스페이스 사전 준비](/ko/codespaces/prebuilding-your-codespaces)을(를) 참조하세요.\n\n## Codespace가 사전 빌드에서 만들어졌는지 확인하기.\n\nCodespace를 만들 때 사용하려는 가상 머신의 유형을 선택할 수 있습니다. 해당 가상 머신 유형의 사전 빌드를 사용할 수 있는 경우에는 \" Prebuild ready\"가 옆에 표시됩니다.\n\n\n\nGitHub Codespaces 편집기 기본 설정이 \"웹용 Visual Studio Code\"(으)로 설정되고 사전 빌드를 사용하는 경우 “코드스페이스 설정” 페이지에 “사전 빌드된 코드스페이스가 발견되었습니다”라는 메시지가 표시됩니다.\n\n\n\n마찬가지로 편집기 기본 설정이 “VS Code”인 경우, 새 codespace를 만들 때 “리포지토리에 대한 사전 빌드 구성으로 정의된 사전 빌드된 codespace에 있습니다.”라는 메시지가 통합 터미널에 포함됩니다. 자세한 내용은 [GitHub Codespaces에 대한 기본 편집기 설정](/ko/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces)을(를) 참조하세요.\n\nCodespace를 만든 후 터미널에서 다음 GitHub CLI 명령을 실행하여 사전 빌드에서 만들어졌는지 확인할 수 있습니다.\n\n```shell copy\ngh api /user/codespaces/$CODESPACE_NAME --jq .prebuild\n```\n\n해당 codespace가 사전 빌드를 사용하여 만들어진 경우 `true`을(를) 반환합니다.\n\n또는 GitHub CLI (`gh`)이(가) 설치되지 않은 경우 다음 명령을 사용할 수 있습니다. 이 명령은 codespace가 사전 빌드에서 생성된 경우 `createFromPrebuild`을(를) 반환합니다.\n\n```shell copy\ncat /workspaces/.codespaces/shared/environment-variables.json | jq '.ACTION_NAME'\n```\n\n## 사전 빌드 사용량 확인\n\n리포지토리 설정의 \"Codespaces\" 페이지에서 리포지토리가 사전 빌드를 사용하고 있는지 여부를 확인할 수 있습니다.\n\n개인 또는 조직 계정에 대한 청구 데이터를 검토하여 현재 청구 주기에서 사전 빌드가 사용한 스토리지 공간을 확인할 수 있습니다. 사용 현황 보고서를 생성하여 어떤 리포지토리가 사전 빌드를 사용하고 있는지 확인할 수도 있습니다. 자세한 내용은 [요금제 제품 및 라이선스 사용량 확인하기](/ko/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)을(를) 참조하세요.\n\n## “사전 빌드 준비됨” 레이블이 누락되는 경우가 있습니다.\n\n경우에 따라 사전 빌드를 사용할 수 있는 분기에서 새 codespace를 만들 때 머신 유형을 선택하기 위한 대화 상자에 \" Prebuild Ready\" 레이블이 표시되지 않을 수 있습니다. 이는 현재 사전 빌드를 사용할 수 없음을 의미합니다.\n\n기본적으로 사전 빌드를 사용할 수 있는 분기로 푸시할 때마다 사전 빌드가 업데이트됩니다. 푸시에 개발 컨테이너 구성 변경 내용이 포함된 경우, 업데이트가 진행되는 동안 \" Prebuild Ready\" 레이블이 머신 유형 목록에서 제거됩니다. 그래도 계속해서 사전 빌드 없이 codespace를 만들 수 있습니다. 필요한 경우 개발 컨테이너 구성 파일을 변경할 때만 또는 사용자 지정 일정에 따라 사전 빌드를 업데이트하도록 설정하여 리포지토리에 대해 사전 빌드를 사용할 수 없는 경우를 줄일 수 있습니다. 자세한 내용은 [사전 빌드 구성](/ko/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds)을(를) 참조하세요.\n\n귀하의 분기가 사전 빌드가 설정되지 않았더라도, 사전 빌드가 설정된 분기에서 파생된 경우 사전 빌드의 혜택을 받을 수 있습니다. 그러나 분기에서 개발 컨테이너 구성이 변경되어 기본 분기의 구성과 동일하지 않은 경우 분기에서 더 이상 사전 빌드를 사용할 수 없습니다.\n\n특정 브랜치에 \" Prebuild Ready\" 레이블이 표시되지 않는 경우 확인할 사항은 다음과 같습니다.\n\n* 이 분기에 대한 사전 빌드 구성이 있는지 확인합니다. 리포지토리 관리자가 아닌 경우 해당 관리자에게 문의하여 확인해야 합니다.\n* 사전 빌드 구성에 해당 지역이 포함되어 있음을 확인합니다.\n* 개발 컨테이너 구성에 대한 변경 내용이 최근에 사전 빌드 사용 분기로 푸시되었는지 확인합니다. 그렇다면 일반적으로 사전 빌드를 다시 사용할 수 있기 전에 이 푸시에 대한 사전 빌드 워크플로 실행이 완료될 때까지 기다려야 합니다.\n* 최근에 구성을 변경하지 않은 경우, 리포지토리의 **Actions** 탭으로 이동하여 워크플로 목록에서 ** Codespaces Prebuilds**를 클릭하고 분기의 사전 빌드 워크플로 실행이 성공하는지 확인합니다. 워크플로의 최신 실행이 실패하고 이렇게 실패한 실행 중 하나 이상이 개발 컨테이너 구성에 대한 변경 내용을 포함하는 경우 연결된 분기에 대해 사용할 수 있는 사전 빌드가 없습니다.\n\n## 일부 리소스는 사전 빌드를 사용하여 만든 codespaces에서 액세스할 수 없습니다.\n\n사전 빌드 구성에 대한 `devcontainer.json` 구성 파일이 다른 리포지토리에 대한 액세스 권한이 필요하도록 지정하는 경우 리포지토리 관리자가 사전 빌드 구성을 만들거나 업데이트할 때 이러한 권한을 부여하라는 메시지가 표시됩니다. 관리자가 요청된 권한을 모두 부여하지 않으면 사전 빌드 및 이 사전 빌드에서 만든 codespaces에서 문제가 발생할 수 있습니다. 이 사전 빌드를 기반으로 codespace를 만드는 사용자가 이 작업을 수행하라는 메시지가 표시될 때 모든 권한을 \\_부여\\_하는 경우에도 마찬가지입니다.\n\n## 사전 빌드에 대한 실패한 워크플로 실행 문제 해결\n\n### GitHub Actions에 대한 지출 한도 증가\n\nGitHub Actions을(를) 사용하여 사전 빌드를 만들고 업데이트합니다. GitHub Actions의 시간(분)을 모두 사용하고 지출 한도에 도달한 경우 사전 빌드 워크플로가 실패합니다. 이 경우 워크플로를 실행할 수 있도록 GitHub Actions 지출 한도를 늘릴 수 있습니다. 자세한 내용은 [예산을 설정하여 요금제 제품에 대한 지출을 제어합니다.](/ko/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)을(를) 참조하세요.\n\n### 액세스 권한 부여\n\n사전 빌드 구성에 대한 `devcontainer.json` 구성 파일이 다른 리포지토리에 대한 액세스 권한이 필요하다는 것을 지정하도록 업데이트되었지만 저장소 관리자에게 사전 빌드 구성에 대한 이러한 사용 권한을 부여하라는 메시지가 표시되지 않은 경우 사전 빌드 워크플로가 실패할 수 있습니다. 변경하지 않고 사전 빌드 구성을 업데이트해 보세요.\n**업데이트**를 클릭하여 권한 부여 페이지가 표시되면 요청된 권한이 적절한지 확인하고, 적절하면 요청에 권한을 부여합니다. 자세한 내용은 [사전 빌드 관리](/ko/codespaces/prebuilding-your-codespaces/managing-prebuilds#editing-a-prebuild-configuration) 및 [Codespace 내의 다른 리포지토리에 대한 액세스 관리](/ko/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces#setting-additional-repository-permissions)을(를) 참조하세요.\n\n미리 빌드된 구성에 대한 워크플로 실행이 실패하는 경우 조사하는 동안 미리 빌드 구성을 일시적으로 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 [사전 빌드 관리](/ko/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration)을(를) 참조하세요.\n\n### 오래된 사전 빌드 사용 방지\n\n기본적으로 최신 사전 빌드 워크플로가 실패한 경우 동일한 리포지토리, 분기 및 `devcontainer.json` 구성 파일 조합에 대한 이전의 사전 빌드를 새 코드스페이스를 만드는 데 사용합니다. 이 동작을 사전 빌드 최적화라고 합니다.\n\n최신 사전 빌드를 사용할 수 없는 경우 코드스페이스를 빠르게 만들 수 있도록 하기 때문에 사전 빌드 최적화를 사용하도록 유지하는 것이 좋습니다. 그러나 리포지토리 관리자는 미리 빌드된 코드스페이스가 현재 분기 상태에 뒤처지는 문제가 발생하면, 사전 빌드 최적화를 비활성화할 수 있습니다. 사전 빌드 최적화를 사용하지 않도록 설정하면 최신 사전 빌드 워크플로가 실패했거나 현재 실행 중인 경우 관련된 리포지토리, 분기 및 `devcontainer.json` 파일 조합에 대한 코드스페이스가 사전 빌드 없이 만들어집니다.\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n\n2. 리포지토리 이름 아래에서 ** Settings**를 클릭합니다. \"설정\" 탭이 표시되지 않으면 **** 드롭다운 메뉴를 선택한 다음 **설정**을 클릭합니다.\n\n \n\n3. 사이드바의 \"Code & automation\" 섹션에서 ** Codespaces** 를 클릭합니다.\n\n4. 영향 받은 사전 빌드 구성 오른쪽에 있는 줄임표(**...**)를 선택하고 **편집**을 클릭합니다.\n\n \n\n5. \"구성 편집\" 페이지의 아래쪽으로 스크롤하고 **고급 옵션 표시**를 클릭합니다.\n\n \n\n6. 기본 설정을 사용하지 않도록 설정하려면 **사전 빌드 최적화 사용 안 함**을 선택합니다.\n\n \n\n7. 변경 내용을 저장하려면 **업데이트**를 클릭합니다.\n\n## 추가 참고 자료\n\n* [사전 빌드 구성](/ko/codespaces/prebuilding-your-codespaces/configuring-prebuilds)\n* [사전 빌드 관리](/ko/codespaces/prebuilding-your-codespaces/managing-prebuilds)"}