Version 2.2

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.