Version 2.4

kf push

Name

kf push - Create a new App or apply updates to an existing one.

Synopsis

kf push APP_NAME [flags]

Examples

kf push myapp
kf push myapp --buildpack my.special.buildpack # Discover via kf buildpacks
kf push myapp --env FOO=bar --env BAZ=foo
kf push myapp --stack cloudfoundry/cflinuxfs3 # Use a cflinuxfs3 runtime
kf push myapp --health-check-http-endpoint /myhealthcheck # Specify a healthCheck for the app

Flags

--app-suffix=string

Suffix to append to the end of every pushed App.

--args=stringArray

Override the args for the image. Can't be used with the command flag.

-b, --buildpack=string

Use the specified buildpack rather than the built-in.

-c, --command=string

Startup command for the App, this overrides the default command specified by the web process.

--container-registry=string

Container registry to push images to.

--cpu-cores=string

Number of dedicated CPU cores to give each App instance (for example 100m, 0.5, 1, 2). For more information see https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/.

-k, --disk-quota=string

Size of dedicated ephemeral disk attached to each App instance (for example 512M, 2G, 1T).

--docker-image=string

Docker image to deploy rather than building from source.

--dockerfile=string

Path to the Dockerfile to build. Relative to the source root.

--entrypoint=string

Overwrite the default entrypoint of the image. Can't be used with the command flag.

-e, --env=stringArray

Set environment variables. Multiple can be set by using the flag multiple times (for example, NAME=VALUE).

--health-check-http-endpoint=string

HTTP endpoint to target as part of the health-check. Only valid if health-check-type is http.

-u, --health-check-type=string

App health check type: http, port (default) or process.

-h, --help

help for push

-i, --instances=int32

If set, overrides the number of instances of the App to run, -1 represents non-user input. (default -1)

-f, --manifest=string

Path to the application manifest.

-m, --memory-limit=string

Amount of dedicated RAM to give each App instance (for example 512M, 6G, 1T).

--no-manifest

Do not read the manifest file even if one exists.

--no-route

Prevents the App from being reachable once deployed.

--no-start

Build but do not run the App.

-p, --path=string

If specified, overrides the path to the source code.

--random-route

Create a random Route for this App if it doesn't have one.

--route=stringArray

Use the routes flag to provide multiple HTTP and TCP routes. Each Route for this App is created if it does not already exist.

-s, --stack=string

Base image to use for to use for Apps created with a buildpack.

--task

Push an App to execute Tasks only. The App will be built, but not run. It will not have a route assigned.

-t, --timeout=int

Amount of time the App can be unhealthy before declaring it as unhealthy.

--var=stringToString

Manifest variable substitution. Multiple can be set by using the flag multiple times (for example NAME=VALUE).

--vars-file=stringArray

JSON or YAML file to read variable substitutions from. Can be supplied multiple times.

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.