Repository files navigation

This repository contains source code for official builders used with theGoogleCloud Build API.

Pre-built images are available atgcr.io/cloud-builders/... and include:

• aactl: runs theaactl tool
• bazel: runs thebazel tool
• curl: runs thecurl tool
• docker: runs thedocker tool
• dotnet: run thedotnet tool
• gcloud: runs thegcloud tool
• gcs-fetcher: efficiently fetches objects from Google Cloud Storage
• git: runs thegit tool
• gke-deploy: deploys an application to a Kubernetes cluster, following Google's recommended best practices
• go: runs thego tool
• gradle: runs thegradle tool
• gsutil: runs thegsutil tool
• javac: runs thejavac tool
• kubectl: runs thekubectl tool
• mvn: runs themaven tool
• npm: runs thenpm tool
• twine: runs thetwine tool
• wget: runs thewget tool
• yarn: runs theyarn tool

Builders contributed by the public are available in theCloud BuildersCommunityrepo.

Each builder includes acloudbuild.yaml that will push your images toArtifactRegistry. To build with this defaultcloudbuild.yaml,you will need to firstcreate an Artifact Registry repository with gcr.io domain support.

To file issues and feature requests against these builder images,create an issue in this repo.If you are experiencing an issue with the Cloud Build service orhave a feature request, e-mailgoogle-cloud-dev@googlegroups.comor see ourGetting supportdocumentation.

Most of the tools in this repo are also available incommunity-supported publicly available repositories. Suchrepos also generally support multiple versions and platforms,available by tag.

The following community-supported images are compatible with thehosted Cloud Build service and function well as build steps; note thatsome will require that you specify anentrypoint for the image. Additionaldetails regarding each alternative official image are available in theREADME.mdfor the corresponding Cloud Builder.

• docker supports tagged docker versions across multiple platforms
• gcr.io/google.com/cloudsdktool/cloud-sdk includes multiple entrypoints:
  • gcloud: runs thegcloud tool
  • gsutil: runs thegsutil tool
  • kubectl: runs thekubectl tool
• node includes these entrypoints:
  • npm: runs thenpm tool
  • yarn: runs theyarn tool
• microsoft/dotnet:sdk includes
  • dotnet: runs thedotnet tool
• Java builders include:
  • openjdk supports many production versions of Java across multiple platforms
  • gradle supports a matrix of Java and gradle versions across multiple platforms
  • maven supports a matrix of Java and maven versions across multiple platforms
• gcr.io/cloud-marketplace-containers/google/bazel is provided by the bazel team and runs thebazel tool
• curl is packaged in:
  • launcher.gcr.io/google/ubuntu1604
  • curlimages/curl is community-supported
• golang is provided by the Go team and runs thego tool

Google announced on May 15 2023 that Container Registry has been deprecated and is superseded by Artifact Registry. The deprecation won't affect the use of official cloud builder images. Artifact Registryautomatically redirects gcr.io requests for Container Registry hosts to corresponding Artifact Registry repositories.

You may have already noticed that most of the images in this repo now provide notices to theabove alternative images. For the hosted Cloud Build service, we are formulating planssurrounding both improved support for existingcloud-builder images and documentation foralternative community-supported images that may be more appropriate for some users. Both thispage and the relatedopen issueswill be updated with details soon.