v6.3.0

CF version v6.3.0

Installers

• Debian 32 bit
• Debian 64 bit
• Redhat 32 bit
• Redhat 64 bit
• Mac OS X 64 bit
• Windows 32 bit
• Windows 64 bit

Binaries

• Linux 32 bit binary
• Linux 64 bit binary
• Mac OS X 64 bit binary
• Windows 32 bit binary
• Windows 64 bit binary

Change Log

• Add commands for security groups (creating, editing, assignment to spaces)
• push no longer uses deprecated endpoint for domains. [#74737286]
• cf always returns exit code 1 on error [#74565136]
• Json is interpreted properly for create/update user-provided-service. Fixes issue #193 [#73971288]
• Made '--help' flag match the help text from the 'help' command [Finishes #73655496]

CF version v6.2.0

CF version v6.2.0

Installers

• Debian 32 bit
• Debian 64 bit
• Redhat 32 bit
• Redhat 64 bit
• Mac OS X 64 bit
• Windows 32 bit
• Windows 64 bit

Binaries

• Linux 32 bit binary
• Linux 64 bit binary
• Mac OS X 64 bit binary
• Windows 32 bit binary
• Windows 64 bit binary

Change Log
##########

Internationalize the CLI

The Cloud Foundry CLI added support for translating CLI output into other languages. While the support has been added, many of these languages have not been translated. Please refer to the i18n ReadMe located under the cf/i18n directory for more information and how to help with the translation process.

[Finishes #70551274, #71441196, #72633034, #72633034, #72633036, #72633038, #72633042, #72633044, #72633056, #72633062, #72633064, #72633066, #72633068, #72633070, #72633074, #72633080, #72633084, #72633086, #72633088, #72633090, #72633090, #72633096, #72633100, #72633102, #72633112, #72633116, #72633118, #72633126, #72633128, #72633130]
Additional tickets needed for supporting internationalization:
[Finishes #70551274, #71347218, #71441196, #71594662, #71801388, #72250906, #72543282, #72543404, #72543994, #72548944, #72633064, #72633108, #72663452, #73216920, #73351056, #73351056]

'purge-service-offering' should fail if the request fails

[Finishes #73009140]

Pretty print JSON for cf curl

[Finishes #71425006]

CURL output can be directed to file via parameter --output.

[Finishes #72659362]

Fix a source of flakiness in start

The problem here was that we made it possible for the error returned by the api to be ignored if the staging timeout is set to an incredibly short duration.

Moving the error check outside of the for loop is just crazy enough to work.
[Finishes #71778246]

Add build date time to the --version message, cf --version now reports ISO 8601 date

This is the date-time that the binary was built in our CI environment
[Finishes #71446932]

Show system environment variables with cf env

The biggest change here is that we are also expecting to return the VCAP_SERVICES hash. Realistically we'll only ever get this if the change that the services team recently made to CloudController is actually present.

We believe that returning these two objects separately is the best bet for now. The VCAP_SERVICES hash will be pretty printed, but the user hash will not be (for the time being).

[Finishes #71250896]

Fix double confirm prompt bug

[Finishes #70960378]

Fix create-buildpack from local directory

[Finishes #70766292]

Gateway respects user-defined Async timeout

[Finishes #71039042]

Bump async timeout to 10 minutes

[Finishes #70242130]

Trace should also respect the user config setting

[Finishes #71045364]

Add a 'cf config' command

Currently only allows setting the timeout for async requests to Cloud Controller, but we anticipate adding more soon.
[Finishes #70242276]

Add a hook for setting color from the config

Uses --color value to enable/disable/ignore coloring
[Finishes #71045474, #68903282]

Add config --trace flag

[Finishes #68903318]

Pivotal Tap for Homebrew installs (Experimental)

Previously, the CLI could be installed via the central homebrew repository. Recently the restrictions placed on the formula in that became too onerous to continue hosting it there. The formula is now hosted in the Pivotal Tap. This change updates the documentation with instructions on how to add the Pivotal Tap and install the CLI from it.

This method for installing CLI is experimental and subject to change in the future.

v6.1.2

CF version v6.1.2

Installers

• Debian 32 bit
• Debian 64 bit
• Redhat 32 bit
• Redhat 64 bit
• Mac OS X 64 bit
• Windows 32 bit
• Windows 64 bit

Binaries

• Linux 32 bit binary
• Linux 64 bit binary
• Mac OS X 64 bit binary
• Windows 32 bit binary
• Windows 64 bit binary

Change Log

Document build process

[Finishes #70608194]

Always flush message queue when tailing logs

Downsides: there is now a global variable for how long we buffer
messages. This seems nicer than having to pass it along, because we
need to construct a priority queue when the log repo is initialized (or
at least, we felt that we needed to).

[Finishes #70788884]

Update README instructions for checking out the repo

My hope is that explaining how to get started with the repo will make it easier for
other contributors. These steps assume some basic knowledge of git and GO, but the
only way we will improve this documentation is to start improving it today and continue
to be sympathetic to pain the community feels in the future.

[Finishes #70686778]

Always zero-out the size of directories for resource matching

If you don't, then cloud controller gives you a nasty crash.

ALSO apparently you can never rely on the size of a directory being zero
if you're using the windows syscall GetFileAttributesEx.

(and golang's stdlib does use this syscall)

[Finishes #70470232] #157

Make requests to UAA about users more intelligently

This very simple change prevents us from making a request with an empty
filter that might return all of the users in the space.

[Finishes #70051880, 70130480]

Always zero-out the size of directories for resource matching

If you don't, then cloud controller gives you a nasty crash.

ALSO apparently you can never rely on the size of a directory being zero
if you're using the windows syscall GetFileAttributesEx.

(and golang's stdlib does use this syscall)

[Finishes #70470232] #157

Start removing more global state

It's been more than a little disappointing that we've had assertions in
our tests that rely on a global bool in a testhelper package. Changing
this for one test now so that we have a pattern to abide by later. My
hope is that we can root out the rest of these one by one.

[Finishes #68922816]

Make requests to UAA about users more intelligently

This very simple change prevents us from making a request with an empty
filter that might return all of the users in the space.

[Finishes #70051880, 70130480]

Merge pull request #159 from fraenkel/org_quota

Display the entire org quota information

[Finishes #70490234]

Refresh auth token for 'cf logs' when it expires.

[Finishes #66242222]

v6.1.1

CF version v6.1.1

Installers

• Debian 32 bit
• Debian 64 bit
• Redhat 32 bit
• Redhat 64 bit
• Mac OS X 64 bit
• Windows 32 bit
• Windows 64 bit

Binaries

• Linux 32 bit binary
• Linux 64 bit binary
• Mac OS X 64 bit binary
• Windows 32 bit binary
• Windows 64 bit binary

Change Log

• New quota CRUD commands for admins
• Only ignore manifest.yml at the app root directory [#70044992]
• Updating loggregator library experimental support for proxies [#70022322]
• Provide a --sso flag to cf login for SAML [#69963402, #69963432]
• Do not use deprecated domain endpoints in cf push [#69827262]
• Display X-Cf-Warnings at the end of all commands [#69300730]
• Add an actor column to the cf events table [#68771710]

v6.1.0

CF version v6.1.0

Installers

• Debian 32 bit
• Debian 64 bit
• Redhat 32 bit
• Redhat 64 bit
• Mac OS X 64 bit
• Windows 32 bit
• Windows 64 bit

Binaries

• Linux 32 bit binary
• Linux 64 bit binary
• Mac OS X 64 bit binary
• Windows 32 bit binary
• Windows 64 bit binary

Change Log

Major changes and fixes in v6.1.0:

• Refresh auth token at the beginning of 'cf push' [#69034628]
• 'cf routes' should have an org and space requirement [#68917070]
• Fix a bug with binding services in manifests [#68768046]
• Make delete confirmation messages more consistent [#62852994]
• Don't upload manifest.yml by default [#68952284]
• Ignore mercurial metadata from app upload [#68952326]
• Make delete commands output more consistent [#62283088]
• Make create user command idempotent [#67241604]
• Allow 'cf unset-env' to remove the last env var an app has [#68879028]
• Add a datetime for when the binary was built [#68515588]
• Omit application files when CC reports all files are staged [#68290696]
• Show actual error message from server on async job failure [#65222140]
• Use new domains endpoints based on API version [#64525814]
• Use different events APIs based on API version [#64525814]
• Updated help text and messaging
• Events commands only shows last 50 events in reverse chronological order [#67248400, #63488318, #66900178]
• Add -r flag to delete command for deleting all the routes mapped to the app [#65781990]
• Scope route listed to the current space [#59926924]
• Include empty directories when pushing apps [#63163454]
• Fetch UAA endpoint in auth command [#68035332]
• Improve error message when memory/disk is given w/o unit [#64359068]
• Only allow positive instances, memory or disk in the push and scale commands [#66799710]
• Allow passing "null" as a buildpack url for "cf push" [#67054262]
• Add disk quota flag to push cmd [#65444560]
• Add a script for updating links to stable release [#67993678]
• Suggest using random-route when route is already taken [#66791058]
• Prompt user for all password-type credentials in login [#67864534]
• Add random-route property to manifests (push treats this the same as the --random-hostname flag) [#62086514]
• Add --random-route flag to push command [#62086514]
• Fix create-user when UAA is being directly used as auth server (if the authorization server doesn't return an UAA endpoint link, assume that the auth server is the UAA, and use it for user management) [#67477014]
• 'cf create-user' hides private data in CF_TRACE [#67055200]
• Persist SSLDisabled flag on config [#66528632]
• Respect --skip-ssl-validation flag [#66528632]
• Hide passwords in CF_TRACE [#67055218]
• Improve 'cf api' and 'cf login' error message around SSL validation errors [#67048868]
• In api command, fail if protocol not specified and ssl cert invalid [#67048868]
• Clear session at beginning of auth command [#66638776]
• When renaming targetted org, update org name in config file [#63087464]
• Make target command clear org and space when necessary [#66713898]
• Add a -f flag to scale to force [#64067896]
• Add a confirmation prompt to scale command [#64067896]
• Verify SSL certs when fetching buildpacks [#66365558]
• OS X installer errors out when attempting to install on pre 10.7 [#66547206]
• Add ability to scale app's disk limit [#65444078]
• Switch out Gamble for candied yaml [#66181944]

v6.0.2

• Fixed cf push -p path/to/app.zip on windows with zip files (eg: .zip, .war, .jar)

cf v6.0.1

Here's a list of features and fixes in v6.0.1 maintenance release:

• Added purge-service-offering and migrate-service-instances commands
• Added -a flag to org-users command that makes the command display all users, rather than only privileged users (#46)
• Fixed a bug when manifest.yml was zero bytes
• Improved error messages for commands that reference users (#79)
• Fixed crash when a manifest didn't contain environment variables but there were environment variables set for the app previously
• Improved error messages for commands that require an API endpoint to be set
• Added timeout to all asynchronous requests
• Fixed 'bad file descriptor' crash when API token expired before file upload
• Added timestamps and version information to request logs when CF_TRACE is enabled
• Added fallback to default log server endpoint for compatibility with older CF deployments
• Improved error messages for services and target commands
• Added support for URLs as arguments to create-buildpack command
• Added a homebrew recipe for cf -- usage: brew install cloudfoundry-cli

cf v6.0.0

cf v6 is the next version of the Cloud Foundry command line client.

If you've been using the beta releases, the final release of v6 includes three of the most requested features: native installers on all major platforms (links below), cf curl (at last), and support for manifests. cf push with a manifest has two notable caveats:

1. cf v6 no longer creates services from the manifest, however it will bind to existing services. Update your manifest like so:

---
services:
- service_1
- service_2

1. Symbols such as $random-word and $target-base, as well as any other custom DSLs, are not currently supported.

Documentation is the final stages of completion -- links to come. In the meantime, use cf help to see a list of commands or append -h to any individual command to see its help.

cf v6 beta2

This updated beta is for Cloud Foundry release 152 and up.

Changes:

• many bug fixes and general flushing out of command options.
• list commands such as gcf orgs now handle paginated api responses
• Manifests: setting basic fields on a single application is now supported via a feature flag. Set the env var CF_MANIFEST=true to enable manifests. Once support for manifests is complete, this will no longer be necessary.

cf v6 beta

The public beta of cf v6 is ready to download. During the beta period, the executable will be named gcf instead of cf. If you would prefer to completely switch to gcf now, you can use an alias to cf.

After an estimated four to six week beta period for community feedback, and once the application manifest work in cf v6 is complete, we will deprecate the Ruby cf v5 cli. At that point, cf v6 commands will be changed to use cf.

Installation instructions
Getting started overview

Run gcf help to view documentation all commands.

We're always looking for feedback (so please open issues) or fixes (so please open pull requests).