Pivotal Cloud Foundry Deployments

Updated 3 weeks ago by Michael Cretzman

This tutorial is for the latest version of Harness PCF support. This version is behind a feature flag. To migrate to this version, contact Harness Support.

Harness provides support for the Pivotal Cloud Foundry (PCF) app development and deployment platform for public and private clouds. This guide describes how to deploy your applications to PCF using Harness, including route mapping.

Walk through this guide in the following order:

  1. Deployment Overview
  2. Delegate and Connectors for PCF
  3. Services for PCF
  4. PCF Environments
  5. PCF Workflows and Deployments
  6. Using CLI Plugins in Harness PCF Deployments

Deployment Overview

This tutorial assumes you are familiar with Cloud Foundry and PCF deployments. For a quick overview, see Cloud Foundry Overview and Orgs, Spaces, Roles, and Permissions.

Setting up a PCF deployment in Harness is a simple process where you connect Harness to your artifact repo and PCF cloud, and then define the app artifacts, PCF manifest files, and target infrastructure.

Next you build Harness Workflows to deploy your artifacts to the target infrastructure.

The following list describes the major steps we will cover in this guide:

  1. Delegate - Install the Harness Delegate on a host in your target VPC, such as an EC2 instance in AWS.
  2. PCF Cloud Provider - Add the PCF Cloud Provider. This is a connection to your PCF account. The PCF Cloud Provider uses your user account and the PCF API endpoint address. The PCF user account must have the required roles for the target deployment space.
  3. Harness Application - Create the Harness Application for your PCF CD pipeline. The Harness Application represents your PCF release process, and all the building blocks for its pipelines.
  4. Harness Service - Create the Harness Service using the Pivotal Cloud Foundry type.
    1. Set up your PCF artifact source, manifest, and any config variables and files.
  5. Harness Environment - Create the Harness Environment containing the Infrastructure Definition definition of your deployment environment, and any overrides of Service settings.
  6. Harness Workflow - Create the Canary or Blue/Green deployment Harness Workflow. This Workflow will deploy the Service (your PCF artifact and manifest) to the Environment.
  7. Deploy the Workflow.
  8. Advanced options not covered in this guide:
    1. Harness Pipeline - Create a Harness Pipeline for your deployment, including Workflows and Approval steps.
    2. Harness Trigger - Create a Harness Trigger to automatically deploy your Workflows or Pipeline according to your criteria. Typically, customers use a Trigger to execute a PCF Pipeline using the Trigger's On New Artifact condition. For more information, see Triggers.
    3. Harness Infrastructure Provisioners - Create Harness Infrastructure Provisioners, such as CloudFormation and Terraform, for your deployment environments. For more information, see Infrastructure Provisioners.
    4. Continuous Verification:
      1. Deployment Verification - Once you have successfully deployed you can add your APM and logging apps as Verification Providers, and then add Verify Steps to your Workflows. Harness will use its machine-learning to find anomalies in your deployments. For more information, see Continuous Verification.
      2. 24/7 Service Guard - Monitor your live applications, catching problems that surface minutes or hours following deployment. For more information, see 24/7 Service Guard.

Next Step

How did we do?