Releases: cloudfoundry/cli
v7.2.0
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
Bugs
- Logout is idempotent story
- CF Scale works on stopped apps issue
- CLI doesn't fail listing large numbers of apps issue
- CLI doesn't fail on login in certain Windows environments issue
cf network-policiescan query in spaces with many apps issue- CLI fails informatively when Cloud Controller fails without an error issue
Features
- Add
cf revisionsstory- this initial iteration of the rollback command is experimental. Additional changes should be expected in the near-term v7 releases.
- Improved
cf revisionshelp text story - Improve
cf revisions: annotate which revision is deployed story - Improve
cf revisions: tell user if app is stopped story - Improvements to
cf rollback
Contributors
Nick Webb, Lisa Burns, James Palmer, Alex Berezovsky, Josh Collins, Jenna Goldstrich, Steve Taylor,
Sebatian Vidrio, Sarah Weinstein, Harsha Nandiwada, George Blue, Derik Evangelista, Teal Stannard
Note: The minimum version of the CC API this CF CLI release is compatible with is CC API v3.85.0.
See our minimum supported version policy for more information.
v6.53.0
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
Corresponding BOSH Release
Change Log
Bugs
- Fix regression released in v6.52.0 whereby
cf logoutwould exit non-zero when run without an api being targeted - issue
Contributors
Lisa Burns, James Palmer, Nick Webb, Jenna Goldstrich, Alexander Berezovsky, Steve Taylor, Josh Collins
Note: The minimum version of the CC API this CF CLI release is compatible with is CC API v2.128.0.
See our minimum supported version policy for more information.
v7.1.0
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
Compatibility
Tested against CC API Release Candidate capi-1.99.0-rc.33.
Change Log
FEATURE
cf rollback- user can rollback to a previous app revision story- this initial iteration of the rollback command is experimental. Additional changes should be expected in the near-term v7 releases.
IMPORTANT NOTE: rollbacks are executed using the zero downtimerollingdeployment strategy which means both versions of the app will be running in parallel during the rollback.
- this initial iteration of the rollback command is experimental. Additional changes should be expected in the near-term v7 releases.
Enhancements
deployableboolean added tocf revisionsoutputrevisionsnow shows an extra warning when revisions for that app are disabled - storyrevisionsnow has several different header titles on the output table, and now revisions are shown in descending order - story- Add buildpack details in tabular format to
cf appoutput issue # 1971- Add buildpack details in tabular format to
cf pushoutput
- Add buildpack details in tabular format to
- Improve misleading error message when un-sharing service-instances issue #1936
- Add logic to revoke auth and refresh tokens on CLI logout when revocable flag for UAA is present
- Improved
cf pusherror messaging on manifest type errors issue #1983
Known Issues
- a regression of
cf logoutwhen no API is targeted, causing it to exit with a non-zero exit code was introduced in cf CLI v7.0.2. This causescf logoutto not be idempotent. The fix can be tracked here.
Contributors:
CLI Team:
James Palmer, Nick Webb, Jenna Goldstrich, Alexander Berezovsky, Steve Taylor, Josh Collins, Lisa Burns, Sebastian Vidrio
VAT Team:
Teal Stannard, Merric de Launey, Sarah Weinstein, Mona Mohebbi, Renee Chu, Chris Selzo, Reid Mitchell, Harsha Nandiwada, Greg Cobb
SAPI Team:
Aditya Tripathi, Brian Butz, Derik Evangelista, Emina Cosic, Marcela Campo, Urse Searle, Winna Bridgewater, Felisia Martini, George Blue
Other OSS Contributors:
Olivier Lechevalier, Xinhu Liu, Oliver Rand
Note: The minimum version of the CC API this CF CLI release is compatible with is CC API v3.85.0. See our minimum supported version policy for more information.
v6.52.0
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
FEATURE
- Legacy plugins use Log Cache - story
NOTE: We bumped the config as part of the implementation. CLI users that had targeted and logged into their foundations prior to updating to this CLI version may be required to to re-login & target in order to initialize the updated config.
Enhancements
- Invalidate UAA auth and refresh tokens on logout
- Add logic to revoke tokens on CLI logout when revocable flag for UAA is present
- Improved redaction in UAA verbose logging
- If UAA provides standard prompts (Email, Password) then the CLI can translate
them into the user's locale; else will display the prompt provided by UAA platform
operator.- Thanks @frodenas for PR'ing the sample translation for Spanish
- Provide localized prompt if sso is misconfigured - story
Bugs
- Lowercase hostname in
map-route- story - Correct an issue with the update-service command where command was removing the tags on service when no tags were provided.
Contributors:
James Palmer, Nick Webb, Jenna Goldstrich, Alexander Berezovsky, Steve Taylor, Josh Collins, Andrew Crump, Olivier Lechevalier, Xinhu Liu, Lisa Burns, Sebastian Vidrio
Note: The minimum version of the CC API this CF CLI release is compatible with is CC API v2.100.0 (3.35).
- See our minimum supported version policy for more information.
v7.0.2
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
Bug Fixes
- Double encode name parameters in requests to CAPI #1938
- Fixes known issue from previous release
v7.0.1-- regression in the login behavior where failures occur on certain cf-deployments which use alternative login paths other than UAA #1964 - Allow empty space characters in app names #1966
Deletions
Remove leftover, experimental v3-zdt- commands
These commands were meant to be removed, since they have been replaced by the following commands
v3-zdt-restart->restart --strategy rollingv3-cancel-zdt-push->cancel-deployment
Contributors: James Palmer, Nick Webb, Jenna Goldstrich, Alexander Berezovsky, Steve Taylor, Josh Collins, George Blue, Belinda Liu, Reid Mitchell, Sarah Weinstein
Note: The minimum version of the CC API this CF CLI release is compatible with is CC API v3.85.0. See our minimum supported version policy for more information.
v7.0.1
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
- Fix package management versioning issue
Known Issues
- Windows binary zip files do not include a symbolic link from
cf7 -> cfdue to lack of.zipsupport for symbolic links on Windows. - There's been a regression in the login behavior where failures occur on certain cf-deployments which use alternative login paths other than UAA (this has been resolved in v7.0.2).
v7.0.0
Alert:
There was an issue with the packaging of this initial v7.0.0 release. Please use v7.0.1 instead.
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
Compatibility
Minimum API Version: 3.85.0 (cf deployment v13.5.0)
Change Log
For a detailed overview of v7 and upgrade guide, see https://docs.cloudfoundry.org/cf-cli/v7.html
New Features
- Support for rolling app deployments for
push,restart,restage, andcopy-source - Support for pushing apps with multiple processes
- Support for pushing apps with sidecar processes
- New command:
create-app - New command:
packages - New command:
create-package - New command:
stage-package - New command:
droplets - New command:
set-droplet - New command:
apply-manifest - New command:
cancel-deployment - New command:
labels - New command:
set-label - New command:
unset-label
Deprecations
- Dropped all support for DEAs
- Dropped all support for v1 service brokers
- Removed
--hostnameand-dflags onpushand associated manifest properties. - Removed
--route-pathand--no-hostnameflags onpush - Removed
rename-buildpackcommand in favor of--renameflag onupdate-buildpackcommand - Removed
--random-portflag fromcreate-routeandmap-routecommands. This is now the default behavior.
Other Changes
- Most commands have received minor, stylistic changes to improve readability and consistency between commands.
- Errors are output to
stderrinstead ofstdout - Required flag arguments are now positional arguments
- Optional positional arguments are now flag arguments
cf restageno longer results in aaudit.app.restageaudit event- Some command names have been updated. The old names are preserved as aliases.
Known Issues
- Windows binary zip files do not include a symbolic link from
cf7 -> cfdue to lack of.zipsupport for symbolic links on Windows. - Login does not work in certain non-cf-deployment environments due to inconsistent endpoint behavior.
Contributors
The release of v7 was only possible due to the hard work of folks on the cf CLI team, V3 Acceleration Team, Services API team, and many other teams. Below are a list of some folks from these and other teams that did the hard work to make v7 happen.
Piyali Banerjee, Alexander Berezovsky, Alex Blease, George Blue, Seth Boyles, Connor Braa, Florian Braun, Winna Bridgewater, Andrew Brown, André Browne, Marcela Campo, Abby Chau, Renee Chu, Greg Cobb, Josh Collins, Emina Cosic, Andrew Crump, Brian Cunnie, Tim Downey, Derik Evangelista, Daniel Fein, Oleksii Fedorov, Weyman Fung, Anand Gaitonde, Jenna Goldstrich, Nick Guerette, Leah Hanson, Spencer Hawley, Michelle He, Chris Hendrix, Sannidhi Jalukar, Rob Jones, Mike Kenyon, Aarti Kriplani, Merric de Launey, Joao Lebre, Diego Lemos, Belinda Liu, Georgi Lozev, Will Martin, Felisia Martini, Niki Maslarski, Nikolay Maslarski, Andres Medina, Reid Mitchell, Mona Mohebbi, Magesh Murali Kumar, Will Murphy, Harsha Nandiwada, Supraja Narasimhan, Joseph Palermo, James Palmer, Will Pragnell, Eric Promislow, Zach Robinson, Luan Santos, Simon Seif, Chris Selzo, Alex Shan, Brendan Smith, Henry Stanley, Teal Stannard, Steve Taylor, Aditya Tripathi, Sebastian Vidrio, Thomas Viehman, Nicholas Webb, Sarah Weinstein, Eli Wrenn
We would not be here without our dedicated users, especially their pull requests, issues, and the time given for user interviews and discussions. Your feedback has been invaluable. We look forward to more feedback from y'all as we move forward.
Thank you for using the cf CLI and for being so passionate about our app.
v6.51.0
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
Go 1.13.8
The cf CLI is now build with Golang 1.13.8 story
Bug Fixes
-
Increased resiliency to log cache streaming log loss on foundations with multiple log cache doppler nodes story
-
cf logs --recent lost logs if there are more than 4 MB of logs story
-
cf logs now properly retries getting logs on connection failure to the logging API story
-
Requests to Log Cache were not logged in the same format as other HTTP requests in the cf CLI story
Known Issues
-
There is a known log cache issue on cf-deployment versions 7.0.0 through 9.5.0 (fixed in v10.0.0) where if a user pushes a new app very quickly after performing another logging action (less than a minute between) the API will fail to retrieve the logs for this new app, this typically occurs during the app staging process and will not prevent the app from successfully staging. Our recommended way to avoid this is to deploy at least cf-deployment 10.0.0
-
Experimental commands (those marked as v3-.. such as v3-zdt-push) do not stream logs from Log Cache. No logs will be shown when these commands are run against a foundation that does not have traffic controller enabled. This should not impact the results of the command
-
Log-cache-cf-auth-proxy does not support HS256. In CF CLI v6.50.0, we have moved over to using the log cache exclusively for log retrieval. If you have configured your UAA to use anything other than RS256, the log cache auth proxy does not know how to decode the UAA's tokens and will return 404. This is expected to be fixed in an upcoming log-cache release, so compatibility will be restored in a future cf-deployment version.
Contributors: Brendan Smith, Andrew Crump, Alexander Berezovsky, Steve Taylor, Eric Promislow, Jenna Goldstrich, Chris Hendrix, Nicholas Webb, Reid Mitchell, Josh Collins
Note: The minimum version of the CC API this CF CLI release is compatible with is CC API v2.128.0 (3.63.0). See our minimum supported version policy for more information.
v6.50.0
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
Required TLS version is now 1.2
The cf CLI will now only negotiate TLS 1.2 connections. The cipher suites are restricted to those recommended by the Mozilla SSL Configuration Generator. For a full list of supported ciphers see the Cloud Foundry tlsconfig repo. story
Support for Log Cache
The cf CLI now streams logs from Log Cache instead of the soon to be deprecated Traffic Controller, Log Cache provides more stability to larger foundations, as well as reduced IAAS costs story
Fixed support window in CLI
The cf CLI will now properly warn users when using an incompatible CC API version (anything less than cf-deployment 7.0.0) story
Known Issues
-
For foundations with multiple log cache nodes: when streaming application staging logs, some log messages may be missing from the staging output. Those messages are subsequently available via
cf logs --recent. -
There is a known log cache issue on cf-deployment versions 7.0.0 through 9.5.0 (fixed in v10.0.0) where if a user pushes a new app very quickly after performing another logging action (less than a minute between) the API will fail to retrieve the logs for this new app, this typically occurs during the app staging process and will not prevent the app from successfully staging. Our recommended way to avoid this is to deploy at least cf-deployment 10.0.0
-
Experimental commands (those marked as v3-.. such as v3-zdt-push) do not stream logs from Log Cache. No logs will be shown when these commands are run against a foundation that does not have traffic controller enabled. This should not impact the results of the command
-
cf logs --recenterrors if there is > 4MB of logs returned (story). This is expected to be fixed in an upcoming release. Until then, our recommended mitigation is to use up to CF CLI v6.49.0 -
Log-cache-cf-auth-proxy does not support HS256. In CF CLI v6.50.0, we have moved over to using the log cache exclusively for log retrieval. If you have configured your UAA to use anything other than RS256, the log cache auth proxy does not know how to decode the UAA's tokens and will return 404. This is expected to be fixed in an upcoming log-cache release, so compatibility will be restored in a future cf-deployment version. Until then, our recommended mitigation is to use up to CF CLI v6.49.0
Contributors: Brendan Smith, Andrew Crump, Alexander Berezovsky, Steve Taylor, Eric Promislow, Jenna Goldstrich, Christopher Hendrix
Note: The minimum version of the CC API this CF CLI release is compatible with is CC API v2.128.0 (3.63.0). See our minimum supported version policy for more information.
v7.0.0-beta.30
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
Compatibility
Tested against CC API Release Candidate 1.92.0-rc.14.
Change Log
v3 CC API Resources and backing v7 beta cf CLI commands
space-quotasis now backed by the v3 API storyset-space-quotais now backed by the v3 API storyunset-space-quotais now backed by the v3 API storydelete-space-quotais now backed by the v3 API storyssh-enabledis now backed by the v3 API storyspace-ssh-allowedis now backed by the v3 API storyallow-space-sshis now backed by the v3 API storydisallow-space-sshis now backed by the v3 API storyapiis now backed by the v3 API story
Support for Log Cache API
- Resolved Clock Skew gotcha from last release, we now grab logs from log cached based on foundation system time to avoid client clock skew story
Enhancements:
- Changed supported TLS window to only negotiate secure versions of TLS (1.2) story
- Switched back to using the same plugin API the v6 CLI uses story
- Show applied quota in
spacecommand output story - Add
--quotaflag tocreate-spacestory
Documentation
- Official Cloud Foundry documentation notes for v7 beta - includes information about breaking changes and feature development work available on v7
- ADR for
push
Feedback
Do you have feedback or a bug report for the cf CLI v7 beta? Please file a GitHub issue, or reach out on Cloud Foundry Slack #v3-acceleration-team.
V3 Acceleration Team Core Contributors to v7 CLI beta: Reid Mitchell, Greg Cobb, Supraja Narasimhan, Mona Mohebbi, Brian Cunnie, Teal Stannard, Merric de Launey, Belinda Liu, Weyman Fung, Nick Guerette, Sarah Weinstein
CF CLI - v7 Feature Development Contributors: Brendan Smith, Andrew Crump, Eric Promislow, Alexander Berezovsky, Steve Taylor, Jenna Goldstrich
Services API/CLI Contributors: Oleksii Fedorov, Aditya Tripathi, George Blue, Felisia Martini