# @bugcrowd/ecs-deployment-monitor 中文文档

规范地址：https://npmcn.com/package/%40bugcrowd/ecs-deployment-monitor/

版本：0\.3\.6
npm 元数据更新时间：2025-12-19T01:27:32.098Z
中文译文更新时间：2026-11-08T19:09:45.971Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bugcrowd/ecs-deployment-monitor
原文对照：https://npmcn.com/package/%40bugcrowd/ecs-deployment-monitor/?lang=original

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

- 包体积（解压后）：247 kB，65 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：9 个
- 首次发布：2021-08-25T10:08:47.261Z
- 最新版本发布：2025-11-25T05:14:12.597Z
- 近 30 天下载量：4226（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 1 个）

## 中文简介

监测紧急部署

## 安装

```sh
npm install @bugcrowd/ecs-deployment-monitor
```

也可以使用：`pnpm add @bugcrowd/ecs-deployment-monitor`、`yarn add @bugcrowd/ecs-deployment-monitor`、`bun add @bugcrowd/ecs-deployment-monitor`

## README

# ECS 部署监测器

ECS部署监测员将帮助你监测向ECS处部署新任务定义的情况。 它不能自行部署.

它的主要用途是确定何时部署失败。 当任务中的容器未能启动时,ECS会终止任务并开始新的任务. 在您的应用程序版本无法启动之前, 这是一个伟大的功能 。 在这种情景下,ECS将继续无限期地开始并停止任务,同时使你没有比你部署失败更明智,你的应用程序的旧版本仍在运行.

该监测器利用目标群体目标的健康状态来确定一项任务是否健康。 因此,假定使用应用程序负载平衡器或网络负载平衡器,没有这个显示器,这个显示器就无法工作.

## 安装

与国家预防机制安装软件包. **注:** 我们把包裹移到我们下面了 `bugcrowd` 国家预防机制组织 -- -- 这将是维持的唯一一揽子地点 继续前进.

`npm install @bugcrowd/ecs-deployment-monitor --save`

删除 `--save` 并添加 `-g` 如果您想要使用 CLI 版本, 则要向全球安装 .

确保您以下列 IAM 权限运行监视器 :

```
ecs:DescribeContainerInstances
ecs:DescribeServices
ecs:DescribeTasks
ecs:ListContainerInstances
ecs:ListTasks
elasticloadbalancing:DescribeTargetHealth
```

## 可能的部署国

### 无果

未找到匹配任务定义的部署

### 未显示

新部署已经建立。 这一部署已不再部署.

### 已创建

已经建立部署,但没有开展其他活动.

### 任务开始

新的任务已经开始,但还没有健康.

### 任务失败

未启动的任务数已超过设定的失败阈值 。 默认25%.

### 现场直播

如应用程序载重平衡器上的目标所报告,所有新任务都处于健康状态。 带有旧任务定义修订的工作仍在运行中 .

### 排水

新的请求将不再用于旧的任务 。 旧任务正在耗尽.

### 稳住

ECS服务已进入稳定状态

## CLI 使用量

如果在全球安装此模块, 则执行文件 `ecs-deployment-monitor` 应可用

### 选项

-   组群(需要) - 托管服务的ECS组群
-   服务名称( 需要) - ECS 服务的名称
-   任务定义(需要) -- -- 已部署的ECS任务定义
-   失败阈值(可选) - 触发失败部署的预期任务的失败任务百分比。 默认为25%。 等待着浮出水面 语法 `.50` 代表50%的门槛值

```
$ ecs-deployment-monitor \
    --cluster xxx \
    --service-name xxx \
    --task-definition xxx
```

### 示例输出

![standard-requests](https://npmcn.com/package/%40bugcrowd/ecs-deployment-monitor/docs/deploy-successful.png)

### 部署失败

![standard-requests](https://npmcn.com/package/%40bugcrowd/ecs-deployment-monitor/docs/deploy-fail.png)

部署失败后,将使用非零退出代码退出。 下列州被失败部署:

-   任务失败将退出, 退出代码为 1
-   NotFound将退出,退出代码为2
-   Usurped 将退出,退出代码为 3

## 模块使用

```js
const monitor = require('ecs-deployment-monitor');

let deployment = monitor({
  serviceName: 'name',
  clusterArn: 'arn::cluster',
  taskDefinitionArn: 'arn::task-definition',
});

deployment.on('error', (error) => console.log(error));
deployment.on('state', (state) => console.log(state));
deployment.on('end', (state) => console.log('DONE'));

```

## 常见问题

### @bugcrowd/ecs-deployment-monitor 是什么？

监测紧急部署

### 如何安装 @bugcrowd/ecs-deployment-monitor？

在项目目录运行 npm install @bugcrowd/ecs-deployment-monitor，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ecs-deployment-monitor，可以用 npx ecs-deployment-monitor 直接运行。

### @bugcrowd/ecs-deployment-monitor 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bugcrowd\_\_ecs-deployment-monitor 是否存在。

### @bugcrowd/ecs-deployment-monitor 支持 ESM 还是 CommonJS？

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

### @bugcrowd/ecs-deployment-monitor 可以商用吗？

@bugcrowd/ecs-deployment-monitor 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bugcrowd/ecs-deployment-monitor 的下载量有多少？

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

### @bugcrowd/ecs-deployment-monitor 还在维护吗？

最新版本 0\.3\.6 发布于 2025/11/25（11 个月前）；至今共发布 24 个版本，其中过去 12 个月发布了 1 个；首次发布于 2021/08/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。