# @cdktn/provider-project 中文文档

规范地址：https://npmcn.com/package/%40cdktn/provider-project/

版本：0\.9\.17
npm 元数据更新时间：2026-11-02T06:30:25.700Z
中文译文更新时间：2026-11-09T08:43:58.248Z
软件包许可：MPL-2\.0

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

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

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

- 包体积（解压后）：974 kB，336 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 22\.11\.0
- 运行依赖：2 个
- peer 依赖：projen ^0\.101\.20，constructs ^10\.5\.0
- 首次发布：2026-01-09T15:22:04.725Z
- 最新版本发布：2026-11-02T06:30:25.160Z
- 近 30 天下载量：3391（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

> \[有重大意义\] > [OCF( OCF : OCF)](https://the-ocf.org/) - 说吧 [github.com/开放式建筑](https://github.com/open-constructs) 在新名称下 [CDK 地平线 - cdktn.io](http://cdktn.io/)

## 安装

```sh
npm install @cdktn/provider-project
```

也可以使用：`pnpm add @cdktn/provider-project`、`yarn add @cdktn/provider-project`、`bun add @cdktn/provider-project`

## README

# Terraform CDK 的未来

> \[大
> 
> [OCF( OCF : OCF)](https://the-ocf.org/) - 说吧 [github.com/开放式建筑](https://github.com/open-constructs) 在新名称下 [CDK 地平线 - cdktn.io](http://cdktn.io/)

* * *

# Terraform CDK 提供者项目

项目模板 [projen 语录](https://projen.io/) 为预建的提供者软件包创建仓库 [CDK 地形](https://cdktn.io/)。 。 。 .

## 使用量

提供者重置器完全由此重置器包含的配置自动生成 。 除了创建初始寄存器 - 使用此repo外,不需要手动交互. 这个 `cdktn get` 命令将作为Github Actions中构建管道的一部分执行。 这些工作按期执行. 因此,将自动收回新的供应商更改.

### 创建新的提供者

> \[注\] 只有Offical Terraform供应商或Hashicorp合作伙伴Terraform Poviders才能被接受用于预建的供应商生成.

添加新仓库 [在这里](https://github.com/cdktn-io/cdktn-repository-manager)。 。 。 .

在新创建的存储器中,我们需要的只是 `.projenrc.js` 这样的文件 :

```js
const { CdktnProviderProject } = require('@cdktn/provider-project');
const { Semver } = require('projen');

const project = new CdktnProviderProject({
  terraformProvider: "aws@~> 2.0"
});

project.synth();
```

调整 `terraformProvider` 属性并运行下列命令:

```
npm install @cdktn/provider-project@latest
npx projen
pnpm install
```

这将产生一个准备出版的整个存储器,包括用于出版国家预防机制、Pypi和maven软件包的Github Workflows。 只需手工设定这些登记册的标志:

-   `NPM_TOKEN` (仅在 `npmTrustedPublishing` 错误; cdktn- io 提供者寄存器通过 OIDC 发布, 不持有 npm 令牌)
-   `TWINE_PASSWORD` 编号 : `TWINE_USERNAME` (仅在 `pypiTrustedPublishing` 错误)
-   `MAVEN_GPG_PRIVATE_KEY`
-   `MAVEN_GPG_PRIVATE_KEY_PASSPHRASE`
-   `MAVEN_PASSWORD`
-   `MAVEN_USERNAME`

### 更新现有的提供者

在此将所需的修改提交到此寄存器中, 并等待自动释放 。 发布后,可以在目标提供者仓库中运行以下命令:

```
npm install @cdktn/provider-project@latest
npx projen
pnpm install
```

提交、 推动和检查自动释放版本 .

### 折旧旧软件包版本

折旧已出版的版本是手册,由维护者驱动的步骤. 用于携带自动的发布工作流程 `deprecate` 运行的工作 `npm deprecate` 在每次释放被腐烂的提供者之后; 它被删除,因为提供者储存库不再持有 `NPM_TOKEN` (npm出版使用 OIDC 信任的出版,无法授权) `npm deprecate`) (中文(简体) ).

-   **无**:在软件包上拥有出版权的维护者运行, 本地:
    
    ```
    npm deprecate <pkg>@"<range>" "<message>"
    ```
    
    譬如说. `npm deprecate @cdktn/provider-random@"<12.0.0" "See https://cdktn.io/docs/concepts/providers#import-providers for how to generate the bindings locally."`。空信件(`""`)取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取出.
    
-   **PyPI 密码**:没有折旧机制([pypi/ 仓库# 345](https://github.com/pypi/warehouse/issues/345)) (中文(简体) ). 仅限发布。 不要按住他们,因为Pip 然后跳过他们的任何要求 不是准确的 `==` 针. README(在PyPI项目页面上发回)中的去向通知是信号.
    
-   **走开**: 仍然自动化 -- -- 标记的提供者 `isDeprecated` 获得一个 `// Deprecated:` 预定于 `go.mod` 在GO发布工作期间.
    
-   **马文/ 努格特**:没有自动路径; NuGet只通过nuget.org web UI支持去化.
    

## 发展

下游需要改变的一切 [提供者存储器](https://github.com/cdktn-io/cdktn-repository-manager) 应当通过 [代码定义](https://npmcn.com/package/%40cdktn/provider-project/src/index.ts) 在这里.

为了地方发展, [pnpm 链接](https://pnpm.io/cli/link) 也许对测试很有帮助.

## 常见问题

### @cdktn/provider-project 是什么？

\[有重大意义\] \> OCF\( OCF : OCF\) - 说吧 github\.com/开放式建筑 在新名称下 CDK 地平线 - cdktn\.io

### 如何安装 @cdktn/provider-project？

在项目目录运行 npm install @cdktn/provider-project，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：projen（^0\.101\.20）、constructs（^10\.5\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cdktn/provider-project 支持 TypeScript 吗？

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

### @cdktn/provider-project 支持 ESM 还是 CommonJS？

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

### @cdktn/provider-project 需要什么版本的 Node\.js？

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

### @cdktn/provider-project 可以商用吗？

@cdktn/provider-project 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @cdktn/provider-project 的下载量有多少？

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

### @cdktn/provider-project 还在维护吗？

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