v7.0.0-beta.26
Pre-releaseImportant Note: A regression has been reported by some users regarding cf login
. We are currently reviewing this issue and are likely to release a patch.
Note: this release does not include the Windows installer because we are in the middle of renewing the certificate. We are currently working to include the Windows installer in the next release. Please reach out on Slack Cloud Foundry #cli if you have feedback or questions.
Installation
Note: V7 beta binaries will be called cf7
to allow for coexistence with V6 cf
binaries.
Package Manager Installation
Installers
Binaries
Compatibility
Tested against CC API Release Candidate v1.87.0-rc.73.
Change Log for 7.0.0-beta.26
v3 CC API Resources and backing v7 beta cf CLI commands
Additional the cf7 CLI v7 beta commands backed by the v3 CC API include:
delete-service-broker
storyrename
app command storystaging-environment-variable-group
story - System environment variables can only be strings. This is enforced now on the API. See the Upgrade Guide.running-environment-variable-group
story - System environment variables can only be strings. This is enforced now on the API. See the Upgrade Guide.enable-ssh
storydisable-ssh
storydelete-user
story
Enhancements:
- support for setting, unsetting, listing, and querying for labels for the following resources:
apps
,spaces
,orgs
,buildpacks
, andspaces
epicset-label
,unset-label
,labels
, and resource specific querying on the listing commands specified above- see official documentation for usage
- support for displaying a sidecar if it exists story. Users are able to add a sidecar to an app process using an app manifest. Now the cf CLI will display the sidecar along with process it is attached to.
cf restart
now supports a--strategy rolling
flag which allow users to use a rolling deployment strategy story- see official documentation for usage
- Since usernames are not unique, users with the same name can exist in different external identity providers. This release supports a new flag on
login
anddelete-user
:--origin
which allow users to disambiguate the user and identity provider they want to log in to or delete story - Adds a deprecation warning to
cf login
andcf auth
for custom clients. In CLI V7, we are encouraging users to adopt the client credential workflow because it is more secure (secrets are not written to the config). story and story - If you are not logged in and attempt to run commands, now a slightly more verbose output appears to prompt the user to run either
'cf login' or 'cf login --sso' to log in.
. story -
- the
CF_DIAL_TIMEOUT
default has been updated from5
to6
seconds to avoid race conditions story
- the
CF Login Refactor
See release notes for v6.47.0 for details.
Deprecation of custom client workflow
See release notes for v6.47.0 for details.
Changes to Exit Codes
- applies the principles of idempotent commands:
delete-space
anddelete-route
now correctly exits0
if the resource does not exist story and story
Bug Fixes for Push:
--path
oncf push
supports absolute and relative path story- updates a permissions error message for
cf push
story - given a bad start command,
cf push
no longer exits if the process is still in the starting state story - updates
cf push
help text to include the--no-manifest
flag story --health-check-type
and--endpoint
flag options now correctly overrides its equivalent app manifest properties story story
Other Bug Fixes:
- per the cf CLI's style guide, we updated the
cf space
command to include the isolation segment field, even when the field is empty story delete-shared-domain
now correctly returns an error if you attempt to delete a private domain story- adds a helpful
TIP
if you attempt to enable ssh for an app when ssh has been disabled either at the space or global level story create-buildpack
will now retry if attempting to create a large buildpack and the fresh token is about to expire story
Gotchas (anything I should watch out for since this is a beta release?)
- help text updates are still required for querying labels for a given resource (
cf7 apps
, etc)
Documentation
- Official Cloud Foundry documentation notes for v7 beta - includes information about breaking changes and feature development work available on v7
- ADR for
push
- Additional cf CLI v7 beta release notes for releases v7.0.0-beta.23 and older
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: Eli Wrenn, Reid Mitchell, Piyali Banerjee, Greg Cobb, Supraja Narasimhan, Abby Chau, Michelle He, Mona Mohebbi, Brian Cunnie, Teal Stannard, Merric de Launey, Seth Boyles
CF CLI - v7 Feature Development Contributors: Brendan Smith, Andrew Crump, Abby Chau, Eric Promislow, Alexander Berezovsky, Steve Taylor, Jenna Goldstrich
Services API/CLI Contributors: Oleksii Fedorov, Aditya Tripathi, George Blue, Felisia Martini