新闻详情

新闻详情

首页 / 资讯中心 / 详情

Kubernetes Python 客户端 V1AggregationRule 模型详解:ClusterRole 聚合规则的编程式使用

发布时间:2026/11/19 5:50:35来源:尧图网络
Kubernetes Python 客户端 V1AggregationRule 模型详解:ClusterRole 聚合规则的编程式使用
后端云原生容器编排【免费下载链接】pythonOfficial Python client library for kubernetes项目地址https://gitcode.com/gh_mirrors/python1/python点击查看免费下载导读V1AggregationRule是 Kubernetes Python 官方客户端本项目gh_mirrors/python1/python即官方 Python client library for kubernetes中用于描述ClusterRole 聚合规则的数据模型它通过一组标签选择器LabelSelector定位其他 ClusterRole并将这些被选中 ClusterRole 的权限规则rules合并进当前 ClusterRole。本文以 Sphinx 文档 doc/source/kubernetes.aio.client.models.v1_aggregation_rule.rst 中的V1AggregationRule模块为核心结合异步kubernetes.aio与同步kubernetes.client两套客户端源码讲清该模型的字段定义、序列化行为、与V1ClusterRole的嵌套关系以及通过 RBAC API 创建聚合 ClusterRole 的完整实战代码。读完本文你将能够用 Python 代码构造、序列化、反序列化V1AggregationRule并借助标签选择器实现权限的声明式聚合。一、文档形态从 automodule 指令到真实模型定义doc/source/kubernetes.aio.client.models.v1_aggregation_rule.rst本身是一个典型的 OpenAPI 生成型客户端文档占位文件正文只有一段 Sphinx 指令.. automodule:: kubernetes.aio.client.models.v1_aggregation_rule :members: :show-inheritance: :undoc-members:它并不直接书写模型细节而是让 Sphinx 在构建文档时从kubernetes.aio.client.models.v1_aggregation_rule模块自动抽取类、字段与继承关系渲染成 API 页面:members:展开全部成员:show-inheritance:显示基类:undoc-members:连未写 docstring 的成员也一并纳入。因此理解该文档主题的唯一正确路径是阅读它背后真实的模型源码与生成文档异步模型kubernetes/aio/client/models/v1_aggregation_rule.py同步模型kubernetes/client/models/v1_aggregation_rule.py配套生成文档kubernetes/aio/docs/V1AggregationRule.md 与 kubernetes/docs/V1AggregationRule.mdOpenAPI 原始定义kubernetes/swagger.json.unprocessed模型声明位于AggregationRule一节字段clusterRoleSelectors描述出现在第 15899 行附近二、模型定位AggregationRule 在 RBAC 聚合机制中的角色在 Kubernetes 的 RBAC 模型中ClusterRole是集群级别的、可作为整体被 RoleBinding / ClusterRoleBinding 引用的 PolicyRule 逻辑分组而AggregationRule的作用正是描述如何定位一组用于“聚合进”某个 ClusterRole 的其它 ClusterRole。模型源码的 docstring 给出了官方语义AggregationRule describes how to locate ClusterRoles to aggregate into the ClusterRole其工作方式为持有aggregationRule的 ClusterRole 声明一个或多个标签选择器API Server 会持续查找集群中标签与之匹配的 ClusterRole把它们的 rules 全部合并进该 ClusterRole 的rules字段。只要任一选择器匹配对应 ClusterRole 的权限就会被加入If any of the selectors match, then the ClusterRoles permissions will be added见 v1_aggregation_rule.py。这一机制的价值在于运维团队可以用标签对权限规则做声明式分组与自动聚合——例如为所有应用运维角色打上aggregate-to-app-operator: true标签聚合角色便自动吸收它们新增的规则无需逐条手工合并符合以标签为中心、按角色聚合权限的常见权限治理模式。三、字段定义与类型约束V1AggregationRule继承自pydantic.BaseModel异步版本源码第 97 行class V1AggregationRule(BaseModel)当前仓库对应 Kubernetesrelease-1.37的 OpenAPI 文档源码头部注释标注了该版本。3.1 唯一核心字段cluster_role_selectors属性名Python序列化别名JSON类型是否必填说明cluster_role_selectorsclusterRoleSelectorsOptional[List[V1LabelSelector]]否默认None用于查找 ClusterRole 并生成聚合 rules 的选择器列表任一选择器匹配即把该 ClusterRole 的权限加入字段在源码中的定义v1_aggregation_rule.pycluster_role_selectors: Optional[List[V1LabelSelector]] Field( defaultNone, validation_aliasAliasChoices(clusterRoleSelectors, cluster_role_selectors), serialization_aliasclusterRoleSelectors, descriptionclusterRoleSelectors holds a list of selectors which will be used to find ClusterRoles and create the rules. If any of the selectors match, then the ClusterRoles permissions will be added, )要点元素类型每个选择器是V1LabelSelector对象对应 kubernetes/aio/client/models/v1_label_selector.pyV1LabelSelector支持match_labels与match_expressions两种标准 Kubernetes 选择器语法别名alias机制validation_aliasAliasChoices(...)意味着构造与反序列化时既可以传 OpenAPI 线格式的clusterRoleSelectors也可以直接传 Python 风格下划线命名cluster_role_selectors而serialization_aliasclusterRoleSelectors保证输出 JSON 时始终使用驼峰线格式判空语义openapi_typesList[V1LabelSelector]与attribute_mapclusterRoleSelectors类变量在生成代码中用于兼容旧版工具的序列化管线源码第 108–115 行。3.2 Model 配置与验证行为模型通过model_configv1_aggregation_rule.py启用了以下 pydantic 行为model_config ConfigDict( validate_by_nameTrue, validate_by_aliasTrue, validate_assignmentTrue, extraforbid, protected_namespaces(), )validate_by_nameTrue/validate_by_aliasTrue属性名与别名两种输入形式都会被校验validate_assignmentTrue创建后对字段赋值也会即时触发类型校验extraforbid传入未声明的多余字段会被拒绝——这保证与 OpenAPI schema 严格一致避免静默吞掉拼写错误的字段protected_namespaces()允许使用不以model_等 pydantic 保留前缀开头的字段名。四、与 V1ClusterRole 的嵌套关系V1AggregationRule在真实使用中总是作为V1ClusterRole.aggregation_rule字段出现。查看 kubernetes/aio/client/models/v1_cluster_role.pyaggregation_rule: Optional[V1AggregationRule] Field( defaultNone, validation_aliasAliasChoices(aggregationRule, aggregation_rule), serialization_aliasaggregationRule, ) api_version: Optional[StrictStr] ... kind: Optional[StrictStr] ... metadata: Optional[V1ObjectMeta] None rules: Optional[List[V1PolicyRule]] Field(defaultNone, descriptionrules holds all the PolicyRules for this ClusterRole)也就是说一个聚合型 ClusterRole 的 JSON 形态大致如下{ apiVersion: rbac.authorization.k8s.io/v1, kind: ClusterRole, metadata: { name: aggregate-app-operator }, aggregationRule: { clusterRoleSelectors: [ { matchLabels: { rbac.example.com/aggregate-to-app-operator: true } } ] }, rules: [] }注意rules在提交时通常为空实际权限由 API Server 依据aggregationRule动态合成。V1ClusterRole同样可在 kubernetes/docs/V1ClusterRole.md 与 kubernetes/aio/docs/V1ClusterRole.md 中查阅字段明细。五、序列化与反序列化 API作为 OpenAPI Generator 生成的 pydantic 模型V1AggregationRule提供了与同步/异步客户端一致的转换方法族见 v1_aggregation_rule.py方法作用to_str()/__repr__()返回pprint格式化的人类可读字符串便于调试打印to_dict(serializeFalse)返回字段字典serializeTrue时键名切换为线格式clusterRoleSelectorsto_json()返回 JSON 字符串始终使用别名clusterRoleSelectors并递归处理内部V1LabelSelector元素from_json(json_str)从 JSON 字符串构造实例from_dict(obj)从字典构造实例内部先经__preprocess_input_names将下划线键归一为驼峰键再逐个把列表元素交给V1LabelSelector.from_dict递归构建__eq__/__ne__基于to_dict()结果的深比较其中to_dict与__openapi_generator_modern_projection之间通过_OPENAPI_GENERATOR_TO_DICT属性互指源码第 207–217 行这是一种生成代码自带的兼容机制既能以新版 pydantic 语义exclude_noneTrue、递归调用子模型to_dict()生成字典又保留旧版 OpenAPI 生成器调用约定。5.1 典型用法示例参考生成文档 V1AggregationRule.md 中的用法骨架结合本仓库实际 API 给出可运行的完整示例from kubernetes.aio.client.models.v1_aggregation_rule import V1AggregationRule from kubernetes.aio.client.models.v1_label_selector import V1LabelSelector # 从 JSON 构造 json_str {clusterRoleSelectors: [{matchLabels: {rbac.example.com/aggregate-to-app-operator: true}}]} rule V1AggregationRule.from_json(json_str) # 或者用 Python 对象直接构造两种命名风格皆可 selector V1LabelSelector(match_labels{rbac.example.com/aggregate-to-app-operator: true}) rule2 V1AggregationRule(cluster_role_selectors[selector]) # 输出线格式 JSON键为 clusterRoleSelectors print(rule2.to_json()) # 转为字典 / 再转回模型往返转换 d rule2.to_dict() restored V1AggregationRule.from_dict(d) assert restored rule2同步客户端使用方式完全一致只需把导入路径换成from kubernetes.client.models.v1_aggregation_rule import V1AggregationRulekubernetes/client/models/v1_aggregation_rule.py。六、实战通过 RBAC API 创建带聚合规则的 ClusterRoleV1AggregationRule的落地场景是调用RbacAuthorizationV1Api.create_cluster_role将聚合角色写入集群。异步版本实现位于 kubernetes/aio/client/api/rbac_authorization_v1_api.py其签名要点如下body: V1ClusterRole必填待创建的 ClusterRole 对象pretty是否美化输出默认false浏览器或 curl/wget 用户代理除外dry_run可选All表示只走校验与处理流程但不持久化field_manager申请方名称用于 server-side apply 的字段归属跟踪小于 128 字符的可打印字符field_validationIgnore/Warn/Strict三档Warn是 v1.23 默认值Strict会在出现未知或重复字段时报 BadRequest成功响应映射200/201/202 → V1ClusterRole401 → None。完整异步示例基于 examples_asyncio 目录的异步客户端模式import asyncio from kubernetes.aio.client import ApiClient, Configuration from kubernetes.aio.client.api.rbac_authorization_v1_api import RbacAuthorizationV1Api from kubernetes.aio.client.models.v1_cluster_role import V1ClusterRole from kubernetes.aio.client.models.v1_object_meta import V1ObjectMeta from kubernetes.aio.client.models.v1_aggregation_rule import V1AggregationRule from kubernetes.aio.client.models.v1_label_selector import V1LabelSelector async def main(): config Configuration() # 按需设置 host / api_key 等或使用 kube_config async with ApiClient(configurationconfig) as api_client: api RbacAuthorizationV1Api(api_client) body V1ClusterRole( api_versionrbac.authorization.k8s.io/v1, kindClusterRole, metadataV1ObjectMeta(nameaggregate-app-operator), aggregation_ruleV1AggregationRule( cluster_role_selectors[ V1LabelSelector( match_labels{ rbac.example.com/aggregate-to-app-operator: true } ) ] ), rules[], # rules 由 API Server 依据 aggregationRule 动态聚合 ) created await api.create_cluster_role(bodybody) print(created.to_str()) asyncio.run(main())同步版本把导入路径替换为kubernetes.client系kubernetes/client/api/rbac_authorization_v1_api.py并去掉async with/await即可集群外的 kubeconfig 加载方式可参考 examples/out_of_cluster_config.py。创建完成后任何带有匹配标签的 ClusterRole例如metadata.labels[rbac.example.com/aggregate-to-app-operator] true的 rules 都会自动并入该聚合 ClusterRole——新增权限只需打标签无需重写聚合角色的规则列表。七、字段可见性与文档对照由于:undoc-members:与:members:指令的作用Sphinx 页面会展示上述全部成员字段、方法、类属性。读者在 kubernetes/aio/docs/V1AggregationRule.md 生成的 Markdown 中可以核对相同信息该页面的 Properties 表仅列出cluster_role_selectors类型List[V1LabelSelector]可选并给出基于from_json/to_dict/from_dict的最小示例。本文第一节到第五节的内容即是对该 API 页面的源码级展开。八、注意事项与使用限制只读仓库提示本仓库为官方客户端源码镜像模型文件由 OpenAPI Generator 从release-1.37的 Kubernetes OpenAPI 定义自动生成见各模型文件头部generated by OpenAPI Generator / Do not edit the class manually注释日常使用应通过模型类构造而非手工修改生成代码。聚合是服务端行为V1AggregationRule只是客户端描述结构实际聚合计算由 API Server 完成提交的rules会被服务端覆盖为聚合结果。选择器语义clusterRoleSelectors是或关系任一匹配即聚合若希望且关系需要把多个条件合并进同一个V1LabelSelector如同时指定多个matchExpressions。版本差异字段与行为以当前仓库对应的release-1.37为准更早 Kubernetes 版本中该模型语义一致但个别注解如field_validation的默认值会随服务端版本演进。九、延伸阅读模型源码kubernetes/aio/client/models/v1_aggregation_rule.py、kubernetes/client/models/v1_aggregation_rule.py关联模型V1LabelSelector 源码、V1ClusterRole 源码API 实现kubernetes/aio/client/api/rbac_authorization_v1_api.py、kubernetes/client/api/rbac_authorization_v1_api.py生成文档kubernetes/aio/docs/V1AggregationRule.md、kubernetes/docs/V1AggregationRule.md异步客户端使用示例examples_asyncio、同步示例examples赞分享后端云原生容器编排【免费下载链接】pythonOfficial Python client library for kubernetes项目地址https://gitcode.com/gh_mirrors/python1/python点击查看免费下载相关推荐Open X-Embodiment与RT-X模型机器人学习领域的革命性突破Open X Embodiment与RT X模型机器人学习领域的革命性突破 Open X Embodiment项目致力于将所有开源机器人数据统一格式为下游应Kubernetes Python 异步客户端 V1APIService 模型解析用 APIService 对象管理 API 聚合服务Kubernetes Python 异步客户端 V1APIService 模型解析用 APIService 对象管理 API 聚合服务 本篇指南围绕官方 Ku后端云原生容器编排GameDevMind 内存管理完全指南内存池、智能指针、GC 与游戏内存规划实战GameDevMind 内存管理完全指南内存池、智能指针、GC 与游戏内存规划实战 本文是 GameDevMind 游戏开发知识图谱中「1.基础能力 / 1.后端云原生容器编排上一篇如何将openEuler secScanner自动化部署集成到CI/CD流水线10个实用技巧下一篇A-Tune-UI与A-Tune-Collector集成指南数据采集与可视化的完美协作创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/18 21:21:17

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/18 14:20:46

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/18 20:01:42

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/18 11:04:06

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/18 15:55:22

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/18 21:21:16

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