OpenShift 文档正在迁移，很快将只能在 docs.redhat.com（所有 Red Hat 产品文档的中心）访问。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

关于集群 API

使用集群API管理机器仅为技术预览功能。技术预览功能不受Red Hat生产服务等级协议（SLA）的支持，并且可能功能不完整。Red Hat不建议在生产环境中使用它们。这些功能提供对即将推出的产品功能的早期访问，使客户能够在开发过程中测试功能并提供反馈。

有关Red Hat技术预览功能的支持范围的更多信息，请参阅技术预览功能支持范围。

该集群API是一个上游项目，作为针对Amazon Web Services (AWS)、Google Cloud Platform (GCP)和VMware vSphere的技术预览集成到OpenShift Container Platform中。

集群API概述

您可以使用集群API在OpenShift Container Platform集群中创建和管理计算机器集和计算机器。此功能是对使用机器API管理机器的补充或替代方法。

对于OpenShift Container Platform 4.17集群，您可以在集群安装完成后使用集群API执行节点主机配置管理操作。此系统在公共或私有云基础架构之上启用弹性、动态配置方法。

使用集群API技术预览，您可以在支持的提供商的OpenShift Container Platform集群上创建计算机器和计算机器集。您还可以探索此实现启用的功能，这些功能在机器API中可能不可用。

集群API优势

通过使用集群API，OpenShift Container Platform用户和开发人员可以获得以下优势：

  • 可以选择使用机器API可能不支持的上游社区集群API基础架构提供商。

  • 有机会与维护基础架构提供商机器控制器的第三方合作。

  • 能够对OpenShift Container Platform中的基础架构管理使用相同的Kubernetes工具集。

  • 能够使用支持机器API中不可用功能的集群API创建计算机器集。

集群API限制

使用集群API管理机器是一项技术预览功能，具有以下限制：

  • 要使用此功能，您必须启用`TechPreviewNoUpgrade`功能集。

    启用此功能集无法撤消，并且会阻止次要版本更新。

  • 只有 Amazon Web Services (AWS)、Google Cloud Platform (GCP) 和 VMware vSphere 集群可以使用 Cluster API。

  • 您必须手动创建 Cluster API 所需的主要资源。有关更多信息，请参阅“Cluster API 入门”。

  • 您不能使用 Cluster API 来管理控制平面机器。

  • 不支持将 Machine API 创建的现有计算机器集迁移到 Cluster API 计算机器集。

  • 与 Machine API 的完全功能一致性不可用。

  • 对于使用 Cluster API 的集群，OpenShift CLI（oc）命令优先处理 Cluster API 对象而不是 Machine API 对象。此行为会影响对 Cluster API 和 Machine API 中都表示的任何对象的任何 oc 命令。

    有关更多信息以及此问题的解决方法，请参阅故障排除内容中的“使用 CLI 时引用目标对象”。

其他资源

Cluster API 架构

上游 Cluster API 的 OpenShift Container Platform 集成由 Cluster CAPI Operator 实现和管理。Cluster CAPI Operator 及其操作数在 openshift-cluster-api 命名空间中配置，这与使用 openshift-machine-api 命名空间的 Machine API 形成对比。

Cluster CAPI Operator

Cluster CAPI Operator 是一个 OpenShift Container Platform Operator，它维护 Cluster API 资源的生命周期。此 Operator 负责与在 OpenShift Container Platform 集群中部署 Cluster API 项目相关的所有管理任务。

如果集群已正确配置以允许使用 Cluster API，则 Cluster CAPI Operator 将在集群上安装 Cluster API 组件。

有关更多信息，请参阅《集群操作符参考》内容中的“Cluster CAPI Operator”条目。

其他资源

Cluster API 主要资源

Cluster API 包含以下主要资源。对于此功能的技术预览版，您必须在 openshift-cluster-api 命名空间中手动创建这些资源。

集群 (Cluster)

表示由 Cluster API 管理的集群的基本单元。

基础设施 (Infrastructure)

一个特定于提供程序的资源，它定义了集群中所有计算机器集共享的属性，例如区域和子网。

机器模板 (Machine template)

一个特定于提供程序的模板，它定义了计算机器集创建的机器的属性。

机器集 (Machine set)

一组机器。

计算机器集与机器的关系，就像副本集与 Pod 的关系一样。要添加机器或缩减机器规模，请更改计算机器集自定义资源上的 replicas 字段以满足您的计算需求。

使用 Cluster API，计算机器集引用 Cluster 对象和特定于提供程序的机器模板。

机器 (Machine)

描述节点主机的基本单元。

Cluster API 根据机器模板中的配置创建机器。