Using community-contributed builders and custom builders

This page explains how to use community-contributed builders and custom builders in Cloud Build. The Cloud Build developer community provides open-source builders that you can use to execute your tasks. If the task you want to perform requires capabilities that are not provided by an existing image, you can build your own custom image and use it in a build step. To learn about the different types of builders, see Cloud Builders.

If you're new to Cloud Build, read the quickstarts and the Build configuration overview first.

Using community-contributed builders

Prebuilt images are not available for community-contributed builders; to use these builders in a Cloud Build config file, you must first build the image and push it to Artifact Registry in your project.

To use a community-contributed builder:

1. Build and push the builder:

   1. Navigate to your project root directory.

   2. Clone the cloud-builders-community repository:

      git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git
      

   3. Navigate to the builder image you want to use, where builder-name is the directory that contains the builder:

      cd cloud-builders-community/builder-name
      

   4. Submit the builder to your project:

      gcloud builds submit .
      

   5. Navigate back to your project root directory:

      cd ../..
      

   6. Remove the repository from your root directory:

      rm -rf cloud-builders-community/
      

2. In your Cloud Build config file, use the builder in a build step: