@architect/deploy

中文文档
7.0.3发布于 2026/01/20Apache-2.0CommonJS构建来源已验证近 30 天下载 1.1万

部署@ architect 项目

中文使用文档
文档目录8 节
  1. @architect/deploy
  2. 安装
  3. 所需资源
  4. API 密码
  5. deploy.direct({ isDryRun, srcDirs }, callback)
  6. deploy.sam({ quiet, verbose, production }, callback)
  7. deploy.static({ bucket, credentials, fingerprint, prefix, p…
  8. aws-sdk 备注

@architect/deploy

用于向云基础设施部署应用程序的无服务器架构模块

GitHub CI status

安装

npm i @architect/deploy
let deploy = require('@architect/deploy')

所需资源

你需要拥有 sam 命令行工具库 $PATH检查 AWS 文档 说明如何安装.

API 密码

deploy.direct({ isDryRun, srcDirs }, callback)

将函数代码直接部署到一个或多个中转(或生产)环境 Lambdas 直接更新代码有效载荷。这对现场调试非常有用;通过直接部署进行的修改应被视为临时的.

deploy.sam({ quiet, verbose, production }, callback)

部署与您的 @ architect app 相关的所有基础设施 .

设定 quiet 用于压制部署进度和状态信息(来自更新系统)。 设定 verbose 用于实现详细输出,包括CloudFormation日志、文件操作细节和部署文物信息。 除非 production 真实的.

deploy.static({ bucket, credentials, fingerprint, prefix, prune, quiet, region, verbose, production }, callback)

所有参数都是可选的.

将静态资产从 public/ @ architect apps 到 S3 的文件夹, 由您的 @ architect apps 定义 .arc 文档。 尊重 fingerprint (单位:千美元)true 或者说 external, (中文(简体) ), prefix, (中文(简体) ), prune,以及 ignore 参数或 @static 实用程序指令(关于 @static 弧向导) (中文(简体) ).

除非 production 真实的。 设定 verbose 以启用聊天模式.

aws-sdk 备注

需要部署 aws-sdk; 包括先前的版本 aws-sdk 内 peerDependenciesnpm 7 之前不会自动安装 aws-sdk因为建筑师认为你已经 aws-sdk 或者如果你在Lambda里使用部署 可以在运行时使用.

然而,npm 7(再次)改变了 peerDependencies,现在自动安装全部 peerDependencies (而不是只打印出一个提醒) 这意味着任何使用部署的Lambdas,如果部署在有npm 7的机器上,就会得到一个>50MB依赖有效载荷.

因此,请确保 aws-sdk 安装在您的项目上, 或者在全球安装在您的机器上。 我们很遗憾把这个问题变成一个使用地问题,但我们认为这比不必要和隐蔽地造成问题更为可取 aws-sdk 在Lambdas中安装双安装,对冷起动时间产生消极影响并增加bug向量.

版本与发布记录

@architect/deploy 共发布 247 个版本,首次发布于 2019/07/12;过去 12 个月发布了 7 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
7.0.3latest2026/01/209 个月前
7.0.22026/01/169 个月前
7.0.12025/12/1610 个月前
7.0.02025/11/2811 个月前
7.0.0-RC.0RC2025/11/2611 个月前
6.0.12025/11/1411 个月前

关于 @architect/deploy 的常见问题

@architect/deploy 是什么?

部署@ architect 项目

如何安装 @architect/deploy?

在项目目录运行 npm install @architect/deploy,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 arc-deploy,可以用 npx arc-deploy 直接运行。

@architect/deploy 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/architect__deploy 是否存在。

@architect/deploy 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@architect/deploy 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@architect/deploy 可以商用吗?

@architect/deploy 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@architect/deploy 的下载量有多少?

根据 npm 官方下载统计,@architect/deploy 在 2026/10/07 – 2026/11/05 这 30 天内被下载 11,143 次,日均约 371 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@architect/deploy 还在维护吗?

最新版本 7.0.3 发布于 2026/01/20(9 个月前);至今共发布 247 个版本,其中过去 12 个月发布了 7 个;首次发布于 2019/07/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。