SuperAPI AI 工具集

shopify-deploy-integration

部署与运维

查看项目

更新于 10-15 23:29

技能介绍

用途:把 Shopify 应用部署到常见托管平台,并完成环境配置、Webhook URL 设置与扩展部署。

前提条件:应用已用 shopify app dev 在本地测试通过;已安装目标平台 CLI(vercel、fly 或 gcloud);准备好生产 API 凭据;已配置 shopify.app.toml。

主要能力与用法:

  1. 用 Shopify CLI 部署扩展与同步应用配置:shopify app deploy 会上传主题应用扩展、函数扩展以及应用配置(URL、权限范围、Webhook),但不托管 Web 应用本身,Web 应用需单独托管。
  2. Vercel:设置环境变量,配置 vercel.json 以处理 Webhook 和函数超时,并用 Vercel URL 更新 shopify.app.toml。
  3. Fly.io:在 fly.toml 中配置健康检查和最小实例数,用 fly secrets set 设置密钥后部署。
  4. Cloud Run:使用多阶段 Dockerfile 减小镜像体积,用 gcloud run deploy 部署,并通过 Secret Manager 配置密钥。
  5. 部署后验证:运行健康检查,确认 Webhook 端点无 HMAC 时返回 401,测试 OAuth 启动,并同步应用配置。

环境变量清单:所有部署需要 SHOPIFY_API_KEY、SHOPIFY_API_SECRET、SHOPIFY_SCOPES、SHOPIFY_APP_URL;自定义/私有应用需要 SHOPIFY_ACCESS_TOKEN(shpat_xxx);可选 SHOPIFY_API_VERSION、SESSION_SECRET、DATABASE_URL。

适用场景:将已本地验证的 Shopify 应用发布到生产托管平台,并确保 Webhook、OAuth 与应用 URL 正确同步到 Shopify Partner Dashboard。

限制与常见问题:OAuth 重定向不匹配需更新 shopify.app.toml 中的 redirect_urls 并重新部署;Webhook 收不到需检查 URL 是否为 HTTPS 且可访问;冷启动超时可设置最小实例数为 1;CSP frame-ancestors 报错需为 *.myshopify.com 添加 CSP 头;shopify app deploy 失败通常是 CLI token 失效,需在 partners.shopify.com 重新生成。

资料未提供具体价格、收费或平台名额等信息。