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 Assign CPU Resources to Containers and Pods .

-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.