Skip to content


Vertex Runner#

Uses Google cloud's Vertex AI pipelines to help you orchestrate your Fondant pipelines in a serverless manner. This makes it easy to scale up your pipelines without worrying about infrastructure deployment.

Vertex AI pipelines leverages Kubeflow pipelines under the hood. The Vertex compiler will take your pipeline and compile it to a Kubeflow pipeline spec. This spec can be used to run your pipeline on Vertex.

Installing the Vertex runner#

Make sure to install Fondant with the Vertex runner extra.

pip install fondant[vertex]

Running a pipeline with Vertex#

You will first need to make sure that your Google Cloud environment is properly setup. More info here

fondant run vertex <pipeline_ref> \
 --project-id $PROJECT_ID \
 --region $PROJECT_REGION \
 --service-account $SERVICE_ACCOUNT

The pipeline ref is reference to a fondant pipeline (e.g. where a pipeline instance exists.

from fondant.pipeline.compiler import VertexCompiler
from fondant.pipeline.runner import VertexRunner

project_id = <the_gcp_project_id>
project_region = <the_region_where_the_pipeline_will_run>
service_account = <the_service_account_to_run_the_pipeline_with>

compiler= VertexCompiler()

runner = VertexRunner(

Once your pipeline is running you can monitor it using the Vertex UI.

Assigning custom resources to the pipeline#

The computation resources needs to be assigned explicitly, Vertex will then randomly attempt to allocate a machine that fits the resources. The GPU name needs to be assigned explicitly. Check this link for a list of available GPU resources. Make sure to check that the chosen GPU is available in the region where the pipeline will be run.

from fondant.pipeline import Resources

dataset = dataset.apply(