forked from pivotal-cf/docs-apigee
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathindex.html.md.erb
107 lines (74 loc) · 6.11 KB
/
index.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
---
title: Apigee Edge Service Broker for Pivotal Platform
owner: Partners
---
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.
## <a id='overview'></a> 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](http://docs.apigee.com/api-services/content/what-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](http://docs.apigee.com/microgateway/latest/overview-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](#getting-started) for more about each option.
## <a id='features'></a> 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
## <a id='snapshot'></a> Product Snapshot
The following table provides version and version-support information about Apigee Edge Service Broker for Pivotal Platform:
<table class="nice">
<th>Element</th>
<th>Details</th>
<tr>
<td bgcolor="#edf0f4">Version</td>
<td bgcolor="#edf0f4">v3.1.3</td>
</tr>
<tr>
<td>Release date</td>
<td>June 28, 2019</td>
</tr>
<tr>
<td>Software component version</td>
<td>Apigee Edge Service Broker for Pivotal Platform v3.1.2</td>
</tr>
<tr>
<td>Compatible Ops Manager version(s)</td>
<td>2.4.x, 2.5.x, 2.6x</td>
</tr>
<tr>
<td>Compatible Pivotal Application Service version(s)</td>
<td>2.4.x, 2.5.x, 2.6.x</td>
</tr>
<tr>
<td>BOSH stemcell version</td>
<td>Ubuntu Xenial</td>
</tr>
<tr>
<td>IaaS support</td>
<td>vSphere</td>
</tr>
</table>
## <a id='getting-started'></a> 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](installing.html): 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.
1. 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)](proxying-org.html). |
| 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)](proxying-microgateway-coresident.html). |
| 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)](proxying-microgateway.html). |
## <a id='prereqs'></a> 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](http://docs.apigee.com/api-services/content/creating-apigee-edge-account). For more information about Apigee organizations, see [Organization structure](http://docs.apigee.com/api-services/content/apigee-edge-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](https://github.com/cloudfoundry/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.
## <a id='feedback'></a> Feedback
Post any bugs, feature requests, questions, and usage articles to the [Apigee Pivotal Platform Community Forum](https://community.apigee.com/spaces/134/integration.html).