プライベート プールの構成ファイルのスキーマ

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

プライベート プール構成ファイル(プライベート プール構成ファイル)には、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

このフィールドは省略できます。 networkConfig は、VPC ネットワークをサービス プロデューサー ネットワークとピアリングする場合にのみ指定します。

egressOption

このフィールドは省略できます。 VPC Service Controls の境界内にプライベート プールを作成する場合は、このフィールドの値を NO_PUBLIC_EGRESS に設定します。プライベート プール構成ファイルにこのフィールドを含めない場合、公開下りが有効になります。プライベート プール用の VPC Service Controls の設定については、VPC Service Controls の使用をご覧ください。

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-highcpu-2`
+ `e2-highcpu-4`
+ `e2-highcpu-8`
+ `e2-highcpu-16`
+ `e2-highcpu-32`

値を指定しない場合、Cloud Build はデフォルト値の e2-medium を使用します。

次のステップ