尧图网页设计 
Kubernetes SIG Multicluster 核心术语指南About API、MCS、ClusterSet 与 Work API 全解析【免费下载链接】communityKubernetes Community Documentation项目地址: https://gitcode.com/GitHub_Trending/com/community导读多集群Multi-cluster是 Kubernetes 生态中最复杂、术语也最容易混淆的领域之一ClusterClaim、ClusterProperty、About API、MCS、ClusterSet、Work API……这些名词之间既有演进关系又有语义差异。本文以 Kubernetes Community 仓库中 SIG Multicluster 的官方术语表sig-multicluster/terminology.md为骨架结合该 SIG 的 README、Charter、Namespace Sameness 立场声明 以及历年年度报告逐一厘清每个术语的定义、曾用名、别名及其在仓库子项目中的落点。读完本文你将能够准确区分六大核心术语读懂多集群相关 KEP、文档与代码讨论不再被同名不同义的 API 名称误导。一、为什么需要一份多集群术语表Kubernetes 官方把集群边界视为资源模型的宇宙边缘多集群场景缺乏统一的标准模式这导致社区内各项目对同一概念常常使用不同叫法见 Namespace Sameness 立场声明 的 Context 部分。术语表文件的存在正是为了缓解这一混乱记录当前通用术语terms in common use记录这些术语的别名aliases即过去或现在可能被使用的其他叫法通过Also known as / Previously known as字段显式标注演进关系避免读者在新旧文档间迷失。这份术语表不是孤立的它与 SIG Multicluster 的六个子项目一一对应about-api、cluster-inventory-api、mcs-api、multicluster-runtime、sig-multicluster-site、work-api见 sig-multicluster/README.md 的 Subprojects 小节。下面逐一展开。二、About API集群自我介绍的标准接口术语定义About API 是 SIG Multicluster 用于描述集群自身信息的 API。术语表明确标注了它的两个关键别名关系名称当前名称About APIAlso known as别名ClusterPropertyPreviously known as前身ClusterClaim API这一组曾用名 → 别名 → 现名的演进非常典型早期该能力以ClusterClaim命名社区讨论后更名为ClusterProperty最终在 about-api 子项目中以 About API 的形式落地。从仓库证据看其演进轨迹2022 年度报告 提到Developed the About API for ClusterSets即 About API 最初服务于 ClusterSet 的集群身份标识2023 年度报告 记录 About API KEP in beta即相关 KEP 进入 Beta 阶段2025 年度报告 记录 About API v1beta1 CRD released并提及社区正在讨论well-known cluster properties建议的通用集群属性集合与属性阶梯property ladder。技术落点About API 对应子项目about-api其 OWNERS 文件位于仓库根目录 sigs.yaml 所引用的外部仓库。在阅读多集群相关 KEP 时遇到ClusterProperty应理解为 About API 体系内的资源对象遇到ClusterClaim则需意识到这是历史命名。三、ClusterProfile API集群清单与连接信息术语定义ClusterProfile API 是集群清单Cluster Inventory体系中的核心资源用于描述集群的概要信息与连接凭据。术语表中它与 ClusterSet、About API 并列是 SIG Multicluster 中较新的 API。从仓库证据看其演进2024 年度报告 记录 KEP 4322 renamed to ClusterProfile API原 Cluster Inventory API 更名为 ClusterProfile API并澄清了 ClusterProfile、ClusterSet 与 cluster inventory 三者的关系2025 年度报告 记录了多项 ClusterProfile 进展ClusterProfile 凭据通过插件plugin管理KEP 5339、ClusterProfile CR 改为 namespace 作用域、新增集群专属认证信息字段、基于 extensions 的按集群插件配置等。技术落点ClusterProfile API 对应子项目cluster-inventory-api该子项目于 2023 年度报告 中作为新子项目加入当时 ClusterInventory API 正处于active discussion and provisional状态。该 API 与 PlacementDecision API多集群调度决策见 2025 年度报告共同构成集群清单体系。四、ClusterSet集群的逻辑分组单位术语定义ClusterSet 是一组在逻辑上被当作一个整体对待的集群的概念是多集群服务、命名空间一致性等能力的组织单位。从仓库证据看其定位2022 年度报告 记录 KEP 2149 ClusterID for ClusterSet Identification 于 v1.24 进入 alpha为 ClusterSet 中的集群提供稳定 ClusterID2023 年度报告 记录该 KEP 于 v1.28 进入 Beta同样在 2022 年度报告 中About API 最初正是for ClusterSets即用集群自身属性来标识其所属的 ClusterSet。技术落点ClusterSet 是跨多个 APIAbout API、MCS API、ClusterProfile API的顶层抽象MCS 的服务合并以 ClusterSet 为范围About API 提供集群属性、ClusterID 用于识别 ClusterSet 成员对应 KEP 2149。阅读多集群文档时遇到ClusterSet应理解为受同一权威治理、预期协同工作的一组集群。五、Multicluster Services APIMCS / MCS API跨集群服务发现与访问术语定义Multicluster Services API简称 MCS 或 MCS API是 SIG Multicluster 为跨集群服务发现与流量访问制定的标准 API 规范。术语表给出关系名称当前名称Multicluster Services APIAlso known as别名MCS、MCS API从仓库证据看其成熟度2022 年度报告 记录 KEP 1645MCS APIprogress to beta且now with conformance tests2024 年度报告 记录 KEP 1645 毕业到 beta 的关键剩余工作是 ServiceImport 的 spec/status 字段合并到 root且已实现配套的 conformance 套件位于 mcs-api 仓库 conformance 目录CI 与 presubmit 作业也已接入 test-infra2025 年度报告 记录 MCS 版本演进到 0.2.0 和 0.3.0新增 IP 家族dual-stack策略、端口冲突规则、流量分布与内部流量策略字段、ServiceExport/ServiceImport 条件conditions等并围绕 MCS 与 Gateway API 的对齐开展了大量工作。技术落点MCS API 对应子项目mcs-api。结合 Namespace Sameness 立场声明 的 Example 3 可以看出其设计取向MCS 的跨集群服务合并默认不开启实现思路包括 opt-in服务必须被显式 export 才能跨集群合并、opt-out服务或命名空间可退出合并、差异化发现合并服务与原始服务使用不同名称或发现机制。该 API 通常围绕ServiceExport/ServiceImport两个核心资源展开这也是 MCS 讨论与 KEP 中出现频率最高的两个对象。六、Namespace Sameness命名空间一致性的规范性立场术语定义Namespace Sameness 不是某个 API而是 SIG Multicluster 对多集群中命名空间语义的规范性声明是该 SIG 最早发布的立场文件之一namespace-sameness-position-statement.md发布于 2020/04状态 RELEASED。其核心立场原文为For a set of related clusters governed by a single authority, all namespaces of a given name are considered to be the same namespace. A single namespace should have a consistent owner across the set of clusters.对于由单一权威治理的一组相关集群所有同名命名空间被视为同一个命名空间单个命名空间在整个集群集合中应有一致的所有者。这一立场文件用三个假设性例子阐明了含义命名空间创建Example 1若 foo 团队在集群 A 中申请了名为 database 的命名空间则其他团队不得再在集群 B 中申请同名 database——该名字在全部集群范围内被占用。命名空间名的分配与授权如自服务门户、准入控制器强制团队前缀等属于创新空间RBAC 同步Example 2LDAP 到 RBAC 的同步流程可以假定每个集群中 metrics 命名空间应获得相同的 RBAC 规则并可针对特定集群如欧盟集群更严格做特化多集群服务Example 3即使两个集群中同名命名空间满足 Sameness跨集群服务合并仍不应默认开启以免集群 A 的客户端意外访问到集群 B 的同类服务。技术落点Namespace Sameness 是 MCS、About API、ClusterProfile 等所有跨集群行为规范化工作的语义基石在 Charter 定义的 SIG 范围内为后续 API 设计提供理论支撑。七、Work API跨集群工作负载调度的探索术语定义Work API 是 SIG Multicluster 对跨集群工作负载管理的探索性 API用于将工作负载Workload分发并执行到多个集群。从仓库证据看其定位2022 年度报告 明确将 work API 与cross-cluster workload managementmulticluster controllers并列作为 SIG 正在探索的方向之一2023 年度报告 将 work-api 列为Continuing子项目2025 年度报告 同样将 work-api 列为继续存在的子项目。技术落点Work API 对应子项目work-api。需要注意从 2022 年度报告 的措辞看该 API 尚处于探索阶段SIG 明确表示需要更多人分享具体用例、过往实现尝试与关切才能提出普遍有用的解决方案——因此在使用与引用时不应将其描述为已 GA 的稳定标准。八、术语速查表与进阶阅读速查表术语别名/曾用名对应子项目一句话定位About APIClusterProperty别名、ClusterClaim API曾用名about-api描述集群自身属性的标准 APIClusterProfile API原 Cluster Inventory APIKEP 4322 更名cluster-inventory-api集群清单与连接凭据ClusterSet—跨 API 的顶层抽象逻辑上协同工作的一组集群Multicluster Services APIMCS、MCS APImcs-api跨集群服务发现与访问规范KEP 1645Namespace Sameness—立场文件同名命名空间跨集群语义一致性声明Work API—work-api跨集群工作负载调度的探索性 API进阶阅读路径了解 SIG 整体范围与治理SIG Multicluster README、Charter深入理解多集群命名空间语义Namespace Sameness 立场声明追踪各 API 演进2022、2023、2024、2025 年度报告检索全部 SIG 定义与子项目 OWNERS 信息sigs.yaml。使用建议在阅读多集群相关 KEP、博客或代码时若遇到ClusterProperty请与 About API 关联遇到ClusterClaim请意识到那是历史命名遇到MCS请与 Multicluster Services API 关联。这份术语表正是社区为了消除这类歧义而维护的权威索引。【免费下载链接】communityKubernetes Community Documentation项目地址: https://gitcode.com/GitHub_Trending/com/community创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Kubernetes SIG Multicluster 核心术语指南：About API、MCS、ClusterSet 与 Work API 全解析
Kubernetes SIG Multicluster 核心术语指南About API、MCS、ClusterSet 与 Work API 全解析【免费下载链接】communityKubernetes Community Documentation项目地址: https://gitcode.com/GitHub_Trending/com/community导读多集群Multi-cluster是 Kubernetes 生态中最复杂、术语也最容易混淆的领域之一ClusterClaim、ClusterProperty、About API、MCS、ClusterSet、Work API……这些名词之间既有演进关系又有语义差异。本文以 Kubernetes Community 仓库中 SIG Multicluster 的官方术语表sig-multicluster/terminology.md为骨架结合该 SIG 的 README、Charter、Namespace Sameness 立场声明 以及历年年度报告逐一厘清每个术语的定义、曾用名、别名及其在仓库子项目中的落点。读完本文你将能够准确区分六大核心术语读懂多集群相关 KEP、文档与代码讨论不再被同名不同义的 API 名称误导。一、为什么需要一份多集群术语表Kubernetes 官方把集群边界视为资源模型的宇宙边缘多集群场景缺乏统一的标准模式这导致社区内各项目对同一概念常常使用不同叫法见 Namespace Sameness 立场声明 的 Context 部分。术语表文件的存在正是为了缓解这一混乱记录当前通用术语terms in common use记录这些术语的别名aliases即过去或现在可能被使用的其他叫法通过Also known as / Previously known as字段显式标注演进关系避免读者在新旧文档间迷失。这份术语表不是孤立的它与 SIG Multicluster 的六个子项目一一对应about-api、cluster-inventory-api、mcs-api、multicluster-runtime、sig-multicluster-site、work-api见 sig-multicluster/README.md 的 Subprojects 小节。下面逐一展开。二、About API集群自我介绍的标准接口术语定义About API 是 SIG Multicluster 用于描述集群自身信息的 API。术语表明确标注了它的两个关键别名关系名称当前名称About APIAlso known as别名ClusterPropertyPreviously known as前身ClusterClaim API这一组曾用名 → 别名 → 现名的演进非常典型早期该能力以ClusterClaim命名社区讨论后更名为ClusterProperty最终在 about-api 子项目中以 About API 的形式落地。从仓库证据看其演进轨迹2022 年度报告 提到Developed the About API for ClusterSets即 About API 最初服务于 ClusterSet 的集群身份标识2023 年度报告 记录 About API KEP in beta即相关 KEP 进入 Beta 阶段2025 年度报告 记录 About API v1beta1 CRD released并提及社区正在讨论well-known cluster properties建议的通用集群属性集合与属性阶梯property ladder。技术落点About API 对应子项目about-api其 OWNERS 文件位于仓库根目录 sigs.yaml 所引用的外部仓库。在阅读多集群相关 KEP 时遇到ClusterProperty应理解为 About API 体系内的资源对象遇到ClusterClaim则需意识到这是历史命名。三、ClusterProfile API集群清单与连接信息术语定义ClusterProfile API 是集群清单Cluster Inventory体系中的核心资源用于描述集群的概要信息与连接凭据。术语表中它与 ClusterSet、About API 并列是 SIG Multicluster 中较新的 API。从仓库证据看其演进2024 年度报告 记录 KEP 4322 renamed to ClusterProfile API原 Cluster Inventory API 更名为 ClusterProfile API并澄清了 ClusterProfile、ClusterSet 与 cluster inventory 三者的关系2025 年度报告 记录了多项 ClusterProfile 进展ClusterProfile 凭据通过插件plugin管理KEP 5339、ClusterProfile CR 改为 namespace 作用域、新增集群专属认证信息字段、基于 extensions 的按集群插件配置等。技术落点ClusterProfile API 对应子项目cluster-inventory-api该子项目于 2023 年度报告 中作为新子项目加入当时 ClusterInventory API 正处于active discussion and provisional状态。该 API 与 PlacementDecision API多集群调度决策见 2025 年度报告共同构成集群清单体系。四、ClusterSet集群的逻辑分组单位术语定义ClusterSet 是一组在逻辑上被当作一个整体对待的集群的概念是多集群服务、命名空间一致性等能力的组织单位。从仓库证据看其定位2022 年度报告 记录 KEP 2149 ClusterID for ClusterSet Identification 于 v1.24 进入 alpha为 ClusterSet 中的集群提供稳定 ClusterID2023 年度报告 记录该 KEP 于 v1.28 进入 Beta同样在 2022 年度报告 中About API 最初正是for ClusterSets即用集群自身属性来标识其所属的 ClusterSet。技术落点ClusterSet 是跨多个 APIAbout API、MCS API、ClusterProfile API的顶层抽象MCS 的服务合并以 ClusterSet 为范围About API 提供集群属性、ClusterID 用于识别 ClusterSet 成员对应 KEP 2149。阅读多集群文档时遇到ClusterSet应理解为受同一权威治理、预期协同工作的一组集群。五、Multicluster Services APIMCS / MCS API跨集群服务发现与访问术语定义Multicluster Services API简称 MCS 或 MCS API是 SIG Multicluster 为跨集群服务发现与流量访问制定的标准 API 规范。术语表给出关系名称当前名称Multicluster Services APIAlso known as别名MCS、MCS API从仓库证据看其成熟度2022 年度报告 记录 KEP 1645MCS APIprogress to beta且now with conformance tests2024 年度报告 记录 KEP 1645 毕业到 beta 的关键剩余工作是 ServiceImport 的 spec/status 字段合并到 root且已实现配套的 conformance 套件位于 mcs-api 仓库 conformance 目录CI 与 presubmit 作业也已接入 test-infra2025 年度报告 记录 MCS 版本演进到 0.2.0 和 0.3.0新增 IP 家族dual-stack策略、端口冲突规则、流量分布与内部流量策略字段、ServiceExport/ServiceImport 条件conditions等并围绕 MCS 与 Gateway API 的对齐开展了大量工作。技术落点MCS API 对应子项目mcs-api。结合 Namespace Sameness 立场声明 的 Example 3 可以看出其设计取向MCS 的跨集群服务合并默认不开启实现思路包括 opt-in服务必须被显式 export 才能跨集群合并、opt-out服务或命名空间可退出合并、差异化发现合并服务与原始服务使用不同名称或发现机制。该 API 通常围绕ServiceExport/ServiceImport两个核心资源展开这也是 MCS 讨论与 KEP 中出现频率最高的两个对象。六、Namespace Sameness命名空间一致性的规范性立场术语定义Namespace Sameness 不是某个 API而是 SIG Multicluster 对多集群中命名空间语义的规范性声明是该 SIG 最早发布的立场文件之一namespace-sameness-position-statement.md发布于 2020/04状态 RELEASED。其核心立场原文为For a set of related clusters governed by a single authority, all namespaces of a given name are considered to be the same namespace. A single namespace should have a consistent owner across the set of clusters.对于由单一权威治理的一组相关集群所有同名命名空间被视为同一个命名空间单个命名空间在整个集群集合中应有一致的所有者。这一立场文件用三个假设性例子阐明了含义命名空间创建Example 1若 foo 团队在集群 A 中申请了名为 database 的命名空间则其他团队不得再在集群 B 中申请同名 database——该名字在全部集群范围内被占用。命名空间名的分配与授权如自服务门户、准入控制器强制团队前缀等属于创新空间RBAC 同步Example 2LDAP 到 RBAC 的同步流程可以假定每个集群中 metrics 命名空间应获得相同的 RBAC 规则并可针对特定集群如欧盟集群更严格做特化多集群服务Example 3即使两个集群中同名命名空间满足 Sameness跨集群服务合并仍不应默认开启以免集群 A 的客户端意外访问到集群 B 的同类服务。技术落点Namespace Sameness 是 MCS、About API、ClusterProfile 等所有跨集群行为规范化工作的语义基石在 Charter 定义的 SIG 范围内为后续 API 设计提供理论支撑。七、Work API跨集群工作负载调度的探索术语定义Work API 是 SIG Multicluster 对跨集群工作负载管理的探索性 API用于将工作负载Workload分发并执行到多个集群。从仓库证据看其定位2022 年度报告 明确将 work API 与cross-cluster workload managementmulticluster controllers并列作为 SIG 正在探索的方向之一2023 年度报告 将 work-api 列为Continuing子项目2025 年度报告 同样将 work-api 列为继续存在的子项目。技术落点Work API 对应子项目work-api。需要注意从 2022 年度报告 的措辞看该 API 尚处于探索阶段SIG 明确表示需要更多人分享具体用例、过往实现尝试与关切才能提出普遍有用的解决方案——因此在使用与引用时不应将其描述为已 GA 的稳定标准。八、术语速查表与进阶阅读速查表术语别名/曾用名对应子项目一句话定位About APIClusterProperty别名、ClusterClaim API曾用名about-api描述集群自身属性的标准 APIClusterProfile API原 Cluster Inventory APIKEP 4322 更名cluster-inventory-api集群清单与连接凭据ClusterSet—跨 API 的顶层抽象逻辑上协同工作的一组集群Multicluster Services APIMCS、MCS APImcs-api跨集群服务发现与访问规范KEP 1645Namespace Sameness—立场文件同名命名空间跨集群语义一致性声明Work API—work-api跨集群工作负载调度的探索性 API进阶阅读路径了解 SIG 整体范围与治理SIG Multicluster README、Charter深入理解多集群命名空间语义Namespace Sameness 立场声明追踪各 API 演进2022、2023、2024、2025 年度报告检索全部 SIG 定义与子项目 OWNERS 信息sigs.yaml。使用建议在阅读多集群相关 KEP、博客或代码时若遇到ClusterProperty请与 About API 关联遇到ClusterClaim请意识到那是历史命名遇到MCS请与 Multicluster Services API 关联。这份术语表正是社区为了消除这类歧义而维护的权威索引。【免费下载链接】communityKubernetes Community Documentation项目地址: https://gitcode.com/GitHub_Trending/com/community创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考