SuperAPI AI 工具集

cf-cli

部署与运维

查看项目

更新于 11-03 16:15

技能介绍

用途

该技能用于辅助使用 Cloud Foundry CLI(cf CLI v8)完成日常平台操作:构造正确的 cf 命令、编写 manifest.yml、自动化应用部署、管理服务实例与绑定,并排查运行时问题。资料说明 v6/v7 已不再维护,应始终使用 v8 语法,v8 CLI 由 CC API v3 支撑。

安装与认证

可从 V8 安装指南安装,支持包管理器(Homebrew、apt、yum、Chocolatey)或直接下载二进制;用 cf version 验证。

认证相关命令包括:

  • cf api 设置 API 端点,支持 --skip-ssl-validation(仅用于开发/自签名证书);
  • cf login 交互式登录,支持 -a、-u、-p、-o、-s、--sso、--sso-passcode、--origin 等参数;
  • cf auth 用于脚本和 CI/CD 的非交互认证,支持 --client-credentials(读取 CF_USERNAME 与 CF_PASSWORD 环境变量);
  • cf target 切换组织与空间;cf logout 退出。

应用生命周期与管理

核心命令是 cf push(别名 p),支持指定路径、manifest、buildpack、实例数、内存与磁盘、健康检查类型、随机路由、滚动部署策略、Docker 镜像、变量替换等。资料列出关键 flags,并说明 CF_DOCKER_PASSWORD、CF_STAGING_TIMEOUT、CF_STARTUP_TIMEOUT 等推送相关环境变量。

应用管理命令包括 cf apps、cf app、cf start/stop/restart/restage、cf delete(含 -f、-r)、cf rename、cf scale。部署与回滚方面有 --strategy rolling 与 cf cancel-deployment。

可观测性与运维操作

  • 日志与事件:cf logs(实时/--recent)、cf events;
  • SSH:cf ssh(可指定实例索引、执行命令并退出),以及 enable/disable/ssh-enabled;
  • 任务:cf run-task、cf tasks、cf terminate-task;
  • 环境变量:cf env、cf set-env、cf unset-env,修改后需 restage 或 restart 生效;
  • 健康检查:cf get-health-check、cf set-health-check(http/port/process);
  • 包与 droplet:cf packages、cf droplets、cf set-droplet、cf download-droplet、cf stage-package。

Manifest

manifest.yml 用于声明应用配置,cf push 会自动读取当前目录中的该文件。资料给出包含内存、磁盘、实例数、buildpack、命令、健康检查、栈、环境变量、路由、服务与多进程的示例,并说明变量替换(--var、--vars-file)以及用 cf create-app-manifest 从运行中的应用生成 manifest。

服务管理

服务市场方面有 cf marketplace(-e/-s 查看计划)。服务实例支持创建(可带参数与标签)、更新、升级、删除、重命名;绑定与解绑用 cf bind-service/cf unbind-service,绑定后凭据注入 VCAP_SERVICES,需 restage 生效。服务密钥(service key)可在不绑定应用的情况下获取凭据。用户提供服务的创建可用交互式或 JSON 方式(cf cups),支持 syslog drain 与 route service;另有 cf update-user-provided-service、服务共享(cf share-service/cf unshare-service)与路由服务绑定(cf bind-route-service)。

路由与域名

域管理包括 cf domains、私有域与共享域的创建/删除、cf router-groups。路由方面支持列表、详情、创建(含内部路由与路径)、映射/取消映射、删除、清理孤立路由与检查路由是否存在。

组织、空间与权限

支持组织与空间的列表、详情、创建、删除、重命名;cf apply-manifest 将 manifest 应用到当前空间;空间级 SSH 开关;组织用户与空间用户查询;组织角色(OrgManager、BillingManager、OrgAuditor)与空间角色(SpaceManager、SpaceDeveloper、SpaceAuditor、SpaceSupporter)的设置与取消。

管理与高级命令

管理命令涉及 buildpack、网络策略、安全组、组织配额与空间配额、特性开关。高级命令包括 cf curl(直接调用 v3 API,用于自动化与调试)、cf config(trace、颜色、locale)、cf oauth-token。资料还列出 CF_HOME、CF_TRACE、CF_COLOR、CF_DOCKER_PASSWORD、CF_STAGING_TIMEOUT、CF_STARTUP_TIMEOUT、CF_DIAL_TIMEOUT 等环境变量。

插件与 MTA 部署

插件管理支持列出、安装(本地路径、URL、仓库名)、卸载、插件仓库管理。MTA/CAP 应用通过 multiapps 插件以 .mtar 归档部署,使用 cf deploy(区别于 cf push):资料给出检查并安装 mbt 与 multiapps 插件的脚本,以及 mbt build 后 cf deploy mta_archives/<app>_1.0.0.mtar 的流程。

适用场景与限制

适用于使用 Cloud Foundry 平台的开发、运维与 CI/CD 场景。资料未提供收费、价格、平台支持范围、效果评估等信息;部分命令细节与完整参数请以官方文档和 cf help 为准。