cloudfoundry/cli v6.38.0 on GitHub

Package Manager Installation

apt-get, yum, homebrew

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

Linux 64 bit / 32 bit (tgz)
Mac OS X 64 bit (tgz)
Windows 64 bit / 32 bit (zip)

Change Log

Changes to the `cf app` Display

In late June, we sent out a survey to ask the community their opinion on changing the cf app display. Buoyed by your feedback, we decided to move forward with changing the cf app display such that it is backed by the v3 app api endpoint. story

Users on CC API 3.27.0 or higher will see the new display; primary changes include:

app instance information is broken down by process type. See information about using procfiles and how to manage multi processes via a procfile
if you are using multiple buildpacks, the new cf app display will list all the buildpacks for your app

Notes:

users on CC API 3.27.0 or lower will continue to see the previous cf app display
the start command will only appear if the api provides it
details no longer appears in the app display table
if your app is in a crashed state, information for requested_state and instances no longer appear highlighted in red text
if you use the v3-set-droplet command and you do not immediately restage your app, the last_uploaded time will reflect the last time your app was restaged, not when you set the droplet
cf v3-app has been removed as a result of this work as it is now a redundant command
the new cf app summary at the end of the cf push output will also appear for users on cc api 3.27 or higher (note: commands (cf-start, cf-scale, cf-restart, cf-restage) where cf app appear will change in an upcoming release)
plugins will continue to see the previous (non-v3) app display regardless of API version.

Invocation Timeout Configuration

App devs on cc api 3.43.0 or higher can now use v3-set-health-check to set per invocation timeouts for http and port health checks for individual health checks. story. See documentation for more details.

Upgraded to Golang 1.10.3

This release bumps the CLI to use Golang 1.10.3. See the Golang release notes for more information.

Support for SOCKS5

Adds SOCKS5 support for cf v3-ssh (Note: SOCKS5 is not supported for the cf ssh command). See the Using the CF CLI with a Proxy Server documentation for more information. story

Multiple Buildpacks Support

Previously, pushing with multiple buildpacks, required you to use a combination of "v2" and "v3" commands. Now, if you are using CC API 3.25 or above, you can push with multiple buildpacks by either passing in multiple -b flags, or use the new buildpacks field in the manifest.

Note:

If you are using cc api 3.25, you will not see multiple buildpacks when you use the cf app command - upgrade to cc api 3.27 or higher to see multiple buildpacks displayed in the new app display
The buildpack field has been deprecated as a result of this work.
In some cases, buildpacks must be specified in a particular order, see the documentation below and this link for more information
buildpacks reflects the app buildpack, not the buildpack used if you have used the v3-set-droplet commands
If you are using multiple buildpacks as a manifest property to cf push, note that this new feature is not supported with deprecated manifest properties.

See documentation for more information.

Enhancements

v3-ssh process type now defaults to web story
Support added for setting tags for user provided service instances story
Now a warning appears if you attempt to use deprecated properties and variable substitution story
Updated usage so now you can rename the cf binary use it with every command story
cf events now displays the Diego cell_id and instance guid in crash events story
Includes cf service service-instance table display improvements wherein the service instance information is now grouped separately from the binding information story
cf service service-instance table display information for user provided services changed: status has been added to the table story

New Translations

New translations are included in this release. Big thanks to IBM who contributed updated translations of CLI output and help text. As the update came in mid-release and a number of message strings changed since, you may find some untranslated messages (in particular in the help pages). story

Bug Fixes

the CLI now properly handles escaped commas in the X-Cf-Warnings header

Deprecations

the buildpack field in the manifest has been deprecated in favour of buildpacks.

Plugin Updates

Updated CF Dev plugin #235
Updated copy env plugin #236
Updated Mysql Tools plugin #237
Updated report users plugin #238
Updated maven-push plugin #239
Updated drains plugin #241
Updated create service push plugin #244

Contributors: An Yu, Sebastian Vidrio, Anande Gaitonde, Thomas Viehman, Alex Zhao, Abby Chau, Spencer Hawley, Renee Chu, Nick Guerette

Special Guests: Dies Koper (for helping us test SOCK5 support), SAPI London team (for tags support for user provided services and help updating the cf service service-instance table), Dr. Max and the IBM team (for translation updates).