Embarko Deploy 用于把应用部署到 Embarko 托管环境。Embarko 会托管应用并提供 <app-name>.embarko.app 形式的线上地址,自动从源码构建,不需要 Dockerfile,也不需要构建配置。
用途与部署方式 该技能新增的核心内容是 scripts/deploy.sh,由它完成整个部署流程。用法包括:./scripts/deploy.sh 部署当前目录;./scripts/deploy.sh path/to/app 部署指定目录;./scripts/deploy.sh . other-name 使用其他应用名部署。脚本会打包应用、命名并版本化、上传、等待构建完成,然后输出线上 URL;部署前还会检查 Embarko 是否可达,以及应用是否使用不受支持的存储。资料明确要求不要用自己的 tar/curl 调用替代该脚本。只有在脚本以退出码 0 结束后才能报告线上 URL。首次未提供 token 的部署会是临时应用(24 小时),脚本会打印领取链接(==> Keep it),打开并登录即可保留应用,该链接只打印一次。首次部署后脚本会把应用 id 写入 embarko.json 的 appId,后续部署即使名称在仪表盘中被修改也会指向同一应用;复制应用代码新建应用时应先删除 appId,否则会因 app_id_mismatch 被拒绝。可选环境变量包括 EMBARKO_AGENT_NAME、EMBARKO_APP_TYPE 和 DEPLOY_TOKEN;脚本会先查 DEPLOY_TOKEN,再查 ~/.embarko/credentials,已保存的 token 不应再次向用户索要或打印。
定时任务 若需要在固定时间执行任务(如每周一 9 点、每晚),应使用 schedules 而非 cron 库或 crontab,且需要部署 token。任务放在 GET 路由中(例如 /tasks/weekly-report),成功时返回 2xx,需要持久化的数据放在 DATA_DIR 下。该路由首行需校验 Authorization 为 Bearer + process.env.CRON_SECRET,否则返回 401。在应用顶层目录的 embarko.json 中按用户时区配置 schedules,部署后脚本会对每个 schedule 各运行一次并打印 ok 或错误,需修复并重新部署直到全部 ok。该文件是应用的完整计划列表,修改后重新部署生效,"schedules": [] 表示全部移除;不得在其中放入密钥。
集成面板 当应用用户需要 Slack、Google Sheets、CRM 等外部服务时,可开启 Integrations,应用会获得嵌入的集成面板(基于 viaSocket 预制嵌入),用户可自行连接工具并构建流程。需要部署 token,应用必须已被领取,静态站点不可使用。通过 curl 调用 ship.embarko.ai 的 integrations 接口并传 {"apply": true} 开启;会设置 INTEGRATIONS_ORG_ID、INTEGRATIONS_PROJECT_ID、INTEGRATIONS_SECRET 三个环境变量。随后按 viaSocket 技能文档构建面板,下载其 skill.md 到 .claude/skills/viasocket-integrations/SKILL.md 并遵循;在 Embarko 上应使用 INTEGRATIONS_* 变量替代 viaSocket 文档中的 VIASOCKET_* 变量,不得硬编码,也不得把 secret 发送到浏览器。409 integrations_disabled_for_workspace 表示工作区未开启集成,Embarko 已邮件通知所有者,应告知用户且不要重试,直到用户确认已开启;502 可重试。
文件存储 每个应用都有文件存储:PUT 字节内容,返回公开链接,直到文件被删除。适合用户打开或下载的文件(照片、PDF、导出、站点图片),记录数据仍放在 DATA_DIR 下的 SQLite。从终端使用部署 token 调用 ship.embarko.ai/storage 接口(应用须已领取),返回 201 及 id、url、sizeBytes、contentType;可列出、查询用量、删除。从应用内部调用时,Embarko 会为每个服务端应用设置 STORAGE_URL、STORAGE_TOKEN,应用名在 APP_NAME 中,应从环境读取,不得硬编码或打印。文件对任何持链接者公开。
Showcase 与异常处理 有图片的 Showcase 列表打开率更高;若用户没有截图,可提议截取线上应用、上传并放入 screenshotUrls。若 scripts/deploy.sh 缺失,按 quickstart 文档用两条命令完成相同的部署;若脚本提示 Embarko 不可达,说明环境阻止了访问,应按 prerequisites 文档中的路由给出修复建议。该技能的其余说明(如何回复用户、应用运行要求如 PORT、0.0.0.0、DATA_DIR、无 Dockerfile、错误码、领取、告警、embarko.json、密钥/域名/日志/回滚/重命名/删除等)均以 Embarko 的 agent guide 为唯一副本,按需查阅对应文档主题。