Structure of a delivery pipeline configuration file
The main configuration file for Google Cloud Deploy is the delivery pipeline config.
This file can include target definitions, or those can be
in a separate file or files. By convention, a file containing both the delivery
pipeline config and the target configs is called
clouddeploy.yaml, and a
pipeline config without targets is called
delivery-pipeline.yaml. But you give
these files any name you want.
The following configuration includes the target definition:
apiVersion: deploy.cloud.google.com/v1 kind: DeliveryPipeline metadata: name: annotations: labels: description: serialPipeline: stages: - targetId: profiles:  - targetId: profiles:  --- apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: annotations: labels: description: requireApproval: gke: cluster: projects/[project_name]/locations/[location]/clusters/[cluster_name] executionConfigs: - privatePool: workerPool: serviceAccount: artifactStorage: usages: - [RENDER | DEPLOY] - defaultPool: serviceAccount: artifactStorage: usages: - [RENDER | DEPLOY] ---
This YAML has two main components:
The main delivery pipeline and progression
The configuration file can include any number of pipeline definitions.
The target definitions
For simplicity, only one target is shown in this example, but there can be any number of them. Also, targets can be defined in a separate file or files.
These components are defined in the rest of this document.
Pipeline definition and progression
In addition to pipeline metadata, such as
name, the main pipeline definition
includes a listing of all targets in
deployment sequence order. That is, the first target listed is the first
deployment target. After you've deployed to that target, and promote the
release, Google Cloud Deploy deploys to the next target in the list.
name field takes a string that must be unique per project and location.
Delivery pipeline configuration can include annotations and labels. Annotations and labels are stored with the delivery pipeline resource after the pipeline has been registered.
For more information, see Using labels and annotations with Google Cloud Deploy.
An arbitrary string describing this delivery pipeline. This description is shown in the delivery pipeline details in Google Cloud Console.
A list of all targets to which this delivery pipeline is configured to deploy.
The list must be in the order of the delivery sequence you want. For example,
if you have targets called
production, list them in that
same order, so that your first deployment is to
dev, and your final deployment
stages.targetId field with the value of the
field in the corresponding target definition. And under
serialPipeline: stages: - targetId: profiles: 
Identifies the specific target to use for this stage of the delivery pipeline.
The value is the
metadata.name property from the target definition.
Takes a list of zero or more Skaffold profile names, from
Google Cloud Deploy uses the profile with
when creating the release. Skaffold profiles let you vary configuration between
targets while using a single configuration file.
The delivery pipeline definition file can contain target definitions, or you can specify targets in a separate file. You can repeat Target names within a project, but they must be unique within a delivery pipeline.
You can reuse targets among multiple delivery pipelines. However, you can only reference a target once from within a single delivery pipeline's progression.
apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: annotations: labels: description: requireApproval: gke: cluster: projects/[project_name]/locations/[location]/clusters/[cluster_name] executionConfigs: - privatePool: workerPool: serviceAccount: artifactStorage: usages: - [RENDER | DEPLOY] - defaultPool: serviceAccount: artifactStorage: usages: - [RENDER | DEPLOY]
The name of this target. This name must be globally unique.
Annotations and labels are stored with the target resource. For more information, see Using labels and annotations with Google Cloud Deploy.
This field takes an arbitrary string that describes the use of this target.
Whether promotion to this target requires manual approval. Can be
This property is optional. The default is
The resource path identifying the cluster where your application is deployed:
gke: cluster: projects/[project_name]/locations/[location]/clusters/[cluster_name]
The Google Cloud project in which the cluster lives.
The location where the cluster lives. For example,
us-central1. The cluster can also be zonal (
The name of the cluster, as it appears in your list of clusters in Google Cloud Console.
Here's an example:
gke: cluster: projects/cd-demo-01/locations/us-central1/clusters/prod
A set of fields to specify a non-default execution environment for this target.
Configuration for the worker pool to use, whether it's a private pool or the default pool. A given target can have both (one for
RENDERand one for
DEPLOY). When configuring a
defaultPool, you can specify an alternate service account or storage location or both.
A resource path identifying the Cloud Build private worker pool to use for this target. For example:
Omit this property if you're configuring service account or storage for the
defaultPool. This property is required for
privatePool, and is omitted for
The name of the service account to use for this operation for this target.
The Cloud Storage bucket to use, instead of the default bucket, for this operation for this target.
DEPLOYor both, indicating which of those operations to perform for this target using this execution environment. To indicate that a custom execution environment is to be used for both rendering and deployment, you would configure it as follows:
usages: - RENDER - DEPLOY
Find out more about how Google Cloud Deploy works.
Learn how to set up a delivery pipeline for your application.
Learn how to manage your manifests.
Avoid mismatches between your release and your delivery pipeline by learning about pipeline instances.