SuperAPI AI 工具集

vercel-deploy-button

部署与运维

查看项目

更新于 10-16 07:58

技能介绍

用途:Vercel Deploy Button 提供一键部署流程。用户点击按钮后,Vercel 展示项目创建流程,用户选择 GitHub/GitLab/Bitbucket 账户,Vercel 将源仓库克隆为其账户下的新仓库,填写环境变量并选择项目/仓库名后完成构建与部署;若设置 redirect-url,部署成功后跳回你的应用并附带回调参数。

主要能力:按钮可用 Markdown 或 HTML 嵌入,链接指向 https://vercel.com/new/clone。URL 参数包括:repository-url(必填,固定源仓库,可含子目录路径)、project-name、repository-name、stores(JSON 数组,支持 Blob 存储与 Marketplace 集成存储);环境变量参数 env(必填键列表)、envDefaults(非敏感默认值,键须出现在 env 中)、envDescription、envLink;回调参数 redirect-url、developer-id、external-id、production-deploy-hook;集成参数 integration-ids(最多 3 个)、skippable-integrations;演示卡片参数 demo-title、demo-description、demo-url、demo-image(四者齐全才显示)。所有参数值须 URI 编码。

使用方式:在页面中放置按钮链接即可。部署成功后 Vercel 向 redirect-url 追加 project-dashboard-url、project-name、deployment-dashboard-url、deployment-url、repository-url、production-deploy-hook-url 等查询参数。部署的应用可读取 Vercel 系统环境变量(如 VERCEL_GIT_PROVIDER、VERCEL_GIT_REPO_SLUG、VERCEL_GIT_REPO_OWNER、VERCEL_GIT_REPO_ID、VERCEL_URL、VERCEL_PROJECT_ID 等),用于将部署与后端资源关联;也可用 production-deploy-hook-url 触发重新部署。

适用场景:SaaS 产品向用户分发模板并需回连用户/组织记录;无头 CMS 内容变更后触发重部署。

限制:源必须是真实公开 Git 仓库,不能内联文件;始终克隆默认分支,无法选择分支;envDefaults 会出现在 URL 中,不可放密钥;env 值不能通过 URL 传递,须用户手动输入;repository-url 固定;project-name 仅为建议;部署失败不会触发回调。