Google Cloud Image Builder
Building container images with Google Cloud Build
This is an older version of the ZenML documentation. To read and view the latest version please visit this up-to-date URL.
Google Cloud Image Builder
The Google Cloud image builder is an image builder flavor provided by the ZenML gcp
integration that uses Google Cloud Build to build container images.
When to use it
You should use the Google Cloud image builder if:
you're unable to install or use Docker on your client machine.
you're already using GCP.
your stack is mainly composed of other Google Cloud components such as the GCS Artifact Store or the Vertex Orchestrator.
How to deploy it
In order to use the ZenML Google Cloud image builder you need to enable Google Cloud Build relevant APIs on the Google Cloud project.
How to use it
To use the Google Cloud image builder, we need:
The ZenML
gcp
integration installed. If you haven't done so, run:A GCP Artifact Store where the build context will be uploaded, so Google Cloud Build can access it.
A GCP container registry where the built image will be pushed.
Optionally, the GCP project ID in which you want to run the build and a service account with the needed permissions to run the build. If not provided, then the project ID and credentials will be inferred from the environment.
Optionally, you can change:
the Docker image used by Google Cloud Build to execute the steps to build and push the Docker image. By default, the builder image will be
'gcr.io/cloud-builders/docker'
.The network to which the container used to build the ZenML pipeline docker image will be attached. More information: Cloud build network.
The build timeout for the build, and for the blocking operation waiting for the build to finish. More information: Build Timeout.
We can register the image builder and use it in our active stack:
Caveats
As described in this Google Cloud Build documentation page, Google Cloud Build uses containers to execute the build steps which are automatically attached to a network called cloudbuild
that provides some Application Default Credentials (ADC), that allow the container to be authenticated and therefore use other GCP services.
By default, the GCP Image Builder is executing the build command of the ZenML Pipeline Docker image with the option --network=cloudbuild
, so the ADC provided by the cloudbuild
network can also be used in the build. This is useful if you want to install a private dependency from a GCP Artifact Registry, but you will also need to use a custom base parent image with the keyrings.google-artifactregistry-auth
installed, so pip
can connect and authenticate in the private artifact registry to download the dependency.
The above Dockerfile
uses zenmldocker/zenml:latest
as a base image, but is recommended to change the tag to specify the ZenML version and Python version like 0.33.0-py3.10
.
Last updated