资源类型
CredentialProviderConfig {#kubelet-config-k8s-io-v1alpha1-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/v1alpha1</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-v1alpha1-CredentialProvider"><code>[]CredentialProvider</code></a> </td> <td>
<code>providers</code> 是一组凭据提供者插件,这些插件会被 kubelet 启用。 多个提供者可以匹配到同一镜像上,这时,来自所有提供者的凭据信息都会返回给 kubelet。 如果针对同一镜像调用了多个提供者,则结果会被组合起来。如果提供者返回的认证主键有重复, 列表中先出现的提供者所返回的值将第一个被尝试使用。 </td> </tr> </tbody> </table>
ImagePullIntent {#kubelet-config-k8s-io-v1alpha1-ImagePullIntent}
<p>
<code>ImagePullIntent</code> 是 kubelet 尝试拉取镜像的记录。 </p>
<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/v1alpha1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>ImagePullIntent</code></td></tr>
<tr><td><code>image</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
<code>image</code> 是容器 <code>image</code> 字段中的镜像规约。 文件名是此值的 SHA-256 哈希,这样做是为了避免文件名中不安全的字符,如 ':' 和 '/'。 </p> </td> </tr> </tbody> </table>
ImagePulledRecord {#kubelet-config-k8s-io-v1alpha1-ImagePulledRecord}
<p>
<code>ImagePullRecord</code> 是 kubelet 拉取的镜像的记录。 </p> <p>
如果 <code>kubernetesSecrets</code> 字段中没有记录,且 <code>nodeWideCredentials</code> 和 <code>anonymous</code> 均为 <code>false</code>,则当请求此记录表示的镜像时,必须重新检查凭据。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr> <tbody>
<tr><td><code>apiVersion</code><br/>string</td><td><code>kubelet.config.k8s.io/v1alpha1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>ImagePulledRecord</code></td></tr>
<tr><td><code>lastUpdatedTime</code> <B>[必需]</B><br/> <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.37/#time-v1-meta"><code>meta/v1.Time</code></a> </td> <td> <p>
<code>lastUpdatedTime</code> 是此记录上次更新的时间。 </p> </td> </tr> <tr><td><code>imageRef</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
<code>imageRef</code> 是从 CRI 接收到的此文件所代表的镜像的引用。 文件名是此值的 SHA-256 哈希。这是为了避免文件名中不安全的字符,如 ':' 和 '/'。 </p> </td> </tr> <tr><td><code>credentialMapping</code> <B>[必需]</B><br/> <a href="#kubelet-config-k8s-io-v1alpha1-ImagePullCredentials"><code>map[string]ImagePullCredentials</code></a> </td> <td> <p>
<code>credentialMapping</code> 将 <code>image</code> 映射到之前拉取它时使用的凭据集。 这里的 <code>image</code> 是 Pod 的容器中 <code>image</code> 字段的内容, 已去除其标签/摘要。 </p> <p>
示例: 容器请求 <code>hello-world:latest@sha256:91fb4b041da273d5a3273b6d587d62d518300a6ad268b28628f74997b93171b2</code> 镜像: "credentialMapping": { "hello-world": { "nodePodsAccessible": true } } </p> </td> </tr> </tbody> </table>
CredentialProvider {#kubelet-config-k8s-io-v1alpha1-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> 中的每个条目都是一个模式字符串,其中可以包含端口号和路径。 域名部分可以包含统配符,但端口或路径部分不可以。通配符可以用作子域名,例如 <code>.k8s.io</code> 或 <code>k8s..io</code>,以及 <code>k8s.*</code> 这类顶级域名。 </p> <p>
对类似 <code>app*.k8s.io</code> 这类部分子域名的匹配也是支持的。 每个通配符只能用来匹配一个子域名段,所以 <code>.io</code> 不会匹配 <code>.k8s.io</code>。 </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><code>123456789.dkr.ecr.us-east-1.amazonaws.com</code></li> <li><code>.azurecr.io</code></li> <li><code>gcr.io</code></li> <li><code>.*.registry.io</code></li> <li><code>registry.io:8080/path</code></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>
<code>defaultCacheDuration</code> 是插件在内存中缓存凭据的默认时长, 在插件响应中没有给出缓存时长时,使用这里设置的值。此字段是必需的。 </td> </tr>
<tr><td><code>apiVersion</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
要求 exec 插件 CredentialProviderRequest 请求的输入版本。 所返回的 CredentialProviderResponse 必须使用与输入相同的编码版本。当前支持的值有: </p> <ul> <li><code>credentialprovider.kubelet.k8s.io/v1alpha1</code></li> </ul> </td> </tr>
<tr><td><code>args</code><br/> <code>[]string</code> </td> <td>
在执行插件可执行文件时要传递给命令的参数。 </td> </tr>
<tr><td><code>env</code><br/> <a href="#kubelet-config-k8s-io-v1alpha1-ExecEnvVar"><code>[]ExecEnvVar</code></a> </td> <td>
<code>env</code> 定义要提供给插件进程的额外的环境变量。 这些环境变量会与主机上的其他环境变量以及 client-go 所使用的环境变量组合起来, 一起传递给插件。 </td> </tr> </tbody> </table>
ExecEnvVar {#kubelet-config-k8s-io-v1alpha1-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>
环境变量名称。 </td> </tr>
<tr><td><code>value</code> <B>[必需]</B><br/> <code>string</code> </td> <td>
环境变量取值。 </td> </tr> </tbody> </table>
ImagePullCredentials {#kubelet-config-k8s-io-v1alpha1-ImagePullCredentials}
出现在:
<p>
<code>ImagePullCredentials</code> 描述可以用于拉取镜像的凭据。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>kubernetesSecrets</code><br/> <a href="#kubelet-config-k8s-io-v1alpha1-ImagePullSecret"><code>[]ImagePullSecret</code></a> </td> <td> <p>
<code>kuberneteSecretCoordinates</code> 是用于拉取镜像的所有 Kubernetes Secret 的坐标索引。 </p> </td> </tr> <tr><td><code>kubernetesServiceAccounts</code><br/> <a href="#kubelet-config-k8s-io-v1alpha1-ImagePullServiceAccount"><code>[]ImagePullServiceAccount</code></a> </td> <td> <p>
<code>kubernetesServiceAccounts</code> 是用于拉取镜像的所有 Kubernetes 服务账号的坐标索引。 </p> </td> </tr> <tr><td><code>nodePodsAccessible</code><br/> <code>bool</code> </td> <td> <p>
<code>nodePodsAccessible</code> 是一个标志,表示节点上的所有 Pod 都可以访问拉取凭据, 或者拉取不需要凭据。 </p> <p>
如果为 true,则与 <code>kubernetesSecrets</code> 字段互斥。 </p> </td> </tr> </tbody> </table>
ImagePullSecret {#kubelet-config-k8s-io-v1alpha1-ImagePullSecret}
出现在:
<p>
<code>ImagePullSecret</code> 是 Kubernetes Secret 对象坐标的表示, 以及此对象包含的拉取 Secret 凭据的哈希值。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>uid</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <span class="text-muted">没有提供描述。</span></td> </tr> <tr><td><code>namespace</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <span class="text-muted">没有提供描述。</span></td> </tr> <tr><td><code>name</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <span class="text-muted">没有提供描述。</span></td> </tr> <tr><td><code>credentialHash</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
<code>credentialHash</code> 是通过对镜像拉取凭据的内容进行哈希计算获得的 SHA-256 值, 这些凭据由 UID/命名空间/名称坐标指定的 Secret 提供。 </p> </td> </tr> </tbody> </table>
ImagePullServiceAccount {#kubelet-config-k8s-io-v1alpha1-ImagePullServiceAccount}
出现在:
<p>
ImagePullServiceAccount 是 Kubernetes 服务账号对象坐标的表示, kubelet 将服务账号令牌发送给凭据提供程序以用于拉取镜像的凭据。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>uid</code> <B>必需</B><br/> <code>string</code> </td> <td> <span class="text-muted">资源对象的唯一标识(UID)。</span></td> </tr> <tr><td><code>namespace</code> <B>必需</B><br/> <code>string</code> </td> <td> <span class="text-muted">资源对象所在名字空间。</span></td> </tr> <tr><td><code>name</code> <B>必需</B><br/> <code>string</code> </td> <td> <span class="text-muted">资源对象的名称。</span></td> </tr> </tbody> </table>
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
