할당량 및 한도

이 문서에서는 Cloud Build에 적용되는 할당량 및 한도를 설명합니다. 할당량은 사용할 수 있는 계수 가능한 공유 리소스의 양을 지정하며 Cloud Build와 같은 Google Cloud 서비스에서 정의됩니다. 시스템 한도는 변경할 수 없는 고정 값입니다.

Google Cloud는 공정성을 보장하고 리소스 사용 및 가용성의 급증을 줄이기 위해 할당량을 사용합니다. 할당량은 Google Cloud 프로젝트에서 사용할 수 있는 Google Cloud 리소스의 양을 제한합니다. 할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 다양한 리소스 유형에 적용됩니다. 예를 들어 할당량에 따라 서비스에 대한 API 호출 수, 프로젝트에서 동시에 사용하는 부하 분산기 수, 만들 수 있는 프로젝트 수가 제한될 수 있습니다. 할당량은 서비스 과부하를 방지하여 Google Cloud 사용자 커뮤니티를 보호합니다. 할당량은 자체 Google Cloud 리소스를 관리하는 데도 도움이 됩니다.

Cloud Quotas 시스템은 다음을 수행합니다.

  • Google Cloud 제품 및 서비스 소비량 모니터링
  • 리소스 소비 제한
  • 할당량 값 변경을 요청할 수 있는 수단 제공

대부분의 경우 할당량이 허용하는 것보다 더 많은 리소스를 소비하려고 하면 시스템에서 리소스에 대한 액세스를 차단하고 수행하려는 작업이 실패합니다.

할당량은 일반적으로 Google Cloud 프로젝트 수준에서 적용됩니다. 한 프로젝트의 리소스를 사용해도 다른 프로젝트에서 사용 가능한 할당량에는 영향을 미치지 않습니다. Google Cloud 프로젝트 내에서 할당량은 모든 애플리케이션과 IP 주소에 공유됩니다.

대부분의 할당량을 조정하려면 Google Cloud 콘솔을 사용합니다. 자세한 내용은 할당량 조정 요청을 참고하세요.

Cloud Build 리소스에도 시스템 한도가 있습니다. 시스템 한도는 변경할 수 없습니다.

할당량

Cloud Build는 다양한 이유로 빌드 실행에 할당량을 적용합니다. 예를 들어 할당량은 사용량이 예기치 않게 급증하는 것을 방지하여 Google Cloud 사용자 커뮤니티를 보호하는 데 도움이 됩니다. Google Cloud에서는 프로젝트를 제한적으로 이용할 수 있는 무료 체험판 할당량도 제공하므로 무료로 Google Cloud를 살펴볼 수 있습니다.

다음 Cloud Build 할당량이 각 Google Cloud 프로젝트에 기본으로 적용됩니다. 하지만 프로젝트당 할당량은 사용량과 시간에 따라 달라질 수 있습니다.

리소스 설명 기본 한도 상향 가능성 범위
비공개 풀 비공개 풀 수 2~10 예 지역별
CPU 동시 CPU 수

리전 비공개 풀에서 실행

 0 * - 2400 예. 이 할당량이 차면 추가 CPU 요청이 큐에 추가되며 순차적으로 처리됩니다. 지역별
CPU 동시 CPU 수

리전 기본 풀에서 실행

 5 - 100 아니요. 동시 CPU가 100개 이상 필요하면 비공개 풀을 사용합니다. 지역별
요청 전역 기본 풀에서 실행되는
동시 빌드 수 		10 - 30 아니요. 동시 빌드를 30개 이상
실행하려면 비공개 풀을
사용하는 것이 좋습니다.		 전역

* 프로젝트 및 사용량에 따라 비공개 풀을 사용하기 위한 할당량이 없을 수도 있습니다. 이 경우 기본 풀을 사용할 수 있습니다.

일부 프로젝트의 리전 제한사항

사용량에 따라 특정 프로젝트는 특정 리전에서만 Cloud Build를 사용하도록 제한될 수 있습니다. 자세한 내용은 위치를 참조하세요.

API 비율 제한

API 비율 제한은 Cloud Build API를 호출할 수 있는 비율에 영향을 줍니다. 할당량 페이지로 이동하여 API 비율 제한을 보고 수정할 수 있습니다.

리소스 한도

Cloud Build는 리소스에 다음 한도를 적용합니다.

한도
빌드당 빌드 단계 300
빌드 단계 이름의 길이 1,000자(영문 기준)
빌드 단계당 env 값 100
env 값의 길이 65,536자(영문 기준)
빌드 단계당 args 값 100
arg 값의 길이 10,000자
dir 값의 길이 1,000자(영문 기준)
빌드당 빌드된 이미지 700
빌드당 고유한 secretEnv 값 100
secret 크기 65,536자(영문 기준)
빌드 트리거 수 300
빌드당 아티팩트 경로 수 100
빌드당 태그 목록 길이 64

할당량 늘리기

  1. Cloud Build 할당량 페이지를 엽니다.

    할당량으로 이동

  2. 수정하려는 할당량을 선택하고 할당량 수정을 클릭합니다.

  3. 선택한 할당량에 대해 새 할당량 한도를 입력합니다.

  4. 요청 제출을 클릭합니다.