Pivotal Deployments Overview

Updated 2 weeks ago by Michael Cretzman

This topic describes the concept of a Harness Pivotal Cloud Foundry (PCF) deployment by describing the high-level steps involved.

For a quick tutorial, see the Pivotal Cloud Foundry Quickstart.

For detailed instructions on using PCF in Harness, see the PCF How-tos.

Before You Begin

Before learning about Harness Pivotal Cloud Foundry (PCF) deployments, you should have an understanding of Harness Key Concepts.

What Does Harness Need Before You Start?

A Harness PCF deployment requires the following:

  • Artifact: For example, a Docker image of NGINX from Docker Hub.
  • Target PCF Organization and Space for the deployment.

What Does Harness Deploy?

Harness takes the artifacts and PCF specs you provide and deploys them to the target PCF Organization and Space.

You can use PCF CLI plugins in your deployments. The App Autoscaler plugin has first-class support in Harness, enabling you to ensure app performance and control the cost of running apps. See Use CLI Plugins in Harness PCF Deployments.

What Does a Harness PCF Deployment Involve?

The following list describes the major steps of a Harness PCF deployment:



Description and Links


Install the Harness Delegate in your target PCF infrastructure. 

Typically, the Delegate is installed in the target space where you will deploy your application(s).

If you are running your PCF Cloud in AWS, you can use a Shell Script Delegate run on an EC2 instance in the same VPC and subnet as your PCF Cloud, or an ECS Delegate run in an ECS cluster in the same VPC.


Add a Harness Artifact Server.

Add a Harness Artifact Server. For example, a Docker Registry Artifact Server that connects to the Docker registry where your Docker images are located, or the public Docker Hub.


Add a Cloud Provider.

A Cloud Provider is a connection to your PCF API endpoint URL. For example, api.run.pivotal.io.


Create the Harness Application for your PCF CD Pipeline.

The Harness Application represents a group of microservices, their deployment pipelines, and all the building blocks for those pipelines. Harness represents your release process using a logical group of one or more entities: Services, Environments, Workflows, Pipelines, Triggers, and Infrastructure Provisioners. Applications organize all of the entities and configurations in Harness CD.

See Create an Application.


Create the Harness Service using the Pivotal Cloud Foundry Deployment Type.

Add your PCF specs and any config variables and files.


Create the Harness Environment and Infrastructure Definition for your target PCF org and space, and any overrides.

Using the Harness Cloud Provider you set up, you can select the target PCF org and space for your deployment.

You can also override any Service settings, such as manifest values. This enables you to use a single Service with multiple Harness Environments.


Create the Canary, Blue/Green, or Basic deployment Harness Workflow.

The Workflow deploys the artifact(s), PCF apps and routes defined in the Harness Service to the org and space in the Harness Infrastructure Definition.


Deploy the Workflow.

Once you've deployed a Workflow, learn how to improve your PCF CD:

Next Steps

Read the following topics to build on what you've learned:

How did we do?