비공개 풀 구성 파일 스키마

비공개 풀 구성 파일(비공개 풀 구성 파일)에는 사양에 따라 비공개 풀을 만드는 Cloud Build 지침이 포함됩니다. 비공개 풀 구성 파일에는 비공개 풀에 사용할 디스크 크기 및 머신 유형과 같은 정보가 포함되어 있습니다. gcloud 도구 또는 Cloud Build API를 사용하여 비공개 풀을 만들고 관리하는 경우 비공개 풀 구성 파일이 필요합니다.

비공개 풀 구성 파일의 구조

YAML 또는 JSON 구문을 사용하여 비공개 풀 구성 파일을 작성할 수 있습니다. curl을 사용하여 비공개 풀을 만들고 관리하려면 비공개 풀 구성 파일을 JSON 형식으로 작성합니다. gcloud 도구를 사용하여 비공개 풀을 만들고 관리하려면 YAML 또는 JSON 형식으로 비공개 풀 구성 파일을 작성하세요.

비공개 풀 구성 파일의 구조는 다음과 같습니다.

YAML

privatePoolV1Config:
  networkConfig:
    egressOption: NO_PUBLIC_EGRESS
    peeredNetwork: PEERED_NETWORK
  workerConfig:
    diskSizeGb: 'PRIVATE_POOL_DISK_SIZE'
    machineType: PRIVATE_POOL_MACHINE_TYPE

JSON

{
  "privatePoolV1Config": {
    "networkConfig": {
      "egressOption": "NO_PUBLIC_EGRESS",
      "peeredNetwork": "PEERED_NETWORK"
    },
    "workerConfig": {
      "diskSizeGb": "PRIVATE_POOL_DISK_SIZE",
      "machineType": "PRIVATE_POOL_MACHINE_TYPE"
    }
  }
}

비공개 풀 구성 파일의 필드는 아래에 설명되어 있습니다.

networkConfig

이 입력란은 선택 사항입니다. 서비스 제작자 네트워크와 VPC 네트워크를 피어링하는 경우에만 networkConfig를 지정합니다.

egressOption

이 입력란은 선택 사항입니다. VPC 서비스 제어 경계 내에 비공개 풀을 만드는 경우 이 필드의 값을 NO_PUBLIC_EGRESS로 설정합니다. 비공개 풀 구성 파일에 이 필드를 포함하지 않으면 공개 이그레스가 사용 설정됩니다. 비공개 풀의 VPC 서비스 제어 설정에 대한 자세한 내용은 VPC 서비스 제어 사용을 참조하세요.

peeredNetwork

비공개 풀 구성 파일에 networkConfig 필드가 포함된 경우 필수 필드입니다. 이 필드의 값을 서비스 제작자 네트워크와 피어링된 VPC 네트워크의 네트워크 리소스 URL로 설정합니다. 네트워크 리소스 URL은 projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME 형식이어야 합니다. 여기서 NETWORK_PROJECT_ID는 VPC 네트워크를 보유한 Cloud 프로젝트의 프로젝트 ID이고 NETWORK_NAME은 VPC 네트워크의 이름입니다. 값을 지정하지 않으면 Cloud Build는 기본적으로 서비스 제작자 네트워크를 사용합니다.

workerConfig

필수 입력란입니다. 여기에는 비공개 풀의 구성 옵션이 포함되어 있습니다.

diskSizeGb

이 입력란은 선택 사항입니다. 이 필드를 사용하여 비공개 풀 인스턴스의 디스크 크기를 GB 단위로 지정합니다. 100 이상이고 1,000 이하인 값을 지정합니다. 비공개 풀 구성 파일에 이 필드를 포함하지 않거나 0을 이 필드의 값으로 지정하면 Cloud Build가 기본값 100을 사용합니다.

machineType

이 입력란은 선택 사항입니다. 이 필드를 사용하여 비공개 풀 인스턴스의 Compute Engine 머신 유형을 지정합니다. 다음 머신 유형 중 하나를 지정합니다.

+ `e2-medium`
+ `e2-standard-2`
+ `e2-standard-4`
+ `e2-standard-8`
+ `e2-standard-16`
+ `e2-standard-32`
+ `e2-highmem-2`
+ `e2-highmem-4`
+ `e2-highmem-8`
+ `e2-highmem-16`
+ `e2-highmem-32`
+ `e2-highcpu-2`
+ `e2-highcpu-4`
+ `e2-highcpu-8`
+ `e2-highcpu-16`
+ `e2-highcpu-32`

값을 지정하지 않으면 Cloud Build는 기본값인 e2-medium을 사용합니다.

다음 단계