大网数据广告活动
Kubernetes 部署与运维

kubelet 配置 (v1)

· 52CE 我爱测

`CredentialProviderConfig` {#kubelet-config-k8s-io-v1-CredentialProviderConfig}

资源类型

CredentialProviderConfig {#kubelet-config-k8s-io-v1-CredentialProviderConfig}

CredentialProviderConfig 包含有关每个 exec 凭据提供程序的配置信息。 kubelet 从磁盘上读取这些配置信息,并根据 CredentialProvider 类型启用各个提供程序。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>apiVersion</code><br/>string</td><td><code>kubelet.config.k8s.io/v1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>CredentialProviderConfig</code></td></tr>

<tr><td><code>providers</code> <B>[必需]</B><br/> <a href="#kubelet-config-k8s-io-v1-CredentialProvider"><code>[]CredentialProvider</code></a> </td> <td> <p>

<code>providers</code> 是一组凭据提供程序插件,这些插件会被 kubelet 启用。 多个提供程序可以匹配到同一镜像上,这时,来自所有提供程序的凭据信息都会返回给 kubelet。 如果针对同一镜像调用了多个提供程序,则结果会被组合起来。如果提供程序返回的认证主键有重复, 列表中先出现的提供程序所返回的值将被首先尝试。 </p> </td> </tr> </tbody> </table>

CredentialProvider {#kubelet-config-k8s-io-v1-CredentialProvider}

出现在:

CredentialProvider 代表的是要被 kubelet 调用的一个 exec 插件。 这一插件只会在所拉取的镜像与该插件所处理的镜像匹配时才会被调用(参见 <code>matchImages</code>)。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>name</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>

<code>name</code> 是凭据提供程序的名称(必需)。此名称必须与 kubelet 所看到的提供程序可执行文件的名称匹配。可执行文件必须位于 kubelet 的 <code>bin</code> 目录(通过 <code>--image-credential-provider-bin-dir</code> 设置)下。 在所有提供程序中,名称是唯一的。 </p> </td> </tr> <tr><td><code>matchImages</code> <B>[必需]</B><br/> <code>[]string</code> </td> <td> <p>

<code>matchImages</code> 是一个必须设置的字符串列表,用来匹配镜像以便确定是否要调用此提供程序。 如果字符串之一与 kubelet 所请求的镜像匹配,则此插件会被调用并给予提供凭据的机会。 镜像应该包含镜像库域名和 URL 路径。 </p>

<p>

<code>matchImages</code> 中的每个条目都是一个模式字符串,其中可以包含端口号和路径。 域名部分可以包含通配符,但端口或路径部分不可以。'*.k8s.io' 或 'k8s.*.io' 等子域名以及 'k8s.*' 这类顶级域名都支持通配符。</p> <p>对于 'app</em>.k8s.io' 这类部分子域名的匹配也是支持的。 每个通配符只能用来匹配一个子域名段,所以 *.io 不会匹配 *.k8s.io。 </p> <p>

镜像与 <code>matchImages</code> 之间存在匹配时,以下条件都要满足: </p> <ul>

<li>二者均包含相同个数的域名部分,并且每个域名部分都对应匹配;</li> <li><code>matchImages</code> 条目中的 URL 路径部分必须是目标镜像的 URL 路径的前缀;</li> <li>如果 <code>matchImages</code> 条目中包含端口号,则端口号也必须与镜像端口号匹配。</li> </ul> <p>

<code>matchImages</code> 的一些示例如下: </p> <ul> <li>123456789.dkr.ecr.us-east-1.amazonaws.com</li> <li>*.azurecr.io</li> <li>gcr.io</li> <li>*.*.registry.io</li> <li>registry.io:8080/path</li> </ul> </td> </tr> <tr><td><code>defaultCacheDuration</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td> <p>

<code>defaultCacheDuration</code> 是插件在内存中缓存凭据的默认时长, 在插件响应中没有给出缓存时长时,使用这里设置的值。此字段是必需的。 </p> </td> </tr> <tr><td><code>apiVersion</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>

要求 exec 插件 <code>CredentialProviderRequest</code> 请求的输入版本。 所返回的 <code>CredentialProviderResponse</code> 必须使用与输入相同的编码版本。当前支持的值有: </p> <ul> <li>credentialprovider.kubelet.k8s.io/v1</li> </ul> </td> </tr> <tr><td><code>args</code><br/> <code>[]string</code> </td> <td> <p>

在执行插件可执行文件时要传递给命令的参数。 </p> </td> </tr> <tr><td><code>env</code><br/> <a href="#kubelet-config-k8s-io-v1-ExecEnvVar"><code>[]ExecEnvVar</code></a> </td> <td> <p>

<code>env</code> 定义要提供给插件进程的额外的环境变量。 这些环境变量会与主机上的其他环境变量以及 client-go 所使用的环境变量组合起来, 一起传递给插件。 </p> </td> </tr> <tr><td><code>tokenAttributes</code><br/> <a href="#kubelet-config-k8s-io-v1-ServiceAccountTokenAttributes"><code>ServiceAccountTokenAttributes</code></a> </td> <td> <p>

<code>tokenAttributes</code> 是将传递给插件的服务账号令牌的配置。 凭据提供程序通过设置此字段选择使用服务账号令牌进行镜像拉取。 当设置了此字段后,kubelet 将为正在拉取镜像的 Pod 生成一个绑定到此 Pod 的服务账号令牌, 并将其作为 <code>CredentialProviderRequest</code> 的一部分传递给插件,同时传递插件所需的其他属性。 </p> <p>

服务账号的元数据和令牌属性将作为 kubelet 中缓存凭据的一个维度。 缓存键由服务账号的元数据(命名空间、名称、UID 以及 <code>serviceAccountTokenAttribute.requiredServiceAccountAnnotationKeys</code> 和 <code>serviceAccountTokenAttribute.optionalServiceAccountAnnotationKeys</code> 中定义的注解键及其对应的值)组合生成。 服务账号令牌中的 Pod 元数据(命名空间、名称、UID)不会作为 kubelet 缓存凭据的维度。 这意味着,使用相同服务账号的工作负载可能会共用相同的凭据进行镜像拉取。 对于不希望出现此行为的插件,或者以直通模式运行的插件(即直接返回服务账号令牌而不做处理),可以将 <code>credentialProviderResponse.cacheDuration</code> 设置为 0。这一设置将禁用 kubelet 中凭据的缓存机制, 每次镜像拉取时都会调用插件。虽然这样设置会导致每次镜像拉取时都要重新生成令牌,因而带来额外开销, 但这是确保凭据不会在使用相同服务账号的多个 Pod 之间共享的唯一方式。 </p> </td> </tr> </tbody> </table>

ExecEnvVar {#kubelet-config-k8s-io-v1-ExecEnvVar}

出现在:

ExecEnvVar 用来在执行基于 exec 的凭据插件时设置环境变量。

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>name</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<span class="text-muted">环境变量名称</span></td> </tr> <tr><td><code>value</code> <B>[必需]</B><br/> <code>string</code> </td> <td>

<span class="text-muted">环境变量取值</span></td> </tr> </tbody> </table>

ServiceAccountTokenAttributes {#kubelet-config-k8s-io-v1-ServiceAccountTokenAttributes}

出现在:

<p>

<code>ServiceAccountTokenAttributes</code> 是将被传递给插件的服务账号令牌的配置。 </p>

<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>

<tr><td><code>serviceAccountTokenAudience</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>

<code>serviceAccountTokenAudience</code> 是投射的服务账号令牌的目标受众。 </p> </td> </tr> <tr><td><code>cacheType</code> <B>必需</B><br/> <a href="#kubelet-config-k8s-io-v1-ServiceAccountTokenCacheType"><code>ServiceAccountTokenCacheType</code></a> </td> <td> <p>

<code>cacheType</code> 表示当使用服务账号令牌时,用于缓存插件返回的凭据的缓存键类型。 最保守的选择是将其设置为 "Token",这意味着 kubelet 将基于每个令牌缓存返回的凭据。 如果返回的凭据的有效期受限于服务账号令牌的有效期,则应设置此值。 如果插件的凭据检索逻辑仅依赖于服务账号而不依赖于特定于 Pod 的声明, 那么插件可以将此设置为 "ServiceAccount"。在这种情况下, kubelet 将基于每个服务账号缓存返回的凭据。 当返回的凭据对使用相同服务账号的所有 Pod 都有效时使用此选项。 </p> </td> </tr> <tr><td><code>requireServiceAccount</code> <B>[必需]</B><br/> <code>bool</code> </td> <td> <p>

<code>requireServiceAccount</code> 指示插件是否需要 Pod 拥有服务帐号。 如果设置为 true,kubelet 仅在 Pod 拥有服务账号时才会调用插件。 如果设置为 false,即使 Pod 没有服务账号,kubelet 也会调用插件, 并且不会在 <code>CredentialProviderRequest</code> 中包含令牌。 这对于用于拉取没有服务账号的 Pod(例如静态 Pod)镜像的插件非常有用。 </p> </td> </tr> <tr><td><code>requiredServiceAccountAnnotationKeys</code><br/> <code>[]string</code> </td> <td> <p>

<code>requiredServiceAccountAnnotationKeys</code> 是插件感兴趣的注解键列表;这些键需要存在于服务帐号中。 在此列表中定义的键将从相应的服务帐号中提取,并作为 <code>CredentialProviderRequest</code> 的一部分传递给插件。 如果此列表中定义的任何一个键不存在于服务账号中,kubelet 将不会调用插件并返回错误。 此字段是可选的,可以为空。插件可以使用此字段提取获取凭据所需的额外信息, 或允许工作负载选择使用服务帐号令牌进行镜像拉取。 如果非空,则 <code>requireServiceAccount</code> 必须设置为 true。 键必须在此列表中唯一。 此列表需要与 <code>optionalServiceAccountAnnotationKeys</code> 互斥。 </p> </td> </tr> <tr><td><code>optionalServiceAccountAnnotationKeys</code><br/> <code>[]string</code> </td> <td> <p>

<code>optionalServiceAccountAnnotationKeys</code> 是插件感兴趣的注解键列表,并且这些键在服务帐号中是可选存在的。 在此列表中定义的键将从相应的服务账号中提取,并作为 <code>CredentialProviderRequest</code> 的一部分传递给插件。 插件负责验证注解及其值的存在性。此字段是可选的,可以为空。 插件可以使用此字段提取获取凭据所需的额外信息。 键必须在此列表中唯一。 </p> </td> </tr> </tbody> </table>

ServiceAccountTokenCacheType {#kubelet-config-k8s-io-v1-ServiceAccountTokenCacheType}

(string 的别名)

出现在:

<p>

<code>ServiceAccountTokenCacheType</code> 是当使用服务账号令牌时, 用于缓存插件返回的凭据的缓存键类型。 </p>

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。