8.2.2. 使用 API 转换工具转换自定义资源配置文件


此流程描述了如何使用 API 转换工具将描述 AMQ Streams 自定义资源配置的 YAML 文件转换为适用于 v1beta2 的格式。为此,请使用 convert-file (cf)命令。

convert-file 命令可以转换包含多个文档的 YAML 文件。对于多文档 YAML 文件,其包含的所有 AMQ Streams 自定义资源都会转换。在转换的输出文件中不修改任何非 AMQ Streams OpenShift 资源。

转换 YAML 文件后,您必须应用配置来更新集群中的自定义资源。或者,如果 GitOps 同步机制用于集群上的更新,您可以使用 GitOps 同步机制应用更改。只有在 OpenShift 集群中更新自定义资源时,转换才会完成。

另外,您可以使用 convert-resource 流程直接转换自定义资源

先决条件

  • 支持 v1beta2 API 版本的一个 Cluster Operator 已启动且正在运行。
  • API 转换工具,随发行工件一起提供。
  • 工具需要 Java 11。

使用 CLI 帮助来了解更多有关 API 转换工具的信息,以及 convert-file 命令可用的标记:

bin/api-conversion.sh help
bin/api-conversion.sh help convert-file
Copy to Clipboard Toggle word wrap

如果您使用 Windows,请对此流程使用 bin/api-conversion.cmd

Expand
表 8.1. YAML 文件转换标志
标志描述

-f,--file=NAME-OF-YAML-FILE

指定正在转换的 AMQ Streams 自定义资源的 YAML 文件

-o, --output=NAME-OF-CONVERTED-YAML-FILE

为转换的自定义资源创建输出 YAML 文件

--in-place

使用转换的 YAML 更新原始源文件

流程

  1. 使用 convert-file 命令和相应的标志运行 API 转换工具。

    示例 1,转换 YAML 文件并显示输出,但文件没有改变:

    bin/api-conversion.sh convert-file --file input.yaml
    Copy to Clipboard Toggle word wrap

    示例 2 转换 YAML 文件,并将更改写入原始源文件中:

    bin/api-conversion.sh convert-file --file input.yaml --in-place
    Copy to Clipboard Toggle word wrap

    示例 3,转换 YAML 文件,并将更改写入新的输出文件中:

    bin/api-conversion.sh convert-file --file input.yaml --output output.yaml
    Copy to Clipboard Toggle word wrap
  2. 使用转换的配置文件更新自定义资源。

    oc apply -f CONVERTED-CONFIG-FILE
    Copy to Clipboard Toggle word wrap
  3. 验证自定义资源是否已转换。

    oc get KIND CUSTOM-RESOURCE-NAME -o yaml
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat