이 문서에서는 Artifact Registry에 적용되는 할당량 및 시스템 한도에 대해 설명합니다. 할당량은 사용할 수 있고 계수 가능한 공유 리소스의 양을 지정하며 Artifact Registry와 같은 Google Cloud 서비스에서 정의합니다. 시스템 한도는 변경할 수 없는 고정 값입니다.
Google Cloud는 공정성을 보장하고 리소스 사용 및 가용성의 급증을 줄이기 위해 할당량을 사용합니다. 할당량은 Google Cloud 프로젝트에서 사용할 수 있는 Google Cloud 리소스의 양을 제한합니다. 할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 다양한 리소스 유형에 적용됩니다. 예를 들어 할당량에 따라 서비스에 대한 API 호출 수, 프로젝트에서 동시에 사용하는 부하 분산기 수, 만들 수 있는 프로젝트 수가 제한될 수 있습니다. 할당량은 서비스 과부하를 방지하여 Google Cloud 사용자 커뮤니티를 보호합니다. 할당량은 자체 Google Cloud 리소스를 관리하는 데도 도움이 됩니다.
Cloud Quotas 시스템은 다음을 수행합니다.
- Google Cloud 제품 및 서비스 소비량 모니터링
- 리소스 소비 제한
- 할당량 값 변경을 요청할 수 있는 수단 제공
대부분의 경우 할당량이 허용하는 것보다 더 많은 리소스를 소비하려고 하면 시스템에서 리소스에 대한 액세스를 차단하고 수행하려는 작업이 실패합니다.
할당량은 일반적으로 Google Cloud 프로젝트 수준에서 적용됩니다. 한 프로젝트의 리소스를 사용해도 다른 프로젝트에서 사용 가능한 할당량에는 영향을 미치지 않습니다. Google Cloud 프로젝트 내에서 할당량은 모든 애플리케이션과 IP 주소에 공유됩니다.
Artifact Registry 리소스에도 시스템 한도가 있습니다. 시스템 한도는 변경할 수 없습니다.
Artifact Registry는 프로젝트 및 사용자 단위로 최대 수신 요청 비율을 제한하고 할당량을 적용합니다.
할당량 정책과 할당량 보기, 할당량 관리에 대한 자세한 내용은 할당량 작업을 참조하세요.
현재 API 활동을 보려면 API 대시보드로 이동하세요.
할당량
Artifact Registry에서 적용하는 할당량은 다음과 같습니다.
프로젝트당 요청 할당량
| 할당량 | 값 | 추가 정보 |
|---|---|---|
| 각 리전 또는 멀티 리전의 분당 요청 | 60,000 | |
| 각 리전 또는 멀티 리전의 분당 요청 | 18,000 | 대부분의 경우 단일 HTTP 요청 또는 API 호출은 단일 요청으로 계산됩니다. 그러나 일부 작업은 다중 요청으로 계산됩니다. 예를 들어 'ImportAptArtifacts'와 같은 배치 요청은 배치에 있는 각 항목에 대해 할당량을 부과할 수 있습니다. Docker 내보내기 또는 가져오기는 일반적으로 여러HTTP 요청을 일으키므로, 각 요청에 대해 할당량이 부과됩니다. |
| 각 리전 또는 멀티 리전의 분당 삭제 요청 | 18,000 | 삭제 정책에 의해 요청된 삭제는 삭제 요청 할당량과 저장소 한도당 일별 삭제 횟수에 포함됩니다. |
사용자당 요청 할당량
기본적으로 프로젝트의 사용자당 할당량은 무제한입니다. 원하는 경우 프로젝트 내에서 사용자당 할당량에 한도를 설정할 수 있습니다. 사용자당 할당량은 인증된 사용자별 또는 공개 저장소에 대한 비인증 요청의 클라이언트 IP 주소별로 적용됩니다.
Cloud KMS 할당량 및 Artifact Registry
Artifact Registry에서 CMEK를 사용하는 경우 프로젝트에서 Cloud KMS 암호화 요청 할당량을 사용할 수 있습니다. 예를 들어 CMEK로 암호화된 저장소는 각 업로드 또는 다운로드에 대해 이 할당량을 사용할 수 있습니다. CMEK 키를 사용하는 암호화 및 복호화 작업은 하드웨어(Cloud HSM) 또는 외부(Cloud EKM) 키를 사용하는 경우에만 Cloud KMS 할당량에 영향을 미칩니다. 애플리케이션 및 워크플로에 애플리케이션 레이어 보안 비밀 암호화를 사용 설정하기에 충분한 할당량이 있는지 확인합니다. 자세한 내용은 Cloud KMS 할당량을 참조하세요.
Artifact Analysis 할당량
사용 정책을 스캔하는 방법은 Artifact Analysis 할당량 및 한도를 참조하세요.
공개 업스트림 할당량
원격 저장소를 사용하여 공개 업스트림 저장소를 캐시하는 경우 업스트림 저장소의 읽기 및 쓰기 할당량이 적용될 수 있습니다.
사용량 한도
Artifact Registry에 적용되는 사용량 한도는 다음과 같습니다.
| 사용량 한도 | 값 |
|---|---|
| 저장소당 일별 삭제 정책 삭제 수 | 300,000 |
| 저장소당 삭제 정책 | 10 |
| 요청당 원격 저장소 업스트림의 최대 데이터 검색 수 | 9.9GB |
| 가상 저장소의 최대 업스트림 정책 | 30 |
| 가상 저장소의 요청당 최대 총 업스트림 해상도 수 | 250 |
| 가상 저장소의 요청당 최대 원격 저장소 업스트림 해상도 수 | 30 |
| 리전별 분당 저장소 생성 및 삭제 작업 | 30 |
원격 저장소 한도
원격 저장소에서 아티팩트를 요청할 때 아티팩트가 아직 원격 저장소에 캐시되지 않은 경우 아티팩트가 업스트림 저장소에서 요청된 다음 원격 저장소에 저장됩니다. 업스트림 호스트에 대한 요청은 조직의 업스트림 호스트 읽기 요청 한도에 반영되며 원격 저장소에서 아티팩트를 캐시하면 프로젝트의 쓰기 및 요청 할당량이 사용됩니다. 아티팩트가 원격 저장소로 캐시되면 이 아티팩트에 대한 요청은 프로젝트의 요청 할당량으로만 집계됩니다.
Artifact Registry는 원격 저장소에 다음과 같은 사용량 한도를 적용합니다.
| 한도 | 공개 업스트림 | 값 |
|---|---|---|
| 조직별, 리전별 분당 공개 업스트림 호스트 읽기 | 기본값 | 600 |
| Docker Hub | 600 | |
| Maven Central | 3000 | |
| NpmJS | 1800 | |
| PyPI | 1200 |
저장소의 아티팩트 나열 한도
모든 형식에 대한 형식별 API 요청은 10,000개로 제한됩니다. 예를 들어 저장소에 이미지 또는 태그가 10,000개를 초과한 경우 컨테이너 이미지를 나열하기 위한 Docker Registry API 메서드가 불완전한 목록을 반환합니다.
gcloud artifact docker images list 명령어 또는 Artifact Registry API 요청에는 제한사항이 적용되지 않습니다.
할당량 상향 조정 요청
대부분의 할당량을 조정하려면 Google Cloud 콘솔을 사용합니다. 자세한 내용은 할당량 조정 요청을 참고하세요.