@@ -29,9 +29,8 @@ as opposed to storing static credentials on disk. For example, the plugin may ta
29
29
short-lived credentials for an image that is being pulled by the kubelet.
30
30
-->
31
31
从 Kubernetes v1.20 开始,kubelet 可以使用 exec 插件动态获得针对某容器镜像库的凭据。
32
- kubelet 使用 Kubernetes 版本化 API 通过标准输入输出(标准输入、标准输出和标准错误)
33
- 和 exec 插件通信。
34
- 这些插件允许 kubelet 动态请求容器仓库的凭据,而不是将静态凭据存储在磁盘上。
32
+ kubelet 使用 Kubernetes 版本化 API 通过标准输入输出(标准输入、标准输出和标准错误)和
33
+ exec 插件通信。这些插件允许 kubelet 动态请求容器仓库的凭据,而不是将静态凭据存储在磁盘上。
35
34
例如,插件可能会与本地元数据服务器通信,以获得 kubelet 正在拉取的镜像的短期凭据。
36
35
37
36
<!--
@@ -49,7 +48,7 @@ This guide demonstrates how to configure the kubelet's image credential provider
49
48
* 凭据的到期时间很短,需要频繁请求新凭据。
50
49
* 将镜像库凭据存储在磁盘或者 imagePullSecret 是不可接受的。
51
50
52
- 本指南演示如何配置 kubelet 的镜像凭证提供程序插件机制 。
51
+ 本指南演示如何配置 kubelet 的镜像凭据提供程序插件机制 。
53
52
54
53
## {{% heading "prerequisites" %}}
55
54
@@ -59,7 +58,7 @@ This guide demonstrates how to configure the kubelet's image credential provider
59
58
Kubernetes v1.24 and v1.25 included this as a beta feature, enabled by default.
60
59
* A working implementation of a credential provider exec plugin. You can build your own plugin or use one provided by cloud providers.
61
60
-->
62
- * 你需要一个 Kubernetes 集群,其节点支持 kubelet 凭证提供程序插件 。
61
+ * 你需要一个 Kubernetes 集群,其节点支持 kubelet 凭据提供程序插件 。
63
62
这种支持在 Kubernetes {{< skew currentVersion >}} 中可用;
64
63
Kubernetes v1.24 和 v1.25 将此作为 Beta 特性包含在内,默认启用。
65
64
* 凭据提供程序 exec 插件的一种可用的实现。你可以构建自己的插件或使用云提供商提供的插件。
@@ -100,19 +99,19 @@ In order to use this feature, the kubelet expects two flags to be set:
100
99
101
100
The configuration file passed into `--image-credential-provider-config` is read by the kubelet to determine which exec plugins
102
101
should be invoked for which container images. Here's an example configuration file you may end up using if you are using the
103
- [ECR](https://aws.amazon. com/ecr/)-based plugin :
102
+ [ECR-based plugin ](https://github. com/kubernetes/cloud-provider-aws/tree/master/cmd/ecr-credential-provider) :
104
103
-->
105
104
### 配置 kubelet 凭据提供程序 {#configure-a-kubelet-credential-provider}
106
105
107
106
kubelet 会读取通过 ` --image-credential-provider-config ` 设定的配置文件,
108
107
以确定应该为哪些容器镜像调用哪些 exec 插件。
109
- 如果你正在使用基于 [ ECR] ( https://aws.amazon. com/ecr/ ) 的插件 ,
108
+ 如果你正在使用基于 [ ECR-based 插件 ] ( https://github. com/kubernetes/cloud-provider-aws/tree/master/cmd/ecr-credential-provider ) ,
110
109
这里有个样例配置文件你可能最终会使用到:
111
110
112
111
``` yaml
113
112
apiVersion : kubelet.config.k8s.io/v1
114
113
kind : CredentialProviderConfig
115
- # providers 是将由 kubelet 启用的凭证提供程序帮助插件列表 。
114
+ # providers 是将由 kubelet 启用的凭据提供程序帮助插件列表 。
116
115
# 多个提供程序可能与单个镜像匹配,在这种情况下,来自所有提供程序的凭据将返回到 kubelet。
117
116
# 如果为单个镜像调用了多个提供程序,则返回结果会被合并。
118
117
# 如果提供程序返回重叠的身份验证密钥,则使用提供程序列表中较早的值。
@@ -121,7 +120,7 @@ providers:
121
120
# 它必须与 kubelet 看到的提供程序可执行文件的名称相匹配。
122
121
# 可执行文件必须在 kubelet 的 bin 目录中
123
122
# (由 --image-credential-provider-bin-dir 标志设置)。
124
- - name : ecr
123
+ - name : ecr-credential-provider
125
124
# matchImages 是一个必需的字符串列表,用于匹配镜像以确定是否应调用此提供程序。
126
125
# 如果其中一个字符串与 kubelet 请求的镜像相匹配,则该插件将被调用并有机会提供凭据。
127
126
# 镜像应包含注册域和 URL 路径。
@@ -147,7 +146,7 @@ providers:
147
146
# - registry.io:8080/path
148
147
matchImages :
149
148
- " *.dkr.ecr.*.amazonaws.com"
150
- - " *.dkr.ecr.*.amazonaws.cn"
149
+ - " *.dkr.ecr.*.amazonaws.com. cn"
151
150
- " *.dkr.ecr-fips.*.amazonaws.com"
152
151
- " *.dkr.ecr.us-iso-east-1.c2s.ic.gov"
153
152
- " *.dkr.ecr.us-isob-east-1.sc2s.sgov.gov"
@@ -160,8 +159,8 @@ providers:
160
159
apiVersion : credentialprovider.kubelet.k8s.io/v1
161
160
# 执行命令时传递给命令的参数。
162
161
# 可选
163
- args :
164
- - get-credentials
162
+ # args:
163
+ # - --example-argument
165
164
# env 定义了额外的环境变量以暴露给进程。
166
165
# 这些与主机环境以及 client-go 用于将参数传递给插件的变量结合在一起。
167
166
# 可选
@@ -186,14 +185,14 @@ Consult the plugin implementors to determine what set of arguments and environme
186
185
-->
187
186
` providers` 字段是 kubelet 所使用的已启用插件列表。每个条目都有几个必填字段:
188
187
189
- * `name`:插件的名称,必须与传入`--image-credential-provider-bin-dir`
188
+ * `name`:插件的名称,必须与传入 `--image-credential-provider-bin-dir`
190
189
的目录中存在的可执行二进制文件的名称相匹配。
191
190
* `matchImages`:字符串列表,用于匹配镜像以确定是否应调用此提供程序。
192
191
更多相关信息参见后文。
193
192
* `defaultCacheDuration`:如果插件未指定缓存时长,kubelet 将在内存中缓存凭据的默认时长。
194
193
* `apiVersion`:kubelet 和 exec 插件在通信时将使用的 API 版本。
195
194
196
- 每个凭证提供程序也可以被赋予可选的参数和环境变量 。
195
+ 每个凭据提供程序也可以被赋予可选的参数和环境变量 。
197
196
你可以咨询插件实现者以确定给定插件需要哪些参数和环境变量集。
198
197
199
198
<!--
@@ -207,7 +206,7 @@ a single subdomain segment, so `*.io` does NOT match `*.k8s.io`.
207
206
-->
208
207
# ### 配置镜像匹配 {#configure-image-matching}
209
208
210
- kubelet 使用每个凭证提供程序的 `matchImages` 字段来确定是否应该为 Pod
209
+ kubelet 使用每个凭据提供程序的 `matchImages` 字段来确定是否应该为 Pod
211
210
正在使用的给定镜像调用插件。
212
211
` matchImages` 中的每个条目都是一个镜像模式字符串,可以选择包含端口和路径。
213
212
可以在域中使用通配符,但不能在端口或路径中使用。
@@ -224,7 +223,7 @@ A match exists between an image name and a `matchImage` entry when all of the be
224
223
225
224
Some example values of `matchImages` patterns are :
226
225
-->
227
- 当以下所有条件都为真时 ,镜像名称和 `matchImage` 条目之间存在匹配:
226
+ 当以下条件全部满足时 ,镜像名称和 `matchImage` 条目之间存在匹配:
228
227
229
228
* 两者都包含相同数量的域部分并且每个部分都匹配。
230
229
* 匹配图片的 URL 路径必须是目标图片 URL 路径的前缀。
@@ -245,7 +244,6 @@ Some example values of `matchImages` patterns are:
245
244
[kubelet configuration API (v1) reference](/docs/reference/config-api/kubelet-config.v1/).
246
245
* Read the [kubelet credential provider API reference (v1)](/docs/reference/config-api/kubelet-credentialprovider.v1/).
247
246
-->
248
- * 阅读 [kubelet 配置 API (v1) 参考](/docs/reference/config-api/kubelet-config.v1/)中有关
247
+ * 阅读 [kubelet 配置 API (v1) 参考](/zh-cn/ docs/reference/config-api/kubelet-config.v1/)中有关
249
248
` CredentialProviderConfig` 的详细信息。
250
- * 阅读 [kubelet 凭据提供程序 API 参考 (v1)](/docs/reference/config-api/kubelet-credentialprovider.v1/)。
251
-
249
+ * 阅读 [kubelet 凭据提供程序 API 参考 (v1)](/zh-cn/docs/reference/config-api/kubelet-credentialprovider.v1/)。
0 commit comments