forked from pivotal-cf/docs-apigee
-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html.md.erb
103 lines (75 loc) · 5.85 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
---
title: Apigee Edge Service Broker for Pivotal Cloud Foundry
owner: Partners
---
<strong><%= modified_date %></strong>
This documentation describes the Apigee Edge Service Broker for Pivotal Cloud Foundry (PCF). The Apigee Edge Service Broker for PCF enables developers to proxy APIs for their PCF apps.
## <a id='overview'></a>Overview
The Apigee Edge Service Broker for PCF registers a service broker with PCF 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 PCF app.
Through the service broker, you can proxy calls to your PCF app with one of two varieties of Apigee Edge:
- Apigee Edge Public Cloud
Calls to your PCF 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 PCF app.
- Apigee Edge Microgateway
Calls to your PCF 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 PCF 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 PCF:
<table class="nice">
<th>Element</th>
<th>Details</th>
<tr>
<td>Version</td>
<td>v3.0.0</td>
</tr>
<tr>
<td>Release date</td>
<td>December 6, 2017</td>
</tr>
<tr>
<td>Software component version</td>
<td>Apigee Edge Service Broker for PCF v3.0.0</td>
</tr>
<tr>
<td>Compatible Ops Manager version(s)</td>
<td>v1.7 to v1.12</td>
</tr>
<tr>
<td>Compatible Elastic Runtime version(s)</td>
<td>v1.7 to v1.12</td>
</tr>
<tr>
<td>Compatible Pivotal Application Services (PAS)* version(s)</td>
<td>v2.0.0</td>
</tr>
<tr>
<td>IaaS support</td>
<td>vSphere</td>
</tr>
</table>
\* As of PCF v2.0, <em>Elastic Runtime</em> is renamed <em>Pivotal Application Service (PAS)</em>. If your tile supports PCF 2.0, it will use PAS, not Elastic Runtime.
## <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 PCF](installing.html): Install and configure the Apigee Edge Service Broker for PCF tile to expose the Apigee Edge service plans on the Marketplace of your PCF 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 PCF app will be routed through a proxy in your Apigee Edge organization. For more on getting started, see [Proxying a PCF App with Apigee Edge ("org" plan)](proxying-org.html).
Apigee Edge Microgateway (same container) | `microgateway-coresident` | Calls to your PCF app will be routed through a proxy in an instance of Apigee Edge Microgateway running in the same Cloud Foundry container as your PCF app. For more on getting started, see [Proxying a PCF App with Apigee Edge Microgateway ("microgateway-coresident" plan)](proxying-microgateway-coresident.html).
Apigee Edge Microgateway (separate containers) | `microgateway` | Calls to your PCF app will be routed through a proxy in an instance of Apigee Edge Microgateway running in a separate Cloud Foundry container from your PCF app. For more on getting started, see [Proxying a PCF App with Apigee Edge Microgateway ("microgateway" plan)](proxying-microgateway.html).
## <a id='prereqs'></a>Prerequisites
The Apigee Edge Service Broker for PCF 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're using.
* A PCF Elastic Runtime (version 1.7 to 1.11) deployment with Route Services enabled.
* The [cf CLI](https://github.com/cloudfoundry/cli) v6.20.0+, which includes support for `route-services` operations.
* Node.js v4.x or later. PCF 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
Please post any bugs, feature requests, questions, and usage articles to the [Apigee PCF Community Forum](https://community.apigee.com/spaces/134/integration.html).