Cloud Foundry CLI

Cloud Foundry CLI

Cloud Foundry 的官方命令行客户端。

查看 v8 CLI 或 v7 CLI 的最新帮助，或运行 cf help -a 查看当前已安装版本中所有可用命令的帮助。

CF CLI 二进制文件下载服务的正常运行时间：

---

章节： 开始使用 | 下载 | 已知问题 | 缺陷/功能请求 | 插件开发 | 参与贡献

---

开始使用

从 下载部分下载并安装适用于 v8 cf CLI 的 cf CLI。

安装后，即可登录并推送应用。 目前受支持的 cf CLI 版本：

1. v8 cf CLI 基于 v3 CC API（插件除外）。详情请参阅我们的 v8 文档。

注意：v7 和 v6 CLI 版本不再维护或发布。

请查看我们的 CLI v7 和 v8 版本与支持政策文档。

如有任何问题，欢迎在 Slack 社区的 #cli 频道提问，也可在 cf-dev 邮件列表中交流，或提交 GitHub 问题。

参与贡献和构建说明

请阅读贡献者指南

如需提交更新后的翻译，请参阅 i18n README，了解如何提交更新。

查看我们的社区贡献的 CLI 插件，进一步提升 CLI 使用体验。

下载

安装说明

• 安装 V8
• 安装 V7（已弃用——不再维护）
• 在多个版本之间切换

已知问题

注意： 如需获取问题和解决方法的最新信息，请查看未解决和已解决的 GitHub 问题

• 在 Windows 的 Cygwin 和 Git Bash 中，交互式密码提示（在 cf login 中）无法正确隐藏 stdout 中的密码（问题 #1835）。请使用其他命令来解决此问题（使用非交互式身份验证 cf auth，而不是 cf login）。或者，使用 Windows cmd 命令行。
• 在 Windows 上，如果未设置 TERM，cf ssh 可能无法正确显示。我们发现，将 TERM 设置为 msys 可以解决其中一些问题。
• 在 Windows 上，从 MINGW32 或 MINGW64 shell 运行 cf ssh 时会卡住。解决方法是改用 PowerShell。
• CF CLI/GoLang 不使用 OpenSSL。要在不使用 --skip-ssl-validation 的情况下执行 login/auth，必须将自定义/自签名证书安装到特定位置。
• 将 API 跟踪输出到终端（使用 CF_TRACE=true、-v 选项或 cf config --trace）与某些 CLI 插件命令配合时效果不佳。跟踪输出到文件则正常。在 Linux 上，CF_TRACE=/dev/stdout 也可以使用。详情请参阅此 Diego-Enabler 插件问题。
• cf push 使用的 .cfignore 必须采用 UTF-8 编码，CLI 才能正确解析。（问题 #281）
• 在 Linux 上，如果遇到消息 "bash: .cf: No such file or directory"，请确认你使用的是适用于你架构的正确二进制文件或安装程序。
• X-Cf-Warnings 会通过 stdout 打印。如果这会造成不便，你可以设置 CF_RAISE_ERROR_ON_WARNINGS，此时警告会通过 stderr 打印。请参阅 X-Cf-Warnings 通过 stdout 打印的问题
• 创建用户组织时会出现错误的失败消息。CLI v7.0 和 CLI v7.1 中，启用了 user-org-creation 功能标志的非管理员用户运行 cf create-org 时会遇到失败。该命令会在尝试为用户授予 org-manager 角色时明确报错。但实际上操作已成功，因为 CAPI 已为用户授予 org-manager 角色，因此用户可以访问其组织。此问题已在 CLI v7.2 中解决。请参阅创建新组织并分配角色时 v2/v3 行为不一致。

提交问题和功能请求

首先，更新到最新的 cli， 然后再次尝试运行该命令。

如果错误仍然存在，或缺少所需功能，请查看未解决的问题；如果尚未有人提出，请提交新问题并提供所需详情。

插件开发

CF CLI 支持通过插件 API 执行外部代码。更多信息请参阅：

• CF CLI 插件开发指南
• 官方插件仓库

导入插件代码时，请使用 import "code.cloudfoundry.org/cli/v9/plugin"。 导入 github.com/cloudfoundry/cli/plugin 的旧版插件仍可正常工作， 前提是它们将 plugins 目录 vendoring。