用途:通过 Laravel Cloud 的 cloud CLI 部署和管理 Laravel 应用,适用于首次部署、已有应用发布、配置环境变量、创建基础设施资源、绑定自定义域名等场景。
安装与认证:composer global require laravel/cloud-cli,然后 cloud auth -n。
命令模式:命令遵循 CRUD 模式,如 resource:list、resource:get、resource:create、resource:update、resource:delete。可用资源包括 application、environment、instance、database-cluster、database、cache、bucket、domain、websocket-cluster、background-process、command、deployment 等,部分资源有额外命令(如 domain:verify、database:open、instance:sizes、cache:types)。不要硬编码命令签名,运行时用 cloud <command> -h 查看选项。
标志约定:所有命令加 -n 防止挂起;不要用 -q 或 --silent。读取用 --json -n;创建用 --json -n;更新用 --json -n --force;删除用 -n --force;环境变量用 -n --force;部署用 -n 并显式传全部选项。
部署流程:首次部署用 cloud ship -n;已有应用先 cloud repo:config,再 cloud deploy {app_name} {environment} -n --open,随后 cloud deploy:monitor -n。每次部署后都要运行监控,失败时先向用户展示错误。
远程访问:cloud tinker {environment} --code='...' --timeout=60 -n 执行 PHP 代码(需显式输出);cloud command:run {environment} --cmd='...' -n 执行 shell 命令,可用 command:list、command:get 查看历史。
用量查询:cloud usage --json -n,支持 --period、--environment、--detailed,金额单位为分。
配置:全局 ~/.config/cloud/config.json,仓库级 .cloud/config.json,CLI 参数优先级最高。
限制与注意:破坏性命令需先经用户确认;同一错误修复一次后仍失败应停止并询问用户;实例规格、区域、集群类型等未指定时需询问用户;长输出操作建议委派子代理以节省上下文。官方文档见 https://cloud.laravel.com/docs/llms.txt。