Version 2.4

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

Do not 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, --parameters=string

JSON object or path to a JSON file containing configuration parameters. (default "{}")

--params=string

JSON object or path to a JSON file containing configuration parameters. DEPRECATED: use --parameters instead. (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.

--as=string

Username to impersonate for the operation.

--as-group=strings

Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.

--config=string

Path to the Kf config file to use for CLI requests.

--kubeconfig=string

Path to the kubeconfig file to use for CLI requests.

--log-http

Log HTTP requests to standard error.

--space=string

Space to run the command against. This flag overrides the currently targeted Space.