Package Manager Installation
Installers
- Debian 64 bit / 32 bit (deb)
- Redhat 64 bit / 32 bit (rpm)
- Mac OS X 64 bit (pkg)
- Windows 64 bit / 32 bit (zip)
Binaries
Change Log
V3 app commands
This cf CLI release exposes app related features offered by the CC V3 APIs that were marked GA on 4 Aug 2017.
Features include the deployment and management of apps with multiple processes (defined in a Procfile), staging apps with multiple buildpacks, and uploading and staging multiple versions of a single app to enable a near-zero downtime app update experience.
Refer to the full list of commands here and details on how to configure multiple buildpacks here.
The new features are introduced using new commands starting with a "v3-" suffix.
- Some commands are mostly equivalent to existing app related commands but call the V3 APIs or expose new flags to unlock additional features.
- Other commands are new and expose the primitives of apps, such as operations on an app's packages and droplets.
We welcome your feedback on the new features, the user experience and the new workflows you may adopt.
Based on that, we will look at making commonly used v3 commands the default in a future release, with a migration plan for users targeting CF endpoints that do not support the GA'ed V3 APIs yet.
Please treat the "v3" commands as experimental - no guarantees are made about their availability or compatibility in subsequent cf CLI releases.
New commands
diesk@cloud-cf:~/workspace$ ./cf v3-<tab><tab>
v3-app v3-get-health-check v3-set-env
v3-apps v3-packages v3-set-health-check
v3-create-app v3-push v3-stage
v3-create-package v3-restart v3-start
v3-delete v3-restart-app-instance v3-stop
v3-droplets v3-scale v3-unset-env
v3-env v3-set-droplet
Notes on new commands
Take into consideration:
v3-pushfor now supports only a subset of features of "old" push. In particular, it does not support app manifests yet, nor any flags to set the stack or modify the default mapped route, nor applies exclusions from a.cfignorefile.
After pushing an app with this command, please usemap-route,bind-service,v3-set-env,v3-scale,v3-set-health-check, etc. to update its configuration.- For some app related commands (
ssh,bind-service, etc.) there is no "v3" version yet.
Please use the "old" command for now. - Although "v3" and "old" commands can be used together, some combinations may give unexpected results.
For example, if "v3" commands are used to create an app with a package but it is not staged, orv3-pushis used to push an app that fails to stage, it is not returned by the "old"appscommand.
SSL_CERT_FILE/SSL_CERT_PATH for self-signed API server certificate
Because Golang 1.9 added support for the environment variables SSL_CERT_FILE and SSL_CERT_PATH on Unix systems, it is now possible to use these when targeting a CF API endpoint that uses a self-signed certficate.
This is particularly useful in a CI environment without root access, where the existing method of registering the certificate in the local truststore is not possible. (#1084)
Note that this is supported since the previous cf CLI release (6.31.0).
Refactored commands
We are in the process of creating a more consistent user experience; our goal is to standardize UI output.
For example, warnings and errors will consistently be outputted to stderr instead of stdout and English table and key-value headers displayed in lowercase.
As we iterate through the list of commands, we are also focusing on improving performance and stability.
Please review your scripts if they depend on the output of these commands.
List of improved commands in this release:
- create-route
- orgs
- spaces