# @fjall/components-infrastructure 中文文档

规范地址：https://npmcn.com/package/%40fjall/components-infrastructure/

版本：39\.2\.2
npm 元数据更新时间：2026-11-15T12:15:06.716Z
中文译文更新时间：2026-11-14T20:55:15.821Z
软件包许可：SEE LICENSE IN LICENSE

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

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

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

- 包体积（解压后）：3.5 MB，595 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：5 个
- peer 依赖：aws-cdk ^2\.1134\.0，constructs ^10\.7\.2，aws-cdk-lib ^2\.265\.0
- 首次发布：2023-09-02T06:04:39.989Z
- 最新版本发布：2026-11-15T12:15:06.507Z
- 近 30 天下载量：9888（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：443（近 12 个月 208 个）

## 中文简介

已公布的fjall基础设施组件和公用事业.

## 安装

```sh
npm install @fjall/components-infrastructure
```

也可以使用：`pnpm add @fjall/components-infrastructure`、`yarn add @fjall/components-infrastructure`、`bun add @fjall/components-infrastructure`

## README

# Fjall基础设施

已公布的fjall基础设施组件和公用事业.

## 升级注释

### 21.0.0——按工作量类别划分的ClickHouse身份(破)

`ClickHouseDatabase` 不再共享一个 `schemaAdmin` 校长 迁移任务 计程门和保养侧车 每个工作量 阶级现在认证为自己的身份,所以没有两个阶级争夺 同样的 `max_concurrent_queries_for_user` 盖:

| 身份 | 持有者 |
| --- | --- |
| `schemaAdmin.name` (XML) (韩语) | 仅限迁移任务 |
| `fjall_schema_gate` (SQL) (英语) | 装有材料的大门容器 |
| `fjall_maintenance` (SQL) (英语) | 最终目标+备份任务 |

合成堆栈的变化 :

-   **应用程序容器丢失 `SCHEMA_ADMIN_USER` 编号 : `SCHEMA_ADMIN_PASSWORD`。 。 。 .** 他们 保留 `EXPECTED_CH_SCHEMA_VERSION`。运行自己的容器图像 正在处理中 ClickHouse 计划检查是否读取这两个变量 ——真材实料的门箱进行检查.
-   **大门容器认证为: `fjall_schema_gate`** 通过 `FJALL_SCHEMA_GATE_CH_USER` 编号 : `FJALL_SCHEMA_GATE_CH_PASSWORD` (只读, `SELECT` 打开 `<db>._schema_migrations` 页:1.
-   **POMIMIZE 和 PARPUP 计划任务认证为 `fjall_maintenance`。 。 。 .** 他们的执行角色读到身份的秘密, 不是计划管理员的 两种脚本都打开,有迁移的 QQ 维护 飞行前活动和记录 `fjall:maintenance:status=<ok|deferred|failed>` 标记; `status=failed` 通过新的页面 `ClickHouseMaintenanceFailedAlarm`。 。 。 .
-   **两个新定名的秘密管理者秘密** —— 说 `fjall/clickhouse/fjall-schema-gate-password` 财务报告和审定财务报表 `fjall/clickhouse/fjall-maintenance-password` ——由构件来铸造. 他们没有注入 ClickHouse 服务容器,所以 ClickHouse服务任务定义随升级变化.
-   **这个 `fjall_` 用户名前缀被保留.** A 类 `schemaAdmin.name` 或者说 `managedPasswords` 以 `fjall_` 无法合成 .

部署命令:身份由迁移者提供SQL (单位:千美元)`@fjall/clickhouse` 21 ——在此构造之前撞倒迁移图像),, 因此,迁移任务必须运行一次 低于21.x 之后任何认证 作为新的身份。 部署数据库堆栈,然后计算堆栈 完成移民任务,然后让时间表火上浇油.

回滚:回滚至20.x删除了两个框架机密,其中 机密管理器只计时( 30天恢复窗口) 。 重新采用 21.x 窗口内部的挂有名称失败 `aws secretsmanager restore-secret --secret-id fjall/clickhouse/<name>-password` 或者说 `aws secretsmanager delete-secret --secret-id … --force-delete-without-recovery` 两个秘密中的每一个.

## 有用命令

-   `npm run build` ——清理,捆绑Lambda资产并编译 TypeScript 到 `dist/`
-   `npm run watch` ——改革再编译
-   `npm test` - 运行Viest套房
-   `npm run typecheck` ——打字检查库

综合和部署 `fjall` CLI (中文(简体) )`fjall deploy`页:1 从应用程序组装堆栈 `fjall/` 目录。 软件包是 未部署 `cdk deploy` 独自一人.

## 使用构造

这些构筑物都是通过 `fjall` CLI: 爱丽丝 `fjall create app` 财务报告和审定财务报表 `fjall add <resource>` 写入 `infrastructure.ts` 由他们组成 `fjall deploy` 综合并部署. 每个构造也导出 从软件包根直接使用;参考活度为 [文件:fjall.io](https://docs.fjall.io/)。 。 。 .

## 许可证

专有——见 [自由主义](https://npmcn.com/package/%40fjall/components-infrastructure/LICENSE)。 。 。 .

## 常见问题

### @fjall/components-infrastructure 是什么？

已公布的fjall基础设施组件和公用事业\.

### 如何安装 @fjall/components-infrastructure？

在项目目录运行 npm install @fjall/components-infrastructure，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：aws-cdk（^2\.1134\.0）、constructs（^10\.7\.2）、aws-cdk-lib（^2\.265\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 infrastructure，可以用 npx infrastructure 直接运行。

### @fjall/components-infrastructure 支持 TypeScript 吗？

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

### @fjall/components-infrastructure 支持 ESM 还是 CommonJS？

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

### @fjall/components-infrastructure 需要什么版本的 Node\.js？

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

### @fjall/components-infrastructure 可以商用吗？

@fjall/components-infrastructure 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @fjall/components-infrastructure 的下载量有多少？

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

### @fjall/components-infrastructure 还在维护吗？

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