# @continuous-excellence/ze-great-dashboard-aws 中文文档

规范地址：https://npmcn.com/package/%40continuous-excellence/ze-great-dashboard-aws/

版本：0\.31\.63
npm 元数据更新时间：2026-11-10T00:48:40.388Z
中文译文更新时间：2026-11-10T17:00:40.573Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40continuous-excellence/ze-great-dashboard-aws
原文对照：https://npmcn.com/package/%40continuous-excellence/ze-great-dashboard-aws/?lang=original
项目主页：https://github.com/robertfmurdock/ze-great-dashboard#readme
源码仓库：https://github.com/robertfmurdock/ze-great-dashboard

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

- 包体积（解压后）：3.3 MB，24 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：3 个
- 首次发布：2026-08-19T01:28:37.035Z
- 最新版本发布：2026-11-10T00:48:39.976Z
- 近 30 天下载量：6209（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：182（近 12 个月 182 个）

## 中文简介

AWS服务器运行时间和CloudFormation部署工具用于Ze Great Dashboard.

## 安装

```sh
npm install @continuous-excellence/ze-great-dashboard-aws
```

也可以使用：`pnpm add @continuous-excellence/ze-great-dashboard-aws`、`yarn add @continuous-excellence/ze-great-dashboard-aws`、`bun add @continuous-excellence/ze-great-dashboard-aws`

## README

# AWS 上的 Ze Great Dashboard 游戏机

`@continuous-excellence/ze-great-dashboard-aws` aWS Lambda 用于验证和包装一块棋盘 或紧急部署。 它包括服务器运行时间、部署 CLI 和 Cloud Formation 模板。 匹配的永久浏览器客户端单独发布为 `@continuous-excellence/ze-great-dashboard-client` 自动选择,除非您提供 另一个精确的资产 URL.

此软件包适用于已经运行 AWS 并且能够提供受保护的入门路径的团队 :

-   Lambda 需要消费者拥有的 API 网关、 ALB 或具有私人引用的等同网关 允许.
-   ECS要求消费者拥有的子网、安全小组和保护负载平衡或路由 长寿的远门服务.

在两种模式中,消费者拥有的网关或负载平衡器定义了公共输入和认证 边界.

