Reference documentation and code samples for the Google Cloud Functions V2 Client class BuildConfig.
Describes the Build step of the function that builds a container from the given source.
Generated from protobuf message google.cloud.functions.v2.BuildConfig
Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ build
string
Output only. The Cloud Build name of the latest successful deployment of the function.
↳ runtime
string
The runtime in which to run the function. Required when deploying a new function, optional when updating an existing function. For a complete list of possible choices, see the gcloud
command reference
.
↳ entry_point
string
The name of the function (as defined in source code) that will be executed. Defaults to the resource name suffix, if not specified. For backward compatibility, if function with given name is not found, then the system will try to use function named "function". For Node.js this is name of a function exported by the module specified in source_location
.
↳ source
↳ source_provenance
↳ worker_pool
string
Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is projects/{project}/locations/{region}/workerPools/{workerPool}
where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool. If the project id is not the same as the function, then the Cloud Functions Service Agent (service-<project_number>@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role Cloud Build Custom Workers Builder (roles/cloudbuild.customworkers.builder) in the project.
↳ environment_variables
array| Google\Protobuf\Internal\MapField
User-provided build-time environment variables for the function
↳ docker_registry
int
Optional. Docker Registry to use for this deployment. This configuration is only applicable to 1st Gen functions, 2nd Gen functions can only use Artifact Registry. If docker_repository
field is specified, this field will be automatically set as ARTIFACT_REGISTRY
. If unspecified, it currently defaults to CONTAINER_REGISTRY
. This field may be overridden by the backend for eligible deployments.
↳ docker_repository
string
User managed repository created in Artifact Registry optionally with a customer managed encryption key. This is the repository to which the function docker image will be pushed after it is built by Cloud Build. If unspecified, GCF will create and use a repository named 'gcf-artifacts' for every deployed region. It must match the pattern projects/{project}/locations/{location}/repositories/{repository}
. Cross-project repositories are not supported. Cross-location repositories are not supported. Repository format must be 'DOCKER'.
getBuild
Output only. The Cloud Build name of the latest successful deployment of the function.
string
setBuild
Output only. The Cloud Build name of the latest successful deployment of the function.
var
string
$this
getRuntime
The runtime in which to run the function. Required when deploying a new
function, optional when updating an existing function. For a complete
list of possible choices, see the gcloud
command
reference
.
string
setRuntime
The runtime in which to run the function. Required when deploying a new
function, optional when updating an existing function. For a complete
list of possible choices, see the gcloud
command
reference
.
var
string
$this
getEntryPoint
The name of the function (as defined in source code) that will be executed. Defaults to the resource name suffix, if not specified. For backward compatibility, if function with given name is not found, then the system will try to use function named "function".
For Node.js this is name of a function exported by the module specified
in source_location
.
string
setEntryPoint
The name of the function (as defined in source code) that will be executed. Defaults to the resource name suffix, if not specified. For backward compatibility, if function with given name is not found, then the system will try to use function named "function".
For Node.js this is name of a function exported by the module specified
in source_location
.
var
string
$this
getSource
The location of the function source code.
hasSource
clearSource
setSource
The location of the function source code.
$this
getSourceProvenance
Output only. A permanent fixed identifier for source.
hasSourceProvenance
clearSourceProvenance
setSourceProvenance
Output only. A permanent fixed identifier for source.
$this
getWorkerPool
Name of the Cloud Build Custom Worker Pool that should be used to build the
function. The format of this field is projects/{project}/locations/{region}/workerPools/{workerPool}
where
{project} and {region} are the project id and region respectively where the
worker pool is defined and {workerPool} is the short name of the worker
pool.
If the project id is not the same as the function, then the Cloud Functions Service Agent (service-<project_number>@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role Cloud Build Custom Workers Builder (roles/cloudbuild.customworkers.builder) in the project.
string
setWorkerPool
Name of the Cloud Build Custom Worker Pool that should be used to build the
function. The format of this field is projects/{project}/locations/{region}/workerPools/{workerPool}
where
{project} and {region} are the project id and region respectively where the
worker pool is defined and {workerPool} is the short name of the worker
pool.
If the project id is not the same as the function, then the Cloud Functions Service Agent (service-<project_number>@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role Cloud Build Custom Workers Builder (roles/cloudbuild.customworkers.builder) in the project.
var
string
$this
getEnvironmentVariables
User-provided build-time environment variables for the function
setEnvironmentVariables
User-provided build-time environment variables for the function
$this
getDockerRegistry
Optional. Docker Registry to use for this deployment. This configuration is only applicable to 1st Gen functions, 2nd Gen functions can only use Artifact Registry.
If docker_repository
field is specified, this field will be automatically
set as ARTIFACT_REGISTRY
.
If unspecified, it currently defaults to CONTAINER_REGISTRY
.
This field may be overridden by the backend for eligible deployments.
int
setDockerRegistry
Optional. Docker Registry to use for this deployment. This configuration is only applicable to 1st Gen functions, 2nd Gen functions can only use Artifact Registry.
If docker_repository
field is specified, this field will be automatically
set as ARTIFACT_REGISTRY
.
If unspecified, it currently defaults to CONTAINER_REGISTRY
.
This field may be overridden by the backend for eligible deployments.
var
int
$this
getDockerRepository
User managed repository created in Artifact Registry optionally with a customer managed encryption key. This is the repository to which the function docker image will be pushed after it is built by Cloud Build.
If unspecified, GCF will create and use a repository named 'gcf-artifacts'
for every deployed region.
It must match the pattern projects/{project}/locations/{location}/repositories/{repository}
.
Cross-project repositories are not supported.
Cross-location repositories are not supported.
Repository format must be 'DOCKER'.
string
setDockerRepository
User managed repository created in Artifact Registry optionally with a customer managed encryption key. This is the repository to which the function docker image will be pushed after it is built by Cloud Build.
If unspecified, GCF will create and use a repository named 'gcf-artifacts'
for every deployed region.
It must match the pattern projects/{project}/locations/{location}/repositories/{repository}
.
Cross-project repositories are not supported.
Cross-location repositories are not supported.
Repository format must be 'DOCKER'.
var
string
$this
