第 4 章 动态插件
4.1. 动态插件概述
4.1.1. 关于动态插件
动态插件作为工作负载在集群中部署。它们允许您在运行时为控制台用户界面添加自定义页面和其他扩展。ConsolePlugin
自定义资源使用控制台注册插件,集群管理员在 console-operator
配置中启用了插件。
4.1.2. 主要特性
通过动态插件,您可以对 Red Hat OpenShift Service on AWS 进行以下自定义:
- 添加自定义页面。
- 增加了除管理员和开发人员之外的其他视角。
- 添加导航项。
- 在资源页面中添加制表符和操作。
4.1.3. 常规指南
在创建插件时,请遵循以下常规准则:
-
构建和运行插件需要
Node.js
和yarn
。 -
为您的 CSS 类名称加上插件名称前缀,以避免冲突。例如,
my-plugin__heading
和my-plugin_\_icon
。 - 与其他控制台页面保持一致的外观、感觉和行为。
在创建插件时遵循 react-i18next 指南。您可以使用类似以下示例中的
useTranslation
hook:conster Header: React.FC = () => { const { t } = useTranslation('plugin__console-demo-plugin'); return <h1>{t('Hello, World!')}</h1>; };
- 避免可能影响插件组件之外的标记的选择器,如元素选择器。这些不是 API,可能随时更改。使用它们可能会破坏插件。避免选择器,如元素选择器,它们可能会影响插件组件之外的标记。
-
为插件 Web 服务器提供的所有资产,使用
Content-Type
响应标头提供有效的 JavaScript 多用途互联网邮件扩展(MIME)类型。每个插件部署都应该包含一个 Web 服务器,用于托管给定插件生成的资产。
PatternFly 指南
在创建插件时,请按照以下使用 PatternFly 的准则进行以下操作:
使用 PatternFly 组件和 PatternFly CSS 变量。SDK 提供了核心 PatternFly 组件。使用 PatternFly 组件和变量可帮助您的插件在将来的控制台版本中保持一致。
- 如果您使用 Red Hat OpenShift Service on AWS 版本 4.14 及更早版本,请使用 Patternfly 4.x。
- 如果您在 AWS 4.15 或更高版本中使用 Red Hat OpenShift Service,请使用 Patternfly 5.x。
- 您可以按照 PatternFly 的可访问性基础,使您的插件能被访问。
-
避免使用其他 CSS 库,如 Bootstrap 或 Tailwind。它们可能会与 PatternFly 冲突,不会与控制台的外观和感觉相匹配。插件应仅包含特定于其用户界面的样式,以便在基本 PatternFly 样式上评估。避免在插件中导入
@patternfly/react-styles/*/.css
或来自@patternfly/patternfly
软件包的任何样式。 - 控制台应用程序负责为所有支持的 PatternFly 版本载入基本风格。