Skip to content
This repository has been archived by the owner on Jun 2, 2021. It is now read-only.

Latest commit

 

History

History
97 lines (70 loc) · 6.13 KB

README.md

File metadata and controls

97 lines (70 loc) · 6.13 KB

CF logo

Cloud Foundry CLI

The official command line client for Cloud Foundry.

View the latest help for The v7 CLI -OR- The v6 CLI, or run cf help -a to view the help for all commands available in your currently installed version.

GitHub version Documentation Command help pages Slack License

CF CLI Binary Download Server's uptime:

Downloads Uptime


Sections: Getting Started | Download | Known Issues | Bugs/Feature Requests | Plugin Development | Contributing


Getting Started

Download and install the cf CLI from the Downloads Section for either the v7 cf CLI or the v6 cf CLI.

Once installed, you can log in and push an app. There are now two supported versions of the cf CLI:

  1. The v7 cf CLI is backed by the v3 CC API (with the exception of plugins which will be migrated in the next major release). See our v7 documentation for more information.
  2. The v6 cf CLI is backed by the v2 CC API See our v6 documentation for more information.

View our CLI v6 & v7 Versioning and Support Policy documentation.

If you have any questions, ask away on the #cli channel in our Slack community and the cf-dev mailing list, or open a GitHub issue.
You can follow our development progress on Core CF CLI Pivotal Tracker.

Contributing & Build Instructions

Please read the contributors' guide

If you'd like to submit updated translations, please see the i18n README for instructions on how to submit an update.

Example

Check out our community contributed CLI plugins to further enhance your CLI experience.

Downloads

Installation instructions

Known Issues

  • On Windows in Cygwin and Git Bash, interactive password prompts (in cf login) do not hide the password properly from stdout (issue #1835). Please use an alternative command (non-interactive authentication cf auth instead of cf login) to work around this. Or, use the Windows cmd command line.
  • On Windows, cf ssh may not display correctly if the TERM is not set. We've found that setting TERM to msys fixes some of these issues.
  • On Windows, cf ssh will hang when run from the MINGW32 or MINGW64 shell. A workaround is to use PowerShell instead.
  • CF CLI/GoLang do not use OpenSSL. Custom/Self Signed Certificates need to be installed in specific locations in order to login/auth without --skip-ssl-validation.
  • API tracing to terminal (using CF_TRACE=true, -v option or cf config --trace) doesn't work well with some CLI plugin commands. Trace to file works fine. On Linux, CF_TRACE=/dev/stdout works too. See this Diego-Enabler plugin issue for more information.
  • .cfignore used in cf push must be in UTF-8 encoding for CLI to interpret correctly. (issue #281)
  • On Linux, when encountering message "bash: .cf: No such file or directory", ensure that you're using the correct binary or installer for your architecture.

Filing Issues & Feature Requests

First, update to the latest cli and try the command again.

If the error remains or feature still missing, check the open issues and if not already raised please file a new issue with the requested details.

Plugin Development

The CF CLI supports external code execution via the plugins API. For more information follow:

When importing the plugin code use import "code.cloudfoundry.org/cli/plugin". Older plugins that import github.com/cloudfoundry/cli/plugin will still work as long they vendor the plugins directory.