# @bluedynamics/cdk8s-plone 中文文档

规范地址：https://npmcn.com/package/%40bluedynamics/cdk8s-plone/

版本：0\.2\.4
npm 元数据更新时间：2026-11-02T08:28:23.213Z
中文译文更新时间：2026-11-08T08:28:04.372Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：7.6 MB，88 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：cdk8s ^2\.70\.117，constructs ^10\.4\.2，cdk8s-plus-30 ^2\.4\.10
- 首次发布：2024-07-24T16:47:15.225Z
- 最新版本发布：2026-11-02T08:28:22.857Z
- 近 30 天下载量：2704（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：152（近 12 个月 66 个）

## 中文简介

为 Kubernetes 提供 CMS Plone 后端和前端的 Cdk8s

## 安装

```sh
npm install @bluedynamics/cdk8s-plone
```

也可以使用：`pnpm add @bluedynamics/cdk8s-plone`、`yarn add @bluedynamics/cdk8s-plone`、`bun add @bluedynamics/cdk8s-plone`

## README

# CDK8S 小龙

> 使用 CDK8S 向库伯涅部署 Plone CMS 的 TypeScript 和 Python 库

[![npm version](https://badge.fury.io/js/%40bluedynamics%2Fcdk8s-plone.svg)](https://www.npmjs.com/package/@bluedynamics/cdk8s-plone) [![PyPI version](https://badge.fury.io/py/cdk8s-plone.svg)](https://pypi.org/project/cdk8s-plone/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://npmcn.com/package/%40bluedynamics/cdk8s-plone/LICENSE)

## 概览

cdk8s-plone 为部署提供 CDK8S 构造 [Plone CMS (Plone CMS) (英语)](https://plone.org/) 在库伯涅特。 使用 TypeScript 或 Python 定义您的基础设施并自动生成 Kubernetes 显示 .

**关键特性 :**

-   QQ 支持 Volto (反应前端) 和 Blicca (原经典 UI)
-   \* 拥有大量可配置复制品
-   通过 kube-httpcache 可选 Varnish HTTP 缓存(`PloneHttpcache`)或云乙烯卡舍操作员(`PloneVinylCache`(中文(简体) )
-   精细的资源和探测器配置
-   QQ多语言支持( TypeScript/ JavaScript和Python)
-   QQ 类型安全基础设施作为代码

## 快速启动

### 安装

**类型脚本/ Java 脚本 :**

```bash
npm install @bluedynamics/cdk8s-plone
```

**Python : (中文(简体) )**

```bash
pip install cdk8s-plone
```

### 基本示例

```typescript
import { App, Chart } from 'cdk8s';
import { Plone, PloneVariant } from '@bluedynamics/cdk8s-plone';

const app = new App();
const chart = new Chart(app, 'PloneDeployment');

new Plone(chart, 'my-plone', {
  variant: PloneVariant.VOLTO,
  backend: {
    image: 'plone/plone-backend:6.1.3',
    replicas: 3,
  },
  frontend: {
    image: 'plone/plone-frontend:16.0.0',
    replicas: 2,
  },
});

app.synth();
```

产生库伯涅特的表:

```bash
cdk8s synth
kubectl apply -f dist/
```

## 文档

**完整文档 :** [https://blue动力学.github.io/cdk8s-plone/ (中文(简体) )](https://bluedynamics.github.io/cdk8s-plone/)

-   [快速启动教程](https://bluedynamics.github.io/cdk8s-plone/tutorials/01-quick-start.html)
-   [配置参考](https://bluedynamics.github.io/cdk8s-plone/reference/configuration-options.html)
-   [结构概览](https://bluedynamics.github.io/cdk8s-plone/explanation/architecture.html)
-   [完成 API 文档](https://npmcn.com/package/%40bluedynamics/cdk8s-plone/API.md)

## 实例

完整的工作实例见 [`examples/`](https://npmcn.com/package/%40bluedynamics/cdk8s-plone/examples/) 目录 :

-   **[沃尔多](https://npmcn.com/package/%40bluedynamics/cdk8s-plone/examples/volto/)** - 配有反应单页前端的已准备好的Plone 6部署:
    
    -   Volto 前端 (反应) + REST API后端
    -   PostgreSQL 带有 RelStorage (平面 PostgreSQL 或 CloudNativePG) 的 PostgreSQL
    -   使用 kube- httpcache 的 Vornish HTTP 缓存
    -   用 TLS 支持入侵( Traefik/ Kong)
-   **[布莱卡](https://npmcn.com/package/%40bluedynamics/cdk8s-plone/examples/blicca/)** - 配置服务器侧渲染(原经典UI):
    
    -   Blicca( 后端使 UI, 没有单独的前端)
    -   PostgreSQL 带有 RelStorage (平面 PostgreSQL 或 CloudNativePG) 的 PostgreSQL
    -   使用 kube- httpcache 的 Vornish HTTP 缓存
    -   用 TLS 支持入侵( Traefik/ Kong)
    -   较简单的架构( 没有单独的前端)

### 普罗米修斯量子

启用 Prometheus Service Monitor 来收集测量值( 需要 Prometheus 运算符) :

```typescript
new Plone(chart, 'my-plone', {
  backend: {
    servicemonitor: true,
    metricsPath: '/metrics',  // optional, defaults to '/metrics'
  },
  frontend: {
    servicemonitor: true,
    metricsPort: 9090,  // optional, defaults to service port
  },
});
```

**说明:** 您必须使用您的 Plone 后端/ 前端来显示配置的端点的参数 。 对于Volto/Node.js前端,考虑使用 [舞会客户](https://www.npmjs.com/package/prom-client) 或者说 [显式正中软件](https://www.npmjs.com/package/express-prometheus-middleware)。 。 。 .

## 所需资源

-   **库贝特尔** - 说吧 [安装 kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
-   **节点.js 16+** (用于TypeScript/JavaScript) - [安装节点.js](https://nodejs.org/)
-   **Py 3.8+** (为平通 [安装 Python](https://www.python.org/)
-   **Kubernetes集群** (当地或云

详细设置说明见 [设置先决条件](https://bluedynamics.github.io/cdk8s-plone/how-to/setup-prerequisites.html)。 。 。 .

## 发展

这个项目使用 [普罗让](https://projen.io/) 用于项目管理.

```bash
# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Update project configuration
# Edit .projenrc.ts, then run:
npx projen
```

详细的开发说明见 [捐款额](https://npmcn.com/package/%40bluedynamics/cdk8s-plone/CONTRIBUTING.md) (如果有的话).

## 资源

-   [CDK8S 文档](https://cdk8s.io/)
-   [Plone CMS (Plone CMS) (英语)](https://plone.org/)
-   [库贝- httpcache](https://github.com/mittwald/kube-httpcache) (用于HTTP缓冲)
-   [云营养PG](https://cloudnative-pg.io/) (用于PostgreSQL管理)

## 许可证

[Apache 2.0 (英语)](https://npmcn.com/package/%40bluedynamics/cdk8s-plone/LICENSE)

## 维护者

维护者 [蓝色动态联盟](https://github.com/bluedynamics)

**作者 :** 简斯·克莱因(Jens W[jk@kleinundpartner.at (原始内容存档于2012-09-29)](mailto:jk@kleinundpartner.at)(中文(简体) )

## 常见问题

### @bluedynamics/cdk8s-plone 是什么？

为 Kubernetes 提供 CMS Plone 后端和前端的 Cdk8s

### 如何安装 @bluedynamics/cdk8s-plone？

在项目目录运行 npm install @bluedynamics/cdk8s-plone，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：cdk8s（^2\.70\.117）、constructs（^10\.4\.2）、cdk8s-plus-30（^2\.4\.10）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bluedynamics/cdk8s-plone 支持 TypeScript 吗？

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

### @bluedynamics/cdk8s-plone 支持 ESM 还是 CommonJS？

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

### @bluedynamics/cdk8s-plone 可以商用吗？

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

### @bluedynamics/cdk8s-plone 的下载量有多少？

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

### @bluedynamics/cdk8s-plone 还在维护吗？

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