getting-started-pcf.md

Getting Started Guide - Pivotal Cloud Foundry

Note: The use of the AWS Service Broker for PCF is at the beta stage. Bugs and possible update related breaking changes may manifest. Use of the AWS Service Broker in Pivotal Cloud Foundry is not recommended for production at this time.

Compatibility

Testing on V2.1/2.2 was done using the Pivotal Cloud Foundry on the AWS Cloud Quick Start. Though not tested, older PCF versions may work.

Installation

• Download the latest tile from the releases page
• Login to Ops Manager and import the tile
• Complete configuration in the AWS Service Broker Configuration section. Take note of the following fields:
  • AWS Access Key ID and AWS Secret Access - if you are using an ec2 instance role attached to the broker hosts, leave these fields blank, otherwise specify the credentials for the user created in the prerequisites section of this guide.
  • Target AWS Account ID and Target IAM Role Name - if you would like to provision into a different account, or use a different role for provisioning, populate these with the account and role details. The role specified must allow the broker user/role to assume it
  • AWS Region - this is the default region for the broker to deploy services into, and must match the region that the DynamoDB table created in the prerequisisites section of this guide was created in (this will be decoupled in an upcoming update).
  • Amazon S3 Bucket - specify awsservicebroker
  • Amazon S3 Key Prefix - specify templates/latest/
  • Amazon S3 Region - specify us-east-1
  • Amazon S3 Key Suffix - specify -main.yaml
  • Amazon DynamoDB table name - specify the name of the table created in the prerequisites section of this guide, default is awssb