Skip to content

@a-b a-b released this Oct 2, 2020 · 566 commits to master since this release

Package Manager Installation

Installers

Binaries

Corresponding BOSH Release

Change Log

Bugs

  • Fix regression released in v6.52.0 whereby cf logout would 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.

Assets 2

@a-b a-b released this Sep 9, 2020 · 468 commits to master since this release

Package Manager Installation

Installers

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 downtime rolling deployment strategy which means both versions of the app will be running in parallel during the rollback.

Enhancements

  • deployable boolean added to cf revisions output
  • revisions now shows an extra warning when revisions for that app are disabled - story
  • revisions now 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 app output issue # 1971
    • Add buildpack details in tabular format to cf push output
  • 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 push error messaging on manifest type errors issue #1983

Known Issues

  • a regression of cf logout when no API is targeted, causing it to exit with a non-zero exit code was introduced in cf CLI v7.0.2. This causes cf logout to 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.

Assets 2

@a-b a-b released this Aug 26, 2020 · 566 commits to master since this release

Package Manager Installation

Installers

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).

Assets 2
Jul 24, 2020
Revert "Remove dead code (#1987)"
This reverts commit f024eef.
This reverts commit 9ced0ec.
This reverts commit 7ff90cc.

@jpalmerpivotal jpalmerpivotal released this Jul 28, 2020 · 499 commits to master since this release

Package Manager Installation

Installers

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 rolling
  • v3-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.

Assets 2

@a-b a-b released this Jun 25, 2020 · 516 commits to master since this release

Package Manager Installation

Installers

Binaries

Change Log

  • Fix package management versioning issue

Known Issues

  • Windows binary zip files do not include a symbolic link from cf7 -> cf due to lack of .zip support 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).
Assets 2

@a-b a-b released this Jun 25, 2020 · 518 commits to master since this release

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

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, and copy-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 --hostname and -d flags on push and associated manifest properties.
  • Removed --route-path and --no-hostname flags on push
  • Removed rename-buildpack command in favor of --rename flag on update-buildpack command
  • Removed --random-port flag from create-route and map-route commands. 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 stderr instead of stdout
  • Required flag arguments are now positional arguments
  • Optional positional arguments are now flag arguments
  • cf restage no longer results in a audit.app.restage audit 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 -> cf due to lack of .zip support 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.

Assets 2

@reid47 reid47 released this Apr 8, 2020 · 810 commits to master since this release

Package Manager Installation

Installers

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.

Assets 2

@a-b a-b released this Mar 4, 2020 · 960 commits to master since this release

Package Manager Installation

Installers

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 --recent errors 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.

Assets 2
Pre-release
Pre-release

@reid47 reid47 released this Feb 24, 2020 · 1023 commits to master since this release

Package Manager Installation

Installers

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-quotas is now backed by the v3 API story
  • set-space-quota is now backed by the v3 API story
  • unset-space-quota is now backed by the v3 API story
  • delete-space-quota is now backed by the v3 API story
  • ssh-enabled is now backed by the v3 API story
  • space-ssh-allowed is now backed by the v3 API story
  • allow-space-ssh is now backed by the v3 API story
  • disallow-space-ssh is now backed by the v3 API story
  • api is 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 space command output story
  • Add --quota flag to create-space story

Documentation

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

Assets 2
You can’t perform that action at this time.