cloudfoundry/cli v7.0.0-beta.26

on GitHub

Important 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

• apt-get, yum, homebrew

Installers

• Debian 64 bit / 32 bit (deb)
• Redhat 64 bit / 32 bit (rpm)
• Mac OS X 64 bit (pkg)

Binaries

• Linux 64 bit / 32 bit (tgz)
• Mac OS X 64 bit (tgz)

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 story
• rename app command story
• staging-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 story
• disable-ssh story
• delete-user story

Enhancements:

• support for setting, unsetting, listing, and querying for labels for the following resources: apps, spaces, orgs, buildpacks, and spaces epic
  • set-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 and delete-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 and cf 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 from 5 to 6 seconds to avoid race conditions story

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 and delete-route now correctly exits 0 if the resource does not exist story and story

Bug Fixes for Push:

• --path on cf 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