@adaptiveworx/iac-schemas

中文文档
0.1.6发布于 2026/10/04Apache-2.0TypeScriptES Module零依赖构建来源已验证近 30 天下载 2504

每个供应商的区域代码和名称,以及标准标记键,用于AdaptiveWorXTM基础设施-as-code. 纯数据+类型——无运行时间依赖.

中文使用文档
文档目录10 节
  1. 安装
  2. 使用量
  3. 区域决议
  4. 输入的区域数据
  5. 标准标签密钥
  6. 直接导入 JSON
  7. 什么样的船
  8. 稳定
  9. 许可证
  10. 仓库+捐款

@ 适应worx/iac- schemas

每个提供者的区域代码和名称以及标准标记键,用于 适应WorXTM 流 (原始内容存档于2019-09-31) (英语). staff-as-code.

这个软件包是 纯数据+类型 ——零运行时间依赖. 这是全区域解析真相的来源 @adaptiveworx/iac-* 包并安全地从任何 TypeScript 项目导入.

安装

pnpm add @adaptiveworx/iac-schemas
# or
yarn add @adaptiveworx/iac-schemas
# or
npm install @adaptiveworx/iac-schemas

使用量

区域决议

import { regions } from "@adaptiveworx/iac-schemas";

// AWS region aliases
regions.aws.aliases.use1; // "us-east-1"
regions.aws.aliases.usw2; // "us-west-2"

// Azure region aliases
regions.azure.aliases.eus2; // "eastus2"

// Available canonical regions per provider
regions.aws.regions; // ["us-east-1", "us-west-2", ...]

// Cloudflare (no regions): the single code glb
regions.cloudflare.aliases.glb; // "global"

输入的区域数据

import { AWS_REGION_CODES, AWS_REGION_NAMES, REGIONS } from "@adaptiveworx/iac-schemas";
import type { AwsRegionCode, AwsRegionName } from "@adaptiveworx/iac-schemas";

REGIONS.aws.aliases.use1; // "us-east-1", typed as the literal
const code: AwsRegionCode = "usw2";

REGIONS (单位:千美元)src/regions.ts)是区域数据的唯一来源;iac-core 来源 AwsRegion 财务报告和审定财务报表 AwsRegionSchema 从它. config/regions.json 实值 与JSON相同的数据,通过单位测试保持等值.

标准标签密钥

import { STANDARD_TAG_KEYS } from "@adaptiveworx/iac-schemas";
// Environment, Tenant, AccountPurpose, StackPurpose, TargetEnvironment,
// Workload, ManagedBy, Description

Workload 命名资源属于( ) 的工作量flow, (中文(简体) ), ztna; ; ; ; ; shared 共享基础设施。 权限边界和 ABAC 其进入范围.

直接导入 JSON

对于更喜欢生JSON的工具(如JSON Schema验证器,建造管道):

import regions from "@adaptiveworx/iac-schemas/regions" with { type: "json" };

什么样的船

路径目录
dist/index.js + 键 dist/index.d.ts图书馆条目 : regions, (中文(简体) ), REGIONS,AWS区域代码/名称清单和类型, STANDARD_TAG_KEYS
config/regions.json区域别名数据(也可通过 ./regions 子路径)

预生成的 JSON Schemas / OpenAPI / types.d.ts 下级 generated/ 在0.2中被清除:没有东西消耗他们,他们已变成僵尸。 为了JSON 石马,用Zod 4's z.toJSONSchema() 直接在iac -core的计画.

稳定

这是一个 0.x 释放。 形状 regions.* 可能改变前向后兼容的方式 1.0一次 1.0 船,包裹会跟着 语义版本。 。 。 .

区域别名( N)use1, (中文(简体) ), usw2等)被认为是稳定的标识符,不会被更名;可能添加新的标识符.

许可证

Apache 2.0 (英语)。见 通知。 。 。 .

仓库+捐款

此软件包是在 适应性WorX/iac-worx 单重键 : libs/iac/schemas/。见 捐款额 工作流程惯例和发布程序。 文件问题 https://github.com/AdaptiveWorX/iac-worx/issues (英语)。 。 。 .

版本与发布记录

@adaptiveworx/iac-schemas 共发布 7 个版本,首次发布于 2026/04/29;过去 12 个月发布了 7 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.6latest2026/10/041 个月前
0.1.52026/10/041 个月前
0.1.42026/05/135 个月前
0.1.32026/05/026 个月前
0.1.22026/05/026 个月前
0.1.12026/04/306 个月前

关于 @adaptiveworx/iac-schemas 的常见问题

@adaptiveworx/iac-schemas 是什么?

每个供应商的区域代码和名称,以及标准标记键,用于AdaptiveWorXTM基础设施-as-code. 纯数据+类型——无运行时间依赖.

如何安装 @adaptiveworx/iac-schemas?

在项目目录运行 npm install @adaptiveworx/iac-schemas,或使用 pnpm add / yarn add / bun add。

@adaptiveworx/iac-schemas 支持 TypeScript 吗?

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

@adaptiveworx/iac-schemas 支持 ESM 还是 CommonJS?

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

@adaptiveworx/iac-schemas 需要什么版本的 Node.js?

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

@adaptiveworx/iac-schemas 可以商用吗?

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

@adaptiveworx/iac-schemas 的下载量有多少?

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

@adaptiveworx/iac-schemas 还在维护吗?

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