[GCP] Quota 'CPUS_PER_VM_FAMILY' exceeded

[yunkon-kim]

Quota 'CPUS_PER_VM_FAMILY' exceeded when creating a VM infra in asia-northeast on GCP.

Environment

• CM-Beetle v0.3.1+
• CB-Tumblebug v0.11.2+
• CB-Spider V0.11.1

Spec

• n4-standard-2

cb-tumblebug             | 6:31AM INF src/core/infra/provisioning.go:1600 > VM request body to CB-Spider
cb-tumblebug             | {
cb-tumblebug             |   "ConnectionName": "gcp-asia-northeast3",
cb-tumblebug             |   "ReqInfo": {
cb-tumblebug             |     "Name": "d29fdgnja4cgnmskpj1g",
cb-tumblebug             |     "ImageName": "https://www.googleapis.com/compute/v1/projects/ubuntu-os-cloud/global/images/ubuntu-2204-jammy-v20250722",
cb-tumblebug             |     "VPCName": "d29fakvja4cgnmskpiug",
cb-tumblebug             |     "SubnetName": "d29fakvja4cgnmskpiv0",
cb-tumblebug             |     "SecurityGroupNames": [
cb-tumblebug             |       "d29fatvja4cgnmskpj00"
cb-tumblebug             |     ],
cb-tumblebug             |     "KeyPairName": "d29fatnja4cgnmskpivg",
cb-tumblebug             |     "CSPid": "",
cb-tumblebug             |     "DataDiskNames": null,
cb-tumblebug             |     "VMSpecName": "n4-standard-2",
cb-tumblebug             |     "VMUserId": "",
cb-tumblebug             |     "VMUserPasswd": "14f2!davd9A$gj",
cb-tumblebug             |     "RootDiskType": "",
cb-tumblebug             |     "RootDiskSize": "",
cb-tumblebug             |     "ImageType": ""
cb-tumblebug             |   }
cb-tumblebug             | }
cb-spider                | [CB-SPIDER].[ERROR]: 2025-08-06 06:31:58 VMHandler.go:516, github.com/cloud-barista/cb-spider/cloud-control-manager/cloud-driver/drivers/gcp/resources.(*GCPVMHandler).StartVM() - Operation error: Quota 'CPUS_PER_VM_FAMILY' exceeded.  Limit: 0.0 in region asia-northeast3. 
cb-spider                | [CB-SPIDER].[ERROR]: 2025-08-06 06:31:58 VMManager.go:633, github.com/cloud-barista/cb-spider/api-runtime/common-runtime.StartVM() - Operation errors: Quota 'CPUS_PER_VM_FAMILY' exceeded.  Limit: 0.0 in region asia-northeast3. 
cb-tumblebug             | 6:31AM ERR src/core/infra/provisioning.go:1630 > error="Error from Spider while creating VM: [Error from: http://cb-spider:1024/spider/vm] Status code: 500 Internal Server Error, Message: {\"message\":\"Operation errors: Quota 'CPUS_PER_VM_FAMILY' exceeded.  Limit: 0.0 in region asia-northeast3.\"}\n"
cb-tumblebug             | 6:31AM DBG src/core/infra/provisioning.go:827 > [MCI has been created]mmci01
cb-tumblebug             | 6:31AM DBG src/core/common/label/label.go:193 > labelData is empty
cb-tumblebug             | 6:31AM INF src/interface/rest/server/middlewares/zerologger.go:59 > request ID=1754461890817739127 Method=POST URI=/tumblebug/ns/mig01/mci clientIP=172.21.0.6 latency=28.819007925s status=200
cm-beetle                | 6:31AM DBG pkg/client/tumblebug/mci.go:59 > Created MCI successfully

(cc. @powerkimhub)

[yunkon-kim]

ref) https://cloud.google.com/compute/docs/general-purpose-machines?hl=ko#n4-standard

머신 유형	vCPUs*	메모리(GB)	기본 이그레스 대역폭(Gbps)	Tier_1 이그레스 대역폭(Gbps)
n4-standard-2	2	8	최대 10	해당 사항 없음
n4-standard-4	4	16	최대 10	해당 사항 없음
n4-standard-8	8	32	최대 16	해당 사항 없음
n4-standard-16	16	64	최대 32	해당 사항 없음
n4-standard-32	32	128	최대 32	해당 사항 없음
n4-standard-48	48	192	최대 32	해당 사항 없음
n4-standard-64	64	256	최대 45	해당 사항 없음
n4-standard-80	80	320	최대 50	해당 사항 없음

[powerkimhub]

• GCP Quota 특이사항

  • 대상 자원이 관리 되는 Pool Type(Shared pool or Separate pool)에 따라 Default Quota가 다름
    • Shared pool: 8~24 CPUs, N1, E2 등
    • Separate pool: 0 CPUs, M1, M2, M3, N4 등
  • default Quota limit이 0인 경우에는 Quota 관리에 Quota가 표시 되지 않다가
    • 최초 생성 요청시 Quota limit 정보가 생성됨(즉, 한번도 생성 요청하지 않은 Region에서는 N4 Quota 정보가 없음)
    • 이때 최초 VM 생성 요청은 Quota가 0이기 때문에 fail 됨

• GCP Quota 상향 신청은 Project별 콘솔에서 신청 가능

  • Quota 상향 후 진행해보시기 바랍니다.

• 이하 참고

1. 기본 개념

• GCP의 vCPU 쿼터(CPUs per VM family)는 **두 가지 풀(Pool)**로 나눠서 관리됩니다.

  1. Shared pool

     • 여러 VM 패밀리(E2, N2, N2D 등)에서 공유하는 vCPU 쿼터

     • 보통 신규 프로젝트는 여기서 기본 quota가 부여됨 (예: 8~24 vCPU)

  2. Separate pool

     • 특정 VM 패밀리(M1, M2, M3, N4, C2, A2 등) 전용 쿼터

     • shared pool과 별도로 관리되며, 기본 quota는 대부분 0에서 시작

     • 필요 시 별도 요청해야 사용 가능

---

2. Default quota limit와의 관계

• Shared pool에 속한 VM 패밀리 → default quota limit이 0이 아님 (기본적으로 몇 vCPU 사용 가능)

• Separate pool에 속한 VM 패밀리 → default quota limit이 0 (쿼터 요청 없이는 사용 불가)

• 이 때문에 신규 프로젝트에서 M1, M2, M3, N4 VM을 만들면 바로 CPUs per VM family exceeded 오류가 납니다.

---

3. 예시

VM 패밀리	Pool 종류	신규 프로젝트 기본 quota (예시)	특징
E2	Shared	8~24 vCPU	여러 시리즈와 공유
N4	Separate	0 vCPU	쿼터 요청 필요

[기타] E2와 M4는 Quota Name도 다름

• E2: CPUS
• M4: CPUS_PER_VM_FAMILY(CPUs per VM family)

• ref) https://cloud.google.com/compute/resource-usage