- 文档首页
容器服务
容器服务 VKE
用户指南
组件管理
安全组件
pod-identity-webhook
pod-identity-webhook
pod-identity-webhook 是 VKE 集群中用于辅助实现 IRSA 能力的自动化组件。本文介绍如何在集群中部署和使用 pod-identity-webhook 组件。
pod-identity-webhook 组件是 IRSA(IAM Role for Service Account)功能辅助组件,组件核心能力和优势如下:
- 自动化注入 IRSA 配置:在 Pod 创建的 Mutating Admission 阶段,自动为符合条件的 Pod 注入 IRSA 相关配置,用户无需手动修改 Pod YAML 即可使用 IRSA 能力。
- 支持灵活配置:可通过命名空间标签、ServiceAccount 注解、Pod 注解实现精细化控制,包括开启/关闭自动注入、指定关联 IAM 角色、设置 OIDC Token 有效期、限制注入容器范围等。
- 功能兼容性:支持环境变量注入和 Volume 注入。
pod-identity-webhook 组件为托管组件,默认情况下不会在您的业务集群中部署具体的 Kubenetes 资源,不占用集群节点计算资源。
关于组件的历史发布记录、各版本新增特性及优化说明等信息,详情请参见 组件发布记录。 - 在左侧导航栏中,选择 集群,单击目标集群名称,进入集群管理页面。
- 在左侧导航栏中,选择 组件管理,并选择 安全 页签。
- 在 pod-identity-webhook 参数配置 对话框您可以选择是否开启 扩展环境变量。
- 未开启:组件安装完后,系统仅会自动为新建的 Pod 注入集群启用的 IRSA OIDC 环境变量。
- 开启:支持通过 变量名称 和 变量值 自定义 IRSA 扩展变量。组件安装完后,系统会同时为新建的 Pod 注入 IRSA OIDC 环境变量和 IRSA 扩展变量。
说明
- 如需配置 IRSA 扩展环境变量,需将 pod-identity-webhook 组件升级至 v0.1.3 及以上版本。
- 若您对扩展环境变量中的 变量名称 或 变量值 进行了变更,配置仅对新创建的 Pod 自动生效。存量已运行的 Pod 不会自动更新配置,您可通过重新发布、删除重建 Pod 的方式触发配置加载,使变更后的环境变量生效。
-
系统托管组件无需您关注组件升级问题。系统托管组件可避免用户侧原因导致的组件故障、性能不达预期等问题。减少用户运维成本,增强组件稳定性。
最近更新时间:2026.08.18 10:49:24