模板不创建公共端点, 不选择认证政策, 也不管理秘密 数值。 为了评价没有AWS的仪表板,从 [本地设置](https://github.com/robertfmurdock/ze-great-dashboard#try-it)。 。 。 .

## 先决条件

-   节点.js 22或更新,npm, AWS CLI,以及 `jq`。 。 。 .
-   一个一次性靴子陷阱的 AWS 管理员 .
-   一个先前存在的账户级 GitHub OIDC 提供者,并在 GitHub 时保护 GitHub 环境 行动将部署仪表板.
-   消费者拥有的网络、网关或负载平衡、认证和运行时间健康检查.

## 选择和拖曳计算模式

Lambda是兼容默认. 选择使用 `--mode ecs` 运行时 `bootstrap init`。 。 。 . 选择存储在 `dashboard-bootstrap.json` 生成的应用参数为 `ComputeMode`;没有字段的更老的文件意味着Lambda.

与持续配置相冲突的明确模式失败 。 Lambda与ECS之间的变化 需要重新生成、管理员审查的靴子和应用参数-它不是一个 常规软件包选项.

跟着 [AWS 拖带指南](https://github.com/robertfmurdock/ze-great-dashboard/blob/main/docs/aws-bootstrap.md), (中文(简体) ), 接下来 [Lambda 部署指南](https://github.com/robertfmurdock/ze-great-dashboard/blob/main/docs/aws-setup.md)。 。 。 .

## 装入部署

将已审查的软件包版本刻入拥有部署的仓库 :

```sh
npm install --save-exact @continuous-excellence/ze-great-dashboard-aws
```

附录 `@version` 安装先前审查的版本而不是当前版本。 之后 拖曳、生成和诊断应用参数,然后包装板:

```sh
npm exec -- ze-great-dashboard-aws parameters \
  --bootstrap-config dashboard-bootstrap.json \
  --output aws-dashboard-parameters.json

npm exec -- ze-great-dashboard-aws doctor \
  --parameters aws-dashboard-parameters.json \
  --region us-east-1

npm exec -- ze-great-dashboard-aws package \
  --board-config board.yaml \
  --parameters aws-dashboard-parameters.json \
  --output aws-dashboard-release
```

对于ECS,持续参数选择ECS模板 `package` 也需要永不改变, 消化器粘接图像通过 `--image`生成 `deployment.json` 包含结构化上传 和CloudFormation命令参数,用于引用已核准的部署进程.

`package` 写入特定版本 `parameters.json`, (中文(简体) ), `deployment.json`,以及 `template.yml`附加时 `lambda.zip` 为蓝巴达。 变化 `board.yaml` 或被绑定的软件包版本使用此路径. 运行只读 `bootstrap check` 在每次部署之前.

## 私人来源证书

公共 GitHub 寄存器和未经认证的 HTTP 来源在无证书的情况下工作。 私人服务 源, 设置 `SecretReference` jSON价值或 参数存储 `SecureString`,例如:

```json
{ "GITHUB_TOKEN": "github_pat_…" }
```

董事会参考 `GITHUB_TOKEN` 结束 `token_env`; 证书值从不属于 棋盘、靴子、云阵参数、运行时环境变量、日志、 API 回应,或浏览器。 运行时间只读取该程序授权的确切秘密或参数 应用程序角色, 解析已配置 `token_env` 名字只出现在 Lambda 冷起步, 且无法关闭 当键缺失时.

## 所有权界限

| 一揽子责任 | 消费者责任 |
| --- | --- |
| 董事会验证和释放包装 | 董事会内容和源权限 |
| 服务器运行时间和应用模板 | AWS 账户和网络管理 |
| 限制的靴子夹模板 | 审查和实施AWS 更改 |
| 默认永久客户端资产选择 | 核准替代资产主机 |
| 只读飞行前、医生和一致性检查 | 网关、认证和健康检查 |
| 精确的秘密资源整合 | 秘密值、 旋转和证书映射 ARN |

Bootstrap命令不执行变异的AWS操作. 他们发出计划,参数,捕获, 并命令管理员复核和引用参数. `bootstrap check` 仅读 在例行部署前使用的活性诊断;当失败时,使用 [靴子陷阱升级运行本](https://github.com/robertfmurdock/ze-great-dashboard/blob/main/docs/aws-bootstrap-upgrade.md)。 。 。 .

## 参考资料

-   [董事会配置](https://github.com/robertfmurdock/ze-great-dashboard/blob/main/docs/board-configuration.md)
-   [管理员拖网](https://github.com/robertfmurdock/ze-great-dashboard/blob/main/docs/aws-bootstrap.md)
-   [兰布达部署](https://github.com/robertfmurdock/ze-great-dashboard/blob/main/docs/aws-setup.md)
-   [GitHub 动作部署](https://github.com/robertfmurdock/ze-great-dashboard/blob/main/docs/aws-github-actions.md)
-   [问题跟踪器](https://github.com/robertfmurdock/ze-great-dashboard/issues)

## 常见问题

### @continuous-excellence/ze-great-dashboard-aws 是什么？

AWS服务器运行时间和CloudFormation部署工具用于Ze Great Dashboard\.

### 如何安装 @continuous-excellence/ze-great-dashboard-aws？

在项目目录运行 npm install @continuous-excellence/ze-great-dashboard-aws，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ze-great-dashboard-aws，可以用 npx ze-great-dashboard-aws 直接运行。

### @continuous-excellence/ze-great-dashboard-aws 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @continuous-excellence/ze-great-dashboard-aws 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @continuous-excellence/ze-great-dashboard-aws 需要什么版本的 Node\.js？

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

### @continuous-excellence/ze-great-dashboard-aws 可以商用吗？

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

### @continuous-excellence/ze-great-dashboard-aws 的下载量有多少？

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

### @continuous-excellence/ze-great-dashboard-aws 还在维护吗？

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