Create a build configuration file
This page describes how to create a build configuration file that you can use to start a build on Cloud Build.
A build config file defines the fields that are needed for Cloud Build to perform your tasks. You'll need a build config file if you're starting builds using the gcloud
command-line tool or build triggers. You can write the build config file using the YAML or the JSON syntax.
Before you begin
Read Build Configuration Overview to learn about the fields you can include in a build config file.
Creating a build config
The following steps explain how to create a basic build config file. Each of the fields in the build config file defines a part of the task you want to perform. The only required field in the build config file is the name
field for a step. All other fields are optional.
Create the build config file. In your project root directory, create a file named
cloudbuild.yaml
. This is your Cloud Build config file.Add the steps field. The
steps
section in the build config file contains the build steps that you want Cloud Build to perform.Add the first step. Under
steps:
, add aname
field and point it to a container image to execute your task. Cloud Build and its developer community provides several container images with common tools and languages installed. You can use any of these images (also called Cloud Builders) or any publicly available image in a build step. For information on different types of container images you can use in a build step, see Cloud Builders.The following snippet shows a build step with a
docker
buildergcr.io/cloud-builders/docker
, which is a container image running Docker.Add step arguments. The
args
field of a step takes a list of arguments and passes them to the builder referenced by thename
field. If the builder in thename
field has an entrypoint,args
in the list are used to access that entrypoint. If the builder in thename
field does not have an entrypoint, the first element inargs
is used as the entrypoint.In the following example:
build
is the entrypoint to the Docker cloud builder.-t
is the Docker tag.us-central1-docker.pkg.dev/${PROJECT_ID}/my-docker-repo/my-image
is the name of the image to be built in Artifact Registry. The build step uses the default substitution for project ID, therefore this value is automatically substituted at build time..
is the location of the source code, which indicates the source code is in the current working directory.
Add more steps. You can add any number of build steps to your build config file by including additional
name
fields and pointing them to cloud builders.The following snippet includes two more steps to the build config file:
- a docker build step to invoke the
docker push
command to push the image build in the previous step to Artifact Registry. a build step for the Google Cloud SDK command with the
gcloud
entrypoint specified, which creates a Compute Engine instance from the container image in Artifact Registry. Theenv
field is included to specify the Compute Engine zone and region.
- a docker build step to invoke the
Include additional build configuration fields. You can configure the build further by including fields such as
machineType
,tags
, ortimeout
. For the complete list of fields you can include in the build config file see Build Configuration Overview.In the following example, the
gcr.io/google.com/cloudsdktool/cloud-sdk
build step times out after 240 seconds.See the following snippet for the complete example of a basic build config file:
In the example, container images are stored in Artifact Registry. If your build produces any non-container artifacts, you can store them in Cloud Storage using the
artifacts
field. For instructions on doing this, see Storing Images and Artifacts.
Comments
Post a Comment