Google Cloud Build official builder images
This repository contains source code for official builders used with the Google Cloud Build API.
Pre-built images are available at gcr.io/cloud-builders/...
and include:
bazel
: runs the bazel toolcurl
: runs the curl tooldocker
: runs the docker tooldotnet
: run the dotnet toolgcloud
: runs the gcloud toolgcs-fetcher
: efficiently fetches objects from Google Cloud Storagegit
: runs the git toolgke-deploy
: deploys an application to a Kubernetes cluster, following Google's recommended best practicesgo
: runs the go toolgradle
: runs the gradle toolgsutil
: runs the gsutil tooljavac
: runs the javac toolkubectl
: runs the kubectl toolmvn
: runs the maven toolnpm
: runs the npm tooltwine
: runs the twine toolwget
: runs the wget toolyarn
: runs the yarn tool
Builders contributed by the public are available in the Cloud Builders Community repo.
Each builder includes a cloudbuild.yaml
that will push your images to Artifact
Registry in addition to Google Container
Registry. To build with this default cloudbuild.yaml
,
you will need to first create a Docker
repository
to store the images. The provided cloudbuild.yaml
assumes your project has set up a multi-region Artifact
Registry Docker repositories called ga
and that is setup for us
, europe
, and asia
multi-regions (i.e. us-docker.pkg.dev
, europe-docker.pkg.dev
, asia-docker.pkg.dev
).
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 or have a feature request, e-mail google-cloud-dev@googlegroups.com or see our Getting support documentation.
Alternative Official Images
Most of the tools in this repo are also available in official community-supported publicly available repositories. Such repos also generally support multiple versions and platforms, available by tag.
The following official community-supported images are compatible with the
hosted Cloud Build service and function well as build steps; note that
some will require that you specify an entrypoint
for the image. Additional
details regarding each alternative official image are available in the README.md
for the corresponding Cloud Builder.
docker
supports tagged docker versions across multiple platformsgcr.io/google.com/cloudsdktool/cloud-sdk
includes multiple entrypoints:node
includes these entrypoints:microsoft/dotnet:sdk
includesdotnet
: runs the dotnet tool
- Java builders include:
gcr.io/cloud-marketplace-containers/google/bazel
is provided by the bazel team and runs thebazel
toolcurl
is packaged in:launcher.gcr.io/google/ubuntu1604
curlimages/curl
is community-supported
golang
is provided by the Go team and runs thego
tool
Future Direction
You may have already noticed that most of the images in this repo now provide notices to the
above alternative images. For the hosted Cloud Build service, we are formulating plans
surrounding both improved support for existing cloud-builder
images and documentation for
alternative community-supported images that may be more appropriate for some users. Both this
page and the related open issues
will be updated with details soon.