# @architect/deploy 中文文档

规范地址：https://npmcn.com/package/%40architect/deploy/

版本：7\.0\.3
npm 元数据更新时间：2026-03-03T19:04:13.418Z
中文译文更新时间：2026-11-06T14:31:03.872Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40architect/deploy
原文对照：https://npmcn.com/package/%40architect/deploy/?lang=original
项目主页：https://github.com/architect/deploy#readme
源码仓库：https://github.com/architect/deploy

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：134 kB，57 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：16 个
- 首次发布：2019-07-11T17:54:41.979Z
- 最新版本发布：2026-01-19T23:48:06.343Z
- 近 30 天下载量：11143（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：247（近 12 个月 7 个）

## 中文简介

部署@ architect 项目

## 安装

```sh
npm install @architect/deploy
```

也可以使用：`pnpm add @architect/deploy`、`yarn add @architect/deploy`、`bun add @architect/deploy`

## README

[![](https://assets.arc.codes/architect-logo-500b@2x.png)](https://www.npmjs.com/package/@architect/deploy)

## [`@architect/deploy`](https://www.npmjs.com/package/@architect/deploy)

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

[![GitHub CI status](https://github.com/architect/deploy/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/architect/deploy/actions?query=workflow%3A%22Node+CI%22+branch%3Amain)

## 安装

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

## 所需资源

你需要拥有 `sam` 命令行工具库 `$PATH`检查 [AWS 文档](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-install.html) 说明如何安装.

## 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` 弧向导](https://arc.codes/reference/static)) (中文(简体) ).

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

### `aws-sdk` 备注

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

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

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

## 常见问题

### @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 和提交记录判断。