EMC ECS Service Broker PCF Tile

REPOSITORY HAS MOVED!!

NOTE: This repository is no longer maintained - all updates past v2.3.1 will be located here: https://github.com/EMCECS/ecs-broker-tile

Description

This tile is created using the Pivotal Tile Generator and deploys a service-broker application as a CF app. It deploys a sister project, the ECS Service Broker. For more instructions on using the broker once deployed, refer to the Pivotal Network documentation.

This tile implements the following tile generator errands:

• deploy-service-broker: Deploy the broker as a CF app.
• register-broker: Register the deployed broker with CF as service broker.
• destroy-broker: Deregister and delete the app from CF.

Upon completion, PCF Tile will support dynamic plans which enables the broker to be configured from the PCF Ops Manager.

Current Status

Currently, the Tile version 2.0.3 is available for download via the Pivotal Network product page.

Requirement

• ECS Cluster configured and running. If you do not have one please refer to ECS Test Drive to create an account.
• ECS VIP address for Management and Object
• Namespace and Replication group
• ECS SSL cert, to get the ssl cert use openssl s_client -connect <ecsvip>:443 –showcert to get ssl

Build Tile

• Clone the code to your local bosh machine
• Install Tile Generator Tool
• Run command tile build

Deployment

• Using OpsManager website upload the tile
• Add tile to dashboard
• Configure tile according to the documentation.
• Apply Changes
• Run cf service-brokers to check the broker status

End-user Broker Usage

CLoud Foundry end-users can create and bind services to their applications using the cf CLI application.

cf create-service ecs-bucket unlimited my_bucket

This creates a bucket of the ecs-bucket service with the unlimited plan and the name: my-bucket. To bind an application to this bucket:

cf bind-service my-app my-bucket

The default will give my-app "full control" of the bucket. To give a reduced set of permissions, you can provide additional configuration parameters with the -c flag:

cf bind-service my-app my-bucket -c '{"permissions": ["read", "write"]}'

Valid permissions include:

• read
• read_acl
• write
• write_acl
• execute
• full_control
• privileged_write
• delete
• none

For more information about the ECS Broker usage please refer to ECS CF service broker

Testing

Currently, tests are implemented for tile migrations using Jest.js. To run the tests install the jest-cli globally with NPM or yarn:

# Install Jest.js
$ npm install -g jest-cli

# Run jest
$ jest