# @mcpg-dev/pulumi-crds 中文文档

规范地址：https://npmcn.com/package/%40mcpg-dev/pulumi-crds/

版本：0\.1\.0-beta\.45
npm 元数据更新时间：2026-11-01T19:10:20.425Z
中文译文更新时间：2026-11-01T20:29:00.253Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40mcpg-dev/pulumi-crds
原文对照：https://npmcn.com/package/%40mcpg-dev/pulumi-crds/?lang=original
项目主页：https://pulumi.com/
源码仓库：https://github.com/mcpg-dev/pulumi-mcpg-crds

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

- 包体积（解压后）：1.2 MB，172 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2026-08-13T13:13:45.787Z
- 最新版本发布：2026-11-01T19:10:20.104Z
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

从MCPG CRD模式生成的MCPG .dev自定义资源的类型化Pulumi资源类。

## 安装

```sh
npm install @mcpg-dev/pulumi-crds
```

也可以使用：`pnpm add @mcpg-dev/pulumi-crds`、`yarn add @mcpg-dev/pulumi-crds`、`bun add @mcpg-dev/pulumi-crds`

## README

# @mcpg / pulumi-crds

类的类型化Pulumi资源类 `mcpg.dev` 自定义资源- MCPG运营商提供的Kubernetes API。声明一个 `MCPGGateway`,一个 `MCPGPluginSet`，或Pulumi程序中的任何其他MCPG资源 TypeScript类型、补全和差异，而不是将无类型的YAML推入 通用配置组。

该包是使用crd2pulumi从MCPG CRD模式生成并提交的 生成的。不要手工编辑：更改crd并重新生成。

## 快速启动

```ts
import { mcpg } from "@mcpg/pulumi-crds";

new mcpg.v1alpha1.MCPGGateway("orders", {
  metadata: { namespace: "mcpg-system" },
  spec: {
    image: { repository: "ghcr.io/mcpg-dev/source-code/gateway", tag: "<tag>" },
    config: {},
  },
});
```

## 资源

`mcpg.v1alpha1` 每一种MCPG类型出口一个类 `…List` 和 `…Patch` 它们的变体用于读取集合和服务器端应用补丁。

| 类 | 它声明了什么 |
| --- | --- |
| `MCPGGateway` | 网关部署及其所服务的配置。 |
| `MCPGCluster` | 网关集群共享的协调后端。 |
| `MCPGRoute` | 绑定到共享网关的工具子集及其链。 |
| `MCPGTenant` | 租户边界：名称空间、插件允许列表、配额。 |
| `MCPGPlugin` | 插件工件和它必须满足的信任。 |
| `MCPGPluginSet` | 有序的插件列表及其功能授予。 |
| `MCPGPluginMirror` | 插件构件的集群内镜像。 |
| `MCPGRevocationList` | 通过摘要撤销插件工件。 |

## 更高级的组件

这些类是原始的资源表面。对于安装 运营商，拥有CRD生命周期，组装网关配置，并设置 租户,使用 `@mcpg/pulumi`，这是建立在这个包。

## 执照

apache - 2.0。

## 看到也

-   [https://mcpg.dev/docs/reference/operator-crds](https://mcpg.dev/docs/reference/operator-crds) -逐字段引用 以上所有资源。
-   [https://mcpg.dev/docs/self-hosting/pulumi](https://mcpg.dev/docs/self-hosting/pulumi) -使用Pulumi部署MCPG。

## 构建和测试

```sh
npm install
npm run build
```

## 常见问题

### @mcpg-dev/pulumi-crds 是什么？

从MCPG CRD模式生成的MCPG \.dev自定义资源的类型化Pulumi资源类。

### 如何安装 @mcpg-dev/pulumi-crds？

在项目目录运行 npm install @mcpg-dev/pulumi-crds，或使用 pnpm add / yarn add / bun add。

### @mcpg-dev/pulumi-crds 支持 TypeScript 吗？

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

### @mcpg-dev/pulumi-crds 支持 ESM 还是 CommonJS？

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

### @mcpg-dev/pulumi-crds 可以商用吗？

@mcpg-dev/pulumi-crds 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @mcpg-dev/pulumi-crds 还在维护吗？

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