# 작업 제한
확장할 때 부딪힐 수 있는 GitHub Actions 제한이 있으며, 일부는 지원에 문의하여 늘릴 수 있습니다.
GitHub Actions에 의해 사용량 조정 시 속도가 제한될 수 있습니다.
사이트 관리자가 [GitHub 지원 포털](https://support.github.com)에 문의하여 일부 제한을 늘릴 수 있습니다.
달리 명시되지 않는 한, 제한에 도달하면 워크플로/작업이 취소되는 것이 예상 동작입니다.
제한은 변경될 수 있습니다.
## 기존 시스템 제한
| 제한 범주 | 제한 | Threshold | 설명 | 지원이 증가할 수 있나요 GitHub ? |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 워크플로 실행 제한 | 워크플로 실행 시간 | 35일/워크플로 실행 | 워크플로 실행이 이 제한에 도달하면 워크플로 실행이 취소됩니다. 이 기간에는 실행 시간과 대기 및 승인에 소요된 시간이 포함됩니다. | |
| 워크플로 실행 제한 | 게이트 승인 시간 | 30일 | 워크플로는 환경 승인에 대해 최대 [30일](/ko/enterprise-cloud@latest/actions/reference/workflows-and-actions/deployments-and-environments#wait-timer)까지 대기할 수 있습니다. | |
| 워크플로 실행 제한 | 작업 행렬 | 256개 작업/워크플로 실행 | 작업 매트릭스는 워크플로 실행당 최대 256개의 작업을 생성할 수 있습니다. 이 제한은 GitHub-호스트 실행기와 자체 호스트 실행기 모두에 적용됩니다. | |
| 워크플로 실행 제한 | 다시 실행 | 50회 다시 실행 | 워크플로 실행을 최대 50회 다시 실행할 수 있습니다. 이 제한에는 작업의 하위 집합에 대한 전체 다시 실행 및 다시 실행이 모두 포함됩니다. | |
| 지원 티켓 | | | | |
| 워크플로 파일 | 워크플로 파일 크기 | 파일당 500KB | 500KB보다 큰 워크플로 파일은 실행을 시작하지 않습니다. | |
| [워크플로 파일 크기를 참조하세요](#workflow-file-size). | | | | |
| 수표 | Check Suite의 실행 수 확인 | 체크 실행 50,000회 / 체크 도구 모음 50,000개 | Check Suite는 최대 50,000개의 검사 실행을 가질 수 있습니다. 이 제한은 Checks API 및 GitHub Actions 워크플로 실행을 통해 만든 검사 실행에 적용됩니다. 검사 도구 모음이 이 제한에 도달하면 해당 검사 도구 모음에 대해 추가 검사 실행을 만들 수 없습니다. | |
| 지원 티켓 | | | | |
| 워크플로 대기열 | 워크플로 트리거 이벤트 속도 제한 | 1500개 이벤트/10초/리포지토리 | 각 저장소는 워크플로 실행을 트리거하는 이벤트 수에 제한이 있습니다. | |
| 지원 티켓 | | | | |
| 워크플로 대기열 | 워크플로 실행 대기 | 500개의 워크플로 실행/10초 | 제한에 도달하면 웹후크 이벤트로 트리거될 예정이었던 워크플로 실행이 차단되며 대기열에 추가되지 않습니다. 재사용 가능한 워크플로는 하나의 단일 항목으로 간주됩니다. 예를 들어, 30개의 재사용 가능한 워크플로를 포함한 실행도 이 경우에는 1로 계산됩니다. | |
| | | | | |
| 워크플로 대기열 | 동시성 그룹 큐 | 100개의 워크플로 실행/동시성 그룹 | | |
| `queue: max` 섹션에서 `concurrency`를 사용할 때, 동시성 그룹당 최대 100개의 작업 또는 워크플로 실행을 큐에 대기할 수 있습니다. 이 제한을 초과하는 실행은 거부됩니다. | | | | |
| | | | | |
| 자체 호스팅 | 실행기 등록 | 1500개의 실행기/5분/리포지토리/조직/엔터프라이즈 | 실행기는 리포지토리/조직/엔터프라이즈 단위로 등록할 수 있습니다. | |
| 지원 티켓 | | | | |
| 자체 호스팅 | 실행기 그룹당 실행기 수 | 실행기 10,000개 | 실행기 그룹당 동시에 등록된 실행기 수. | |
| 자체 호스팅 | 작업 실행 시간 | 5일 | 워크플로의 각 작업은 최대 5일 동안 실행될 수 있습니다. 작업이 이 한도에 도달하면 작업이 종료되며 실패로 처리됩니다. | |
| 자체 호스팅 | 작업 큐 시간 | 24시간 | 작업은 자동으로 취소되기 전 최대 24시간 동안 대기열에 있을 수 있습니다. | |
| 모든 GitHub호스팅 러너 상세 정보 | 작업 동시성 | 다양함 | | |
| [호스팅된 실행기용 GitHub작업 동시성 제한을 참조하세요](#job-concurrency-limits-for-github-hosted-runners). | | | | |
| 지원 티켓 | | | | |
| 모든 GitHub호스팅 러너 상세 정보 | 작업 실행 시간 | 6시간 | 워크플로의 각 작업은 최대 6시간 동안 실행될 수 있습니다. 작업이 이 한도에 도달하면 작업이 종료되며 실패로 처리됩니다. | |
| | | | | |
| 모든 GitHub호스팅 러너 상세 정보 | 스토리지 제한 | 다양함 | 자세한 내용은 [모든 GitHub호스팅된 실행기 스토리지 제한을 참조하세요](#storage-limits-for-all-github-hosted-runners). | |
| | | | | |
| 더 큰 실행기 | 실행기당 동시성 제한 | 실행기 유형에 따라 다름 | 실행기 설정 시 구성됩니다. 일반적으로 Linux CPU 실행기는 최대 1,000개지만, 유형에 따라 다를 수 있습니다. | |
| [호스팅된 실행기용 GitHub작업 동시성 제한을 참조하세요](#job-concurrency-limits-for-github-hosted-runners). | | | | |
| 지원 티켓 | | | | |
| 더 큰 실행기 | 고정 IP 제한 | 10개의 IP | 엔터프라이즈 및 조직당 10 IP. | |
| 지원 티켓 | | | | |
| 더 큰 실행기 | VNet 주입을 위한 사설 IP 확장 | 30% Buffer | 예상되는 최대 작업 동시 실행 수를 수용할 수 있는 버퍼가 필요합니다. | |
| [대형 러너의 가상 네트워크 삽입을 위한 프라이빗 IP 크기 조정](#private-ip-scaling-for-vnet-injection-on-larger-runners)을 참조하세요. | | | | |
| 구성 가능한 Azure 가상 네트워크 | | | | |
| 종속성 캐싱 | 분당 업로드 | 분당 200개 | 각 리포지토리는 분당 200개의 캐시 항목 업로드로 제한됩니다. 이 제한을 초과하면 속도 제한이 다시 설정될 때까지 후속 캐시 업로드 시도가 실패합니다. | |
| 종속성 캐싱 | 분당 다운로드 수 | 분당 1500 | 각 리포지토리는 분당 1,500개의 캐시 항목 다운로드로 제한됩니다. 이 제한을 초과하면 속도 제한이 다시 설정될 때까지 후속 캐시 다운로드 시도가 실패합니다. | |
| 종속성 캐싱 | 분당 삭제 | 분당 400 | 각 리포지토리는 분당 400개의 캐시 삭제 작업으로 제한됩니다. 이 제한을 초과하면 속도 제한이 다시 설정될 때까지 후속 캐시 삭제 시도가 실패합니다. 키 또는 ID별로 캐시를 삭제하는 각 요청은 이 제한에 포함됩니다. | |
### 워크플로 파일 크기
실행을 트리거하려면 디렉터리의 각 워크플로 파일 `.github/workflows` 은 500KB 이상이어야 합니다. 워크플로 파일의 크기를 줄이려면 공유 논리를 재사용 가능한 워크플로 또는 복합 작업으로 이동합니다.
[워크플로 재사용](/ko/enterprise-cloud@latest/actions/how-tos/reuse-automations/reuse-workflows) 또는 [복합 작업 만들기](/ko/enterprise-cloud@latest/actions/tutorials/create-actions/create-a-composite-action)을(를) 참조하세요.
### GitHub호스팅 러너 작업 동시성 제한
GitHub지원은 \*\*\*\* 작업 동시성 제한을 GitHub Actions. 증가를 요청하려면 지원 티켓을 제출하십시오.
\| 실행기 유형 |
GitHub 계획 | 총 동시 작업 수 | 최대 동시 macOS 작업 수 | 최대 동시 GPU 작업 |
\|---|---|---|---|---|
\| 표준 GitHub호스팅 러너 | 무료 | 20 | 5 | 해당 없음 |
\| 표준 GitHub호스팅 러너 | Pro | 40 | 5 | 해당 없음 |
\| 표준 GitHub호스팅 러너 | Team | 60 | 5 | 해당 없음 |
\| 표준 GitHub호스팅 러너 | Enterprise | 500 | 50 | 해당 없음 |
\| 더 큰 실행기 | Team | 1000 | 5 | 100 |
\| 더 큰 실행기 | Enterprise | 1000 | 50 | 100 |
> \[!NOTE]
> 최대 동시 macOS 작업은 표준 GitHub호스팅된 실행기 및 GitHub호스팅된 더 큰 실행기 간에 공유됩니다.
### 모든 GitHub에서 호스팅되는 러너의 스토리지 제한
GitHub지원은 에 대한 \*\*\*\* 스토리지 제한을 늘릴 GitHub Actions.
| Plan | 아티팩트 스토리지 | 분(월별) | 캐시 스토리지(리포지토리당) | 사용자 지정 이미지 스토리지 |
| ----------------------- | --------- | ------ | --------------- | --------------- |
| GitHub Free | 500MB | 2,000 | 10GB | 적용할 수 없음 |
| GitHub Pro | 1GB | 3,000 | 10GB | 적용할 수 없음 |
| GitHub Free 조직용 | 500MB | 2,000 | 10GB | 적용할 수 없음 |
| GitHub Team | 2GB | 3,000 | 10GB | 75GB |
| GitHub Enterprise Cloud | 50GB | 50,000 | 10GB | 150GB |
캐시 스토리지 제한 및 이를 늘리는 방법에 대한 자세한 내용은 [사용 제한 및 제거 정책을](/ko/enterprise-cloud@latest/actions/reference/workflows-and-actions/dependency-caching#usage-limits-and-eviction-policy) 참조하세요.
### 대형 실행기에서 VNet 주입용 프라이빗 IP 확장
대형 실행기에서 VNet 주입을 사용할 때는 적절한 서브넷 IP 주소 범위를 결정해야 하며, 예상되는 최대 작업 동시 실행 수에 여유분을 추가하는 것을 권장합니다. 예를 들어, 네트워크 구성의 실행기 최대 작업 동시 실행 수가 300으로 설정된 경우, 최소 390개의 실행기를 수용할 수 있는 서브넷 IP 주소 범위를 사용해야 합니다. Azure 모든 서브넷(처음 4 및 마지막 1)에 5개의 IP를 예약합니다. 이는 실행기 요구 사항에 따라 최소 실용적인 서브넷 크기를 설정합니다. 매우 작은 서브넷(/29 이하)은 필요한 만큼의 사용 가능한 주소를 제공하지 못할 수 있습니다.
## 자주 초과되는 종속 서비스 한도
GitHub' [REST API 속도 제한은](/ko/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api) 사용자에게 적용 GitHub Actions 되며, 일반적으로 적중되는 제한은 다음과 같습니다.
* **인증되지 않은 사용자**-퍼블릭 데이터만 가져오는 경우 인증되지 않은 요청을 수행할 수 있습니다. 인증되지 않은 요청은 요청을 한 사용자 또는 애플리케이션이 아닌 발신 IP 주소와 연결됩니다.
인증되지 않은 요청에 대한 기본 트래픽률 제한은 시간당 60개입니다.
* **인증된 사용자**-personal access token을(를) 사용하여 API 요청을 수행할 수 있습니다. 또한, 사용자를 대신하여 API 요청을 수행할 수 있는 GitHub App 또는 OAuth app을(를) 승인할 수도 있습니다.
이러한 모든 요청은 시간당 요청 5,000개의 개인 트래픽률 제한에 포함됩니다. GitHub Enterprise Cloud 조직이 소유한 GitHub App이(가) 사용자를 대신하여 요청하는 요청에는 시간당 15,000개의 더 높은 트래픽률 제한이 적용됩니다. 마찬가지로, OAuth app이(가) 소유하거나 승인한 경우, GitHub Enterprise Cloud 조직의 구성원이라면 해당 앱이 대신으로 수행한 요청은 시간당 15,000건까지 처리 가능한 더 높은 요청 제한이 적용됩니다. 그러나 더 높은 제한 앱의 요청은 하한 인증 방법에 사용할 수 있는 나머지 예산을 줄입니다. 예를 들어, 요청 한도가 15,000개인 앱이 사용자를 대신하여 10,000개의 요청을 하면, 앱에 5,000개의 요청이 남아 있더라도 personal access tokens에 대한 5,000개 요청의 할당량이 소진됩니다.
* **GitHub 앱 설치**-설치 액세스 토큰으로 인증하는 GitHub Apps은(는) 설치의 최소 트래픽률 제한인 시간당 5,000개 요청을 사용합니다. GitHub Enterprise Cloud 조직 또는 엔터프라이즈에 설치된 경우 설치의 트래픽률 제한은 시간당 15,000개 요청입니다.
GitHub Enterprise Cloud 조직 또는 엔터프라이즈 외에 설치된 경우 설치의 트래픽률 제한은 사용자 및 리포지토리 수에 따라 조정됩니다. 리포지토리가 20개를 초과하는 설치는 각 리포지토리에 대해 시간당 50개의 요청을 추가로 받습니다. 사용자 수가 20명을 초과하는 조직에 대한 설치의 경우 각 사용자에 대해 시간당 50개의 요청을 추가로 수신할 수 있습니다. 트래픽률 제한은 시간당 12,500개 요청을 초과할 수 없습니다.
GitHub App 사용자 액세스 토큰에 대한 기본 트래픽률 제한은(설치 액세스 토큰과는 달리) 인증된 사용자의 기본 트래픽률 제한에 따라 결정됩니다. 이 트래픽률 제한은 해당 사용자를 대신하여 다른 GitHub App 또는 OAuth app이(가) 수행하는 모든 요청 및 사용자가 personal access token(으)로 수행하는 모든 요청과 합산됩니다. 자세한 내용은 [REST API에 대한 트래픽률 제한](/ko/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#primary-rate-limit-for-authenticated-users)을(를) 참조하세요.
* \*\*OAuth 앱 -\*\*이러한 요청의 경우 트래픽률 제한은 OAuth app당 시간당 5,000개 요청입니다. GitHub Enterprise Cloud 조직이 소유한 앱의 경우 트래픽률 제한은 시간당 15,000개 요청입니다.
* **GITHUB 토큰**-`GITHUB_TOKEN`에 대한 트래픽률 제한은 리포지토리당 시간당 1,000개 요청입니다. GitHub Enterprise Cloud 계정에 속한 리소스에 대한 요청의 경우, 제한은 리포지토리당 시간당 15,000개 요청입니다.
* **보조 속도 제한**- 기본 속도 제한 외에도 남용 GitHub 을 방지하고 모든 사용자가 사용할 수 있는 API를 유지하기 위해 보조 속도 제한을 적용합니다. 이러한 제한은 GHEC에서 구성할 수 없습니다. 자세한 내용은 [REST API에 대한 트래픽률 제한](/ko/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api?apiVersion=2022-11-28#about-secondary-rate-limits)을(를) 참조하세요.
### Docker Hub의 GitHub Actions 속도 제한
* **GitHub호스팅 러너의 퍼블릭 이미지 풀링:** Docker Hub 속도 제한은 적용되지 않습니다.
* **GitHub 호스팅 러너의 프라이빗 이미지 풀링:** Docker Hub 프라이빗 이미지를 풀링하는 속도 제한이 적용됩니다.
* **공용 또는 비공개 이미지를 가져오는 자체 호스팅 러너:** Docker Hub에서 이미지를 가져오는 행위는 항상 속도 제한의 영향을 받습니다.