Find a service
kf marketplace command to find a service you want to use in your App.
Running the command without arguments will show all the service classes
available. A service class represents a specific type of service e.g. a
MySQL database or a Postfix SMTP relay.
$ kf marketplace 5 services can be used in Space "test", use the --service flag to list the plans for a service Broker Name Space Status Description minibroker mariadb Active Helm Chart for mariadb minibroker mongodb Active Helm Chart for mongodb minibroker mysql Active Helm Chart for mysql minibroker postgresql Active Helm Chart for postgresql minibroker redis Active Helm Chart for redis
Service classes can have multiple plans available. A service plan generally corresponds to a version or pricing tier of the software. You can view the plans for a specific service by supplying the service name with the marketplace command:
$ kf marketplace --service mysql Name Free Status Description 5-7-14 true Active Fast, reliable, scalable, and easy to use open-source relational database system. 5-7-27 true Active Fast, reliable, scalable, and easy to use open-source relational database system. 5-7-28 true Active Fast, reliable, scalable, and easy to use open-source relational database system.
Provision a service
Once you have identified a service class and plan to provision, you can create
an instance of the service using
$ kf create-service mysql 5-7-28 my-db Creating service instance "my-db" in Space "test" Waiting for service instance to become ready... Success
Services are provisioned into a single Space. You can see the services in the
current Space by running
$ kf services Listing services in Space: "test" Name ClassName PlanName Age Ready Reason my-db mysql 5-7-28 111s True <nil>
You can delete a service using
$ kf delete-service my-db
Bind a service
Once a service has been created, you can bind it to an App, which will
inject credentials into the App so the service can be used. You can create
the binding using
$ kf bind-service my-app my-db Creating service instance binding "binding-my-app-my-db" in Space "test" Waiting for service instance binding to become ready... Success
You can list all bindings in a Space using the
kf bindings command:
$ kf bindings Listing bindings in Space: "test" Name App Service Age Ready binding-my-app-my-db my-app my-db 82s True
Once a service is bound, restart the App using
kf restart and the credentials
will be in the
VCAP_SERVICES environment variable.
You can delete a service binding with the
kf unbind-service command:
$ kf unbind-service my-app my-db