Apigee Edge Service Broker for Pivotal Platform

This documentation describes the Apigee Edge Service Broker for Pivotal Platform. The Apigee Edge Service Broker for Pivotal Platform enables developers to proxy APIs for their Pivotal Platform apps.

Overview

The Apigee Edge Service Broker for Pivotal Platform registers a service broker with Pivotal Platform and exposes its service plans on the Marketplace. Using the service broker, you can create service plan instances using Apps Manager or the Cloud Foundry Command Line Interface (cf CLI) and bind them to their apps. Creating an Apigee service instance and binding it to an app creates an API proxy that handles requests for the Pivotal Platform app.

Through the service broker, you can proxy calls to your Pivotal Platform app with one of two varieties of Apigee Edge:

  • Apigee Edge Public Cloud

    Calls to your Pivotal Platform app are routed first through proxies you create on Apigee Edge Public Cloud. You can use the Apigee Edge management console to configure API request handling between clients and your Pivotal Platform app.

  • Apigee Edge Microgateway

    Calls to your Pivotal Platform app are routed first through proxies exposed by Apigee Edge Microgateway. When you use Apigee Edge Microgateway, you can specify whether you want the Microgateway instance and your Pivotal Platform app to run in the same or separate Cloud Foundry containers.

See Getting Started for more about each option.

Key Features

After creating an Apigee Edge API proxy, developers can access the Apigee Edge management console to enhance the proxy with the following features:

  • Data transformation, mediation, orchestration, and policies for rate limits
  • Security, such as authentication and Role-Based Access Control
  • Onboarding, including a developer portal to enable self-service
  • Analytics for monitoring and business metrics analysis
  • Monetization for rate plans, internationalization, and usage tracking

Product Snapshot

The following table provides version and version-support information about Apigee Edge Service Broker for Pivotal Platform:

Element Details
Version v3.1.3
Release date June 28, 2019
Software component version Apigee Edge Service Broker for Pivotal Platform v3.1.2
Compatible Ops Manager version(s) 2.4.x, 2.5.x, 2.6x
Compatible Pivotal Application Service version(s) 2.4.x, 2.5.x, 2.6.x
BOSH stemcell version Ubuntu Xenial
IaaS support vSphere

Getting Started

To begin using the Apigee Edge Service Broker, perform the procedures in the following topics:

  1. Installing and Configuring Apigee Edge for Pivotal Platform: Install and configure the Apigee Edge Service Broker for Pivotal Platform tile to expose the Apigee Edge service plans on the Marketplace of your Pivotal Platform deployment.

  2. Choose an Apigee Edge product type and service plan to use.

When creating an instance of the Apigee service, you specify one of the following service plans. Each has its own benefits.

Apigee Product Service Plan Description
Apigee Edge Public Cloud org Calls to your Pivotal Platform app will be routed through a proxy in your Apigee Edge organization. For more on getting started, see Proxying a Pivotal Platform App with Apigee Edge (“org” plan).
Apigee Edge Microgateway (same container) microgateway-coresident Calls to your Pivotal Platform app will be routed through a proxy in an instance of Apigee Edge Microgateway running in the same Cloud Foundry container as your Pivotal Platform app. For more on getting started, see Proxying a Pivotal Platform App with Apigee Edge Microgateway (“microgateway-coresident” plan).
Apigee Edge Microgateway (separate containers) microgateway Calls to your Pivotal Platform app will be routed through a proxy in an instance of Apigee Edge Microgateway running in a separate Cloud Foundry container from your Pivotal Platform app. For more on getting started, see Proxying a Pivotal Platform App with Apigee Edge Microgateway (“microgateway” plan).

Prerequisites

The Apigee Edge Service Broker for Pivotal Platform has the following prerequisites:

  • An Apigee Edge account (Public Cloud or Private Cloud) with an organization where API proxies can be created. To create an Edge account, see Creating an Apigee Edge account. For more information about Apigee organizations, see Organization structure.
  • Apigee Edge Microgateway, depending on the service plan you are using.
  • A Pivotal Platform Elastic Runtime (v2.3 to v2.5) deployment with Route Services enabled.
  • A PAS Pivotal Application Services deployment for Pivotal Platform v2.1.0 or later with Route Services enabled.
  • The cf CLI v6.20.0 or later, which includes support for route-services operations.
  • Node.js v4.x or later. Pivotal Platform includes Node.js as a system buildpack, so you can install and run the service broker without Node installed locally, if necessary.

Feedback

Post any bugs, feature requests, questions, and usage articles to the Apigee Pivotal Platform Community Forum.