Version 2.1

kf create-user-provided-service

Name

kf create-user-provided-service - Create a standalone service instance from existing credentials

Synopsis

kf create-user-provided-service SERVICE_INSTANCE [-p CREDENTIALS] [-t TAGS] [flags]

Description

Creates a standalone service instance from existing credentials. User-provided services can be used to inject credentials for services managed outside of Kf into Apps.

Credentials are stored in a Kubernetes Secret in the Space the service is created in. On GKE these Secrets are encrypted at rest and can optionally be encrypted using KMS.

Examples

  # Bring an existing database service
  kf create-user-provided-service db-service -p '{"url":"mysql://..."}'
  
  # Create a service with tags for autowiring
  kf create-user-provided-service db-service -t "mysql,database,sql"

Flags

--async
Don't wait for the action to complete on the server before returning
-h, --help
help for create-user-provided-service
--mock-class=string
Mock class name to use in VCAP_SERVICES rather than 'user-provided'.
--mock-plan=string
Mock plan name to use in VCAP_SERVICES rather than blank.
-p, --params=string
JSON object or path to a JSON file containing configuration parameters. (default "{}")
-r, --route=string
URL to which requests for bound routes will be forwarded. Scheme must be https.
-t, --tags=string
User-defined tags to differentiate services during injection.

Inherited flags

These flags are inherited from parent commands.

--config=string
Config file (default is $HOME/.kf)
--kubeconfig=string
Kubectl config file (default is $HOME/.kube/config)
--log-http
Log HTTP requests to stderr
--space=string
Space to run the command against. This overrides the currently targeted space