红帽全球峰会Operator API
Operator API 的参考指南
摘要
第 1 章 Operator API
1.1. Authentication [operator.openshift.io/v1]
- 描述
- 身份验证提供配置操作器以管理身份验证的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.2. CloudCredential [operator.openshift.io/v1]
- 描述
- CloudCredential 提供了配置 Operator 来管理 CredentialsRequest 的方法。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.3. ClusterCSIDriver [operator.openshift.io/v1]
- 描述
- ClusterCSIDriver 对象允许在 OpenShift 中默认安装的 CSI 驱动程序 Operator 管理和配置。对象的名称必须是它所运行的 CSI 驱动程序的名称。如需允许的值列表，请参阅 CSIDriverName 类型。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.4. Console [operator.openshift.io/v1]
- 描述
- 控制台提供了一种方法来配置操作器来管理控制台。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.5. Config [operator.openshift.io/v1]
- 描述
- config 指定 config operator 的行为，它负责在集群中创建其他组件的初始配置。Operator 还处理 AWS 和基于 Azure 云的集群兼容性等级 1 的安装、迁移或同步云配置：在主发行版本中至少需要 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.6. Config [imageregistry.operator.openshift.io/v1]
- 描述
- config 是 registry operator 兼容性级别 1 管理的 registry 实例的配置对象：在主发行版本中至少为 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.7. Config [samples.operator.openshift.io/v1]
- 描述
- config 包含 Samples Operator 的配置和详细条件状态。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.8. CSISnapshotController [operator.openshift.io/v1]
- 描述
-
CSISnapshotController 提供了配置 Operator 来管理 CSI 快照的方法。
Cluster是规范名称。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。 - 类型
-
对象
1.9. DNS [operator.openshift.io/v1]
- 描述
- DNS 管理 CoreDNS 组件，为集群中的 pod 和服务提供名称解析服务。这支持基于 DNS 的服务发现规格： https://github.com/kubernetes/dns/blob/master/docs/specification.md 更多详情： https://kubernetes.io/docs/tasks/administer-cluster/coredns 兼容性级别 1: 在主发行版本中至少为 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.10. DNSRecord [ingress.operator.openshift.io/v1]
- 描述
- dnsrecord 是 dns.config.openshift.io/cluster .spec.publicZone 和 .spec.privateZone 定义的区域管理的 DNS 记录。不支持此资源的集群管理员操作。此资源仅用于 OpenShift 操作器的内部通信。如果 DNSManagementPolicy 为 "Unmanaged"，Operator 将无法管理云供应商上的 DNS 记录。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.11. Etcd [operator.openshift.io/v1]
- 描述
- etcd 提供配置 Operator 来管理 etcd 的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.12. ImageContentSourcePolicy [operator.openshift.io/v1alpha1]
- 描述
- ImageContentSourcePolicy 包含有关如何处理 registry 镜像规则的集群范围信息。定义了多个策略时，会在每个字段中定义行为的结果。兼容性级别 4：不提供兼容性，API 可能会因为任何原因而有所变化。这些功能不应由需要长期支持的应用程序使用。
- 类型
-
对象
1.13. ImagePruner [imageregistry.operator.openshift.io/v1]
- 描述
- ImagePruner 是由 registry 操作器管理的镜像 registry 修剪器的配置对象。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.14. IngressController [operator.openshift.io/v1]
- 描述
- IngressController 描述了集群的受管入口控制器。控制器可以服务 OpenShift Route 和 Kubernetes Ingress 资源。创建 IngressController 时，会创建一个新的入口控制器部署，以允许外部流量访问公开 Ingress 或 Route 资源的服务。更新此资源可能会导致出现面向公共的网络连接中断，因为可能会推出新的入口控制器修订版本。https://kubernetes.io/docs/concepts/services-networking/ingress-controllers 尽可能减少平台的默认值。如需了解更多详细信息，请参阅每个字段。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object
1.15. InsightsOperator [operator.openshift.io/v1]
- 描述
- InsightsOperator 包含有关 Insights Operator 的集群范围信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.16. KubeAPIServer [operator.openshift.io/v1]
- 描述
- kubeapiserver 提供配置 Operator 来管理 kube-apiserver 的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.17. KubeControllerManager [operator.openshift.io/v1]
- 描述
- kubecontrollermanager 提供配置 Operator 以管理 kube-controller-manager 的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.18. KubeScheduler [operator.openshift.io/v1]
- 描述
- kubescheduler 提供配置操作器以管理调度程序的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.19. KubeStorageVersionMigrator [operator.openshift.io/v1]
- 描述
- KubeStorageVersionMigrator 提供配置 Operator 的信息来管理 kube-storage-version-migrator。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.20. Network [operator.openshift.io/v1]
- 描述
- network 描述了集群所需的网络配置。它被 cluster-network-operator 使用。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.21. OpenShiftAPIServer [operator.openshift.io/v1]
- 描述
- OpenShiftapiserver 提供配置 Operator 来管理 openshift-apiserver 的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.22. OpenShiftControllerManager [operator.openshift.io/v1]
- 描述
- OpenShiftControllerManager 提供配置操作器以管理 openshift-controller-manager 的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.23. OperatorPKI [network.operator.openshift.io/v1]
- 描述
OperatorPKI 是一个简单的证书颁发机构。它不适用于外部使用 - 相反，它是网络操作器的内部。CNO 创建一个 CA 和由该 CA 签名的证书。证书同时启用了 ClientAuth 和 ServerAuth 扩展使用。
More specifically, given an OperatorPKI with <name>, the CNO will manage:
- 名为 <name>-ca 的 Secret，有两个数据键：
- tls.key - 私钥
- tls.crt - CA 证书
- 名为 <name>-ca 的 ConfigMap，带有单个数据键：
- cabundle.crt - CA 证书
- 名为 <name>-cert 的 Secret，有两个数据键：
- tls.key - 私钥
- tls.crt - 由 CA 签名的证书
CA 证书将在 9 后轮转 10 年，有效期为 10 年。目标证书的有效期为 6 个月，在 3 后轮转
CA 证书将有一个 CommonName 为 "<namespace>_<name>-ca@<timestamp>"，其中 <timestamp> 是最后轮转的时间。
- 类型
-
对象
1.24. ServiceCA [operator.openshift.io/v1]
- 描述
- ServiceCA 提供配置 Operator 以管理服务证书控制器兼容性级别 1 的信息：在主发行版本中至少为 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
对象
1.25. Storage [operator.openshift.io/v1]
- 描述
-
存储提供了配置操作器以管理集群存储操作器的方法。
Cluster是规范名称。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。 - 类型
-
对象
第 2 章 Authentication [operator.openshift.io/v1]
- 描述
- 身份验证提供配置操作器以管理身份验证的信息。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object - 必填
-
spec
-
2.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| |
|
|
|
2.1.1. .spec
- 描述
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制，但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| managementState 指明 Operator 是否应该管理组件 |
|
| `` | observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 的级别输入 |
|
|
| operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制，但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
| `` | unsupportedConfigOverrides 覆盖 Operator 计算的最终配置。红帽不支持使用此字段。滥用此字段可能会导致意外行为或与其他配置选项冲突。在使用此字段前，请参阅红帽支持的指导。使用此属性会阻止集群升级，必须在升级集群前删除它。 |
2.1.2. .status
- 描述
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| conditions 是条件及其状态列表 |
|
|
| OperatorCondition 只是标准条件字段。 |
|
|
| 生成用于确定项目是否需要协调或更改是否需要反应。 |
|
|
| GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。 |
|
|
| oauthAPIServer 只保存特定于 oauth-apiserver 的状态 |
|
|
| observedGeneration 是您处理的最后生成更改 |
|
|
| readyReplicas 表示有多少副本就绪并处于所需的状态 |
|
|
| 版本是此可用性适用的级别 |
2.1.3. .status.conditions
- 描述
- conditions 是条件及其状态列表
- 类型
-
array
2.1.4. .status.conditions[]
- 描述
- OperatorCondition 只是标准条件字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
2.1.5. .status.generations
- 描述
- 生成用于确定项目是否需要协调或更改是否需要反应。
- 类型
-
array
2.1.6. .status.generations[]
- 描述
- GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 组是您要跟踪的内容组 |
|
|
| hash 是为没有生成的情况下为资源设置的可选字段，它们是敏感内容，如 secret 和 configmaps |
|
|
| lastGeneration 是涉及的工作负载控制器的最后生成 |
|
|
| name 是您要跟踪的内容的名称 |
|
|
| 命名空间(namespace)是您要跟踪的事情 |
|
|
| 资源是您要跟踪的资源类型 |
2.1.7. .status.oauthAPIServer
- 描述
- oauthAPIServer 只保存特定于 oauth-apiserver 的状态
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| LatestAvailableRevision 是最新的修订版本，用作 encryption-config 等修订 secret 的后缀。新修订版本会导致 pod 的新部署。 |
2.2. API 端点
可用的 API 端点如下：
/apis/operator.openshift.io/v1/authentications-
DELETE：删除身份验证的集合 -
GET: 列出身份验证类型的对象 -
POST：创建身份验证
-
/apis/operator.openshift.io/v1/authentications/{name}-
DELETE：删除身份验证 -
GET：读取指定的身份验证 -
PATCH: 部分更新指定的身份验证 -
PUT：替换指定的身份验证
-
/apis/operator.openshift.io/v1/authentications/{name}/status-
GET：指定身份验证的读取状态 -
PATCH: 部分更新指定身份验证的状态 -
PUT：替换指定身份验证的状态
-
2.2.1. /apis/operator.openshift.io/v1/authentications
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除身份验证集合
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 列出身份验证类型的对象
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
POST - 描述
- 创建身份验证
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 202 - Accepted | |
| 401 - Unauthorized | 空 |
2.2.2. /apis/operator.openshift.io/v1/authentications/{name}
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 身份验证的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除身份验证
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| 应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值为零表示立即删除。如果这个值是 nil，则会使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。 |
|
|
| 弃用：请使用 PropagationPolicy，此字段将在 1.7 中弃用。如果依赖对象是孤立的。如果为 true/false，则 "orphan" finalizer 将添加到对象的终结器列表中。可以设置此字段或 PropagationPolicy，但不能同时设置。 |
|
|
| 是否执行垃圾回收。可以设置此字段或 OrphanDependents，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值有： 'Orphan' - 孤立的依赖项; 'Background' - 允许垃圾收集器删除依赖项，"Foreground' - 删除前台所有依赖的级联策略。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 读取指定的身份验证
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定的身份验证
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定的身份验证
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 401 - Unauthorized | 空 |
2.2.3. /apis/operator.openshift.io/v1/authentications/{name}/status
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 身份验证的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
GET - 描述
- 指定身份验证的读取状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定身份验证的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定身份验证的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 401 - Unauthorized | 空 |
第 3 章 CloudCredential [operator.openshift.io/v1]
- 描述
- CloudCredential 提供了配置 Operator 来管理 CredentialsRequest 的方法。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object - 必填
-
spec
-
3.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| CloudCredentialSpec 是 cloud-credential-operator 所需的行为的规格。 |
|
|
| CloudCredentialStatus 定义 cloud-credential-operator 的观察状态。 |
3.1.1. .spec
- 描述
- CloudCredentialSpec 是 cloud-credential-operator 所需的行为的规格。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| credentialsMode 允许通知 CCO，它不应该尝试动态确定 root 云凭证功能，它应该只在指定模式下运行。如果需要，它还允许将操作器置于"手动"模式。默认模式中的字段运行 CCO，以便集群的云凭证将动态探测到功能（在支持的云/平台中）。支持的模式：AWS/Azure/GCP: "" (Default), "Mint", "Passthrough", "Manual" Others: 不设置值，因为其他平台只支持在"Passthrough"中运行。 |
|
|
| Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制，但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| managementState 指明 Operator 是否应该管理组件 |
|
| `` | observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 的级别输入 |
|
|
| operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制，但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
| `` | unsupportedConfigOverrides 覆盖 Operator 计算的最终配置。红帽不支持使用此字段。滥用此字段可能会导致意外行为或与其他配置选项冲突。在使用此字段前，请参阅红帽支持的指导。使用此属性会阻止集群升级，必须在升级集群前删除它。 |
3.1.2. .status
- 描述
- CloudCredentialStatus 定义 cloud-credential-operator 的观察状态。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| conditions 是条件及其状态列表 |
|
|
| OperatorCondition 只是标准条件字段。 |
|
|
| 生成用于确定项目是否需要协调或更改是否需要反应。 |
|
|
| GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。 |
|
|
| observedGeneration 是您处理的最后生成更改 |
|
|
| readyReplicas 表示有多少副本就绪并处于所需的状态 |
|
|
| 版本是此可用性适用的级别 |
3.1.3. .status.conditions
- 描述
- conditions 是条件及其状态列表
- 类型
-
array
3.1.4. .status.conditions[]
- 描述
- OperatorCondition 只是标准条件字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
3.1.5. .status.generations
- 描述
- 生成用于确定项目是否需要协调或更改是否需要反应。
- 类型
-
array
3.1.6. .status.generations[]
- 描述
- GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 组是您要跟踪的内容组 |
|
|
| hash 是为没有生成的情况下为资源设置的可选字段，它们是敏感内容，如 secret 和 configmaps |
|
|
| lastGeneration 是涉及的工作负载控制器的最后生成 |
|
|
| name 是您要跟踪的内容的名称 |
|
|
| 命名空间(namespace)是您要跟踪的事情 |
|
|
| 资源是您要跟踪的资源类型 |
3.2. API 端点
可用的 API 端点如下：
/apis/operator.openshift.io/v1/cloudcredentials-
DELETE：删除 CloudCredential 集合 -
GET: 列出类型为 CloudCredential 的对象 -
POST：创建 CloudCredential
-
/apis/operator.openshift.io/v1/cloudcredentials/{name}-
DELETE：删除 CloudCredential -
GET：读取指定的 CloudCredential -
PATCH: 部分更新指定的 CloudCredential -
PUT：替换指定的 CloudCredential
-
/apis/operator.openshift.io/v1/cloudcredentials/{name}/status-
GET：指定 CloudCredential 的读取状态 -
PATCH: 部分更新指定 CloudCredential 的状态 -
PUT：替换指定 CloudCredential 的状态
-
3.2.1. /apis/operator.openshift.io/v1/cloudcredentials
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除 CloudCredential 集合
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 列出 CloudCredential 类型的对象
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
POST - 描述
- 创建 CloudCredential
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 202 - Accepted | |
| 401 - Unauthorized | 空 |
3.2.2. /apis/operator.openshift.io/v1/cloudcredentials/{name}
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| CloudCredential 的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除 CloudCredential
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| 应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值为零表示立即删除。如果这个值是 nil，则会使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。 |
|
|
| 弃用：请使用 PropagationPolicy，此字段将在 1.7 中弃用。如果依赖对象是孤立的。如果为 true/false，则 "orphan" finalizer 将添加到对象的终结器列表中。可以设置此字段或 PropagationPolicy，但不能同时设置。 |
|
|
| 是否执行垃圾回收。可以设置此字段或 OrphanDependents，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值有： 'Orphan' - 孤立的依赖项; 'Background' - 允许垃圾收集器删除依赖项，"Foreground' - 删除前台所有依赖的级联策略。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 阅读指定的 CloudCredential
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定的 CloudCredential
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定的 CloudCredential
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 401 - Unauthorized | 空 |
3.2.3. /apis/operator.openshift.io/v1/cloudcredentials/{name}/status
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| CloudCredential 的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
GET - 描述
- 指定 CloudCredential 的读取状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定 CloudCredential 的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定 CloudCredential 的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 401 - Unauthorized | 空 |
第 4 章 ClusterCSIDriver [operator.openshift.io/v1]
- 描述
- ClusterCSIDriver 对象允许在 OpenShift 中默认安装的 CSI 驱动程序 Operator 管理和配置。对象的名称必须是它所运行的 CSI 驱动程序的名称。如需允许的值列表，请参阅 CSIDriverName 类型。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object - 必填
-
spec
-
4.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| spec 包含用于配置的用户可设置值 |
|
|
| status 包含从集群中观察到的值。它们可能无法被覆盖。 |
4.1.1. .spec
- 描述
- spec 包含用于配置的用户可设置值
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| driverConfig 可以用来指定平台特定的驱动程序配置。省略时，这意味着没有建议，平台将保留选择合理的默认值。这些默认值可能会随时间变化。 |
|
|
| Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制，但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| managementState 指明 Operator 是否应该管理组件 |
|
| `` | observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 的级别输入 |
|
|
| operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制，但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| storageClassState 决定 CSI 操作器是否应该创建和管理存储类。如果此字段值为空或 Managed - CSI operator 将持续协调存储类并创建（如果需要）。如果此字段值是 Unmanaged - CSI operator 不会协调任何之前创建的存储类。如果此字段值为 Removed - CSI operator 将删除之前创建的存储类。省略时，这意味着用户没有建议，平台会选择合理的默认值，这可能会随时间变化。当前的默认值是 Managed。 |
|
| `` | unsupportedConfigOverrides 覆盖 Operator 计算的最终配置。红帽不支持使用此字段。滥用此字段可能会导致意外行为或与其他配置选项冲突。在使用此字段前，请参阅红帽支持的指导。使用此属性会阻止集群升级，必须在升级集群前删除它。 |
4.1.2. .spec.driverConfig
- 描述
- driverConfig 可以用来指定平台特定的驱动程序配置。省略时，这意味着没有建议，平台将保留选择合理的默认值。这些默认值可能会随时间变化。
- 类型
-
object - 必填
-
driverType
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| AWS 用于配置 AWS CSI 驱动程序。 |
|
|
| Azure 用于配置 Azure CSI 驱动程序。 |
|
|
| driverType 表示将 driverConfig 应用到的 CSI 驱动程序类型。有效值为： AWS、Azure、GCP、vSphere 和 omitted。消费者应将未知值视为 NO-OP。 |
|
|
| GCP 用于配置 GCP CSI 驱动程序。 |
|
|
| vSphere 用于配置 vsphere CSI 驱动程序。 |
4.1.3. .spec.driverConfig.aws
- 描述
- AWS 用于配置 AWS CSI 驱动程序。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| kmsKeyARN 将集群默认存储类设置为使用用户定义的 KMS 密钥加密卷，而不是 AWS 使用的默认 KMS 密钥。该值可以是 KMS 密钥的 ARN 或 Alias ARN。 |
4.1.4. .spec.driverConfig.azure
- 描述
- Azure 用于配置 Azure CSI 驱动程序。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| DiskEncryptionSet 将集群默认存储类设置为使用客户管理的加密集加密卷，而不是默认的平台管理的密钥。 |
4.1.5. .spec.driverConfig.azure.diskEncryptionSet
- 描述
- DiskEncryptionSet 将集群默认存储类设置为使用客户管理的加密集加密卷，而不是默认的平台管理的密钥。
- 类型
-
object - 必填
-
名称 -
resourceGroup -
subscriptionID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| name 是要在默认存储类上设置的磁盘加密集的名称。该值应仅包含字母字符、下划线(_)、连字符，长度最多为 80 个字符。 |
|
|
| ResourceGroup 定义包含磁盘加密集的 Azure 资源组。该值应仅包含字母字符、下划线(_)、括号、连字符和句点。该值不应以句点结尾，且长度最多为 90 个字符。 |
|
|
| subscriptionId 定义包含磁盘加密集的 Azure 订阅。该值应满足以下条件：1.它应该是 128 位数字。2.长度应该为 36 个字符(32 个十六进制字符和 4 个连字符)。3.它应显示在五个以连字符(-)分隔的组中。4.第一个组长度应为 8 个字符。5.第二、第三和第四个组应长度为 4 个字符。6.第五个组长度应为 12 个字符。一个示例 SubscrionID: f2007bbf-f802-4a47-9336-cf7c6b89b378 |
4.1.6. .spec.driverConfig.gcp
- 描述
- GCP 用于配置 GCP CSI 驱动程序。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| kmsKey 将集群默认存储类设置为使用客户提供的加密密钥加密卷，而不是由 GCP 管理的默认密钥。 |
4.1.7. .spec.driverConfig.gcp.kmsKey
- 描述
- kmsKey 将集群默认存储类设置为使用客户提供的加密密钥加密卷，而不是由 GCP 管理的默认密钥。
- 类型
-
object - 必填
-
keyRing -
名称 -
projectID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| keyring 是 KMS 密钥所属的 KMS 密钥的名称。该值应对应于现有的 KMS 密钥环，且应仅包含字母数字字符、连字符(-)和下划线(_)，长度最多为 63 个字符。 |
|
|
| 位置是密钥 Ring 所在的 GCP 位置。该值必须与现有的 GCP 位置或 "global" 匹配。如果没有设置，则默认为 global。 |
|
|
| name 是用于磁盘加密的客户管理的加密密钥名称。该值应对应于现有的 KMS 密钥，应仅包含字母数字字符、连字符(-)和下划线(_)，长度最多为 63 个字符。 |
|
|
| projectID 是存在 KMS Key Ring 的项目 ID。它必须是 6 到 30 个小写字母、数字或连字符。它必须以字母开头。禁止结尾连字符。 |
4.1.8. .spec.driverConfig.vSphere
- 描述
- vSphere 用于配置 vsphere CSI 驱动程序。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| topologyCategories 表示带有哪些 vcenter 资源（如 hostcluster 或 datacenter）的标签类别。如果集群基础架构对象具有拓扑，则使用 Infrastructure 对象中指定的值并对 topologyCategories 的修改将被拒绝。 |
4.1.9. .status
- 描述
- status 包含从集群中观察到的值。它们可能无法被覆盖。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| conditions 是条件及其状态列表 |
|
|
| OperatorCondition 只是标准条件字段。 |
|
|
| 生成用于确定项目是否需要协调或更改是否需要反应。 |
|
|
| GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。 |
|
|
| observedGeneration 是您处理的最后生成更改 |
|
|
| readyReplicas 表示有多少副本就绪并处于所需的状态 |
|
|
| 版本是此可用性适用的级别 |
4.1.10. .status.conditions
- 描述
- conditions 是条件及其状态列表
- 类型
-
array
4.1.11. .status.conditions[]
- 描述
- OperatorCondition 只是标准条件字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
4.1.12. .status.generations
- 描述
- 生成用于确定项目是否需要协调或更改是否需要反应。
- 类型
-
array
4.1.13. .status.generations[]
- 描述
- GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 组是您要跟踪的内容组 |
|
|
| hash 是为没有生成的情况下为资源设置的可选字段，它们是敏感内容，如 secret 和 configmaps |
|
|
| lastGeneration 是涉及的工作负载控制器的最后生成 |
|
|
| name 是您要跟踪的内容的名称 |
|
|
| 命名空间(namespace)是您要跟踪的事情 |
|
|
| 资源是您要跟踪的资源类型 |
4.2. API 端点
可用的 API 端点如下：
/apis/operator.openshift.io/v1/clustercsidrivers-
DELETE：删除 ClusterCSIDriver 集合 -
GET: 列出 ClusterCSIDriver 类型的对象 -
POST：创建 ClusterCSIDriver
-
/apis/operator.openshift.io/v1/clustercsidrivers/{name}-
DELETE：删除 ClusterCSIDriver -
GET：读取指定的 ClusterCSIDriver -
PATCH: 部分更新指定的 ClusterCSIDriver -
PUT：替换指定的 ClusterCSIDriver
-
/apis/operator.openshift.io/v1/clustercsidrivers/{name}/status-
GET：指定 ClusterCSIDriver 的读取状态 -
PATCH: 部分更新指定 ClusterCSIDriver 的状态 -
PUT：替换指定 ClusterCSIDriver 的状态
-
4.2.1. /apis/operator.openshift.io/v1/clustercsidrivers
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除 ClusterCSIDriver 集合
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 列出 ClusterCSIDriver 类型的对象
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
POST - 描述
- 创建 ClusterCSIDriver
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 202 - Accepted | |
| 401 - Unauthorized | 空 |
4.2.2. /apis/operator.openshift.io/v1/clustercsidrivers/{name}
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| ClusterCSIDriver 的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除 ClusterCSIDriver
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| 应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值为零表示立即删除。如果这个值是 nil，则会使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。 |
|
|
| 弃用：请使用 PropagationPolicy，此字段将在 1.7 中弃用。如果依赖对象是孤立的。如果为 true/false，则 "orphan" finalizer 将添加到对象的终结器列表中。可以设置此字段或 PropagationPolicy，但不能同时设置。 |
|
|
| 是否执行垃圾回收。可以设置此字段或 OrphanDependents，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值有： 'Orphan' - 孤立的依赖项; 'Background' - 允许垃圾收集器删除依赖项，"Foreground' - 删除前台所有依赖的级联策略。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 读取指定的 ClusterCSIDriver
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定的 ClusterCSIDriver
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定的 ClusterCSIDriver
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 401 - Unauthorized | 空 |
4.2.3. /apis/operator.openshift.io/v1/clustercsidrivers/{name}/status
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| ClusterCSIDriver 的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
GET - 描述
- 指定 ClusterCSIDriver 的读取状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定 ClusterCSIDriver 的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定 ClusterCSIDriver 的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK | |
| 201 - Created | |
| 401 - Unauthorized | 空 |
第 5 章 Console [operator.openshift.io/v1]
- 描述
- 控制台提供了一种方法来配置操作器来管理控制台。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object - 必填
-
spec
-
5.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| ConsoleSpec 是控制台所需行为的规格。 |
|
|
| ConsoleStatus 定义 Console 的观察状态。 |
5.1.1. .spec
- 描述
- ConsoleSpec 是控制台所需行为的规格。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 自定义用于选择性地为 web 控制台提供一组较小的自定义选项。 |
|
|
| Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制，但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| managementState 指明 Operator 是否应该管理组件 |
|
| `` | observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 的级别输入 |
|
|
| operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制，但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| 插件定义启用的控制台插件名称列表。 |
|
|
| 提供程序包含使用特定服务提供商的配置。 |
|
|
| 路由包含包含服务证书的主机名和 secret 引用。如果指定了自定义路由，则会使用提供的主机名创建新路由，该主机名下提供控制台。如果自定义主机名使用集群的默认路由后缀，则不需要服务证书的 Secret 规格。如果自定义主机名指向任意域，则需要手动 DNS 配置步骤。如果删除了自定义路由，则会维护默认控制台路由，以便为控制台保留默认主机名。如果没有指定，则使用默认路由。弃用 |
|
| `` | unsupportedConfigOverrides 覆盖 Operator 计算的最终配置。红帽不支持使用此字段。滥用此字段可能会导致意外行为或与其他配置选项冲突。在使用此字段前，请参阅红帽支持的指导。使用此属性会阻止集群升级，必须在升级集群前删除它。 |
5.1.2. .spec.customization
- 描述
- 自定义用于选择性地为 web 控制台提供一组较小的自定义选项。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| addPage 允许在 Developer 视角中的 Add 页面中自定义操作。 |
|
|
| brand 是 Web 控制台的默认品牌，可通过提供品牌字段来覆盖。有有限的特定品牌选项。此字段控制控制台的元素，如徽标。无效的值将导致控制台推出部署。 |
|
|
| customLogoFile 替换 masthead 和 about 对话框中的默认 OpenShift 徽标。它是对 openshift-config 命名空间中的 ConfigMap 的引用。这可以通过 'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config' 等命令来创建。由于 ConfigMap 大小的限制，镜像大小必须小于 1 MB。ConfigMap 键应包含文件扩展名，以便控制台提供具有正确 MIME 类型的文件。推荐的徽标规格：Dimensions: Max height of 68px，首选最大宽度 200px SVG |
|
|
| customProductName 是页面标题、徽标 alt 文本以及有关对话框而不是普通的 OpenShift 产品名称显示的名称。 |
|
|
| developerCatalog 允许配置显示的开发人员目录类别(filters)和类型(sub-catalogs)。 |
|
|
| Web 控制台的各种部分中显示了到外部文档的 DocumentationBaseURL 链接。提供 DocumentationBaseURL 将覆盖默认文档 URL。无效的值将导致控制台推出部署。 |
|
|
| 透视图允许启用/禁用用户在视角切换器下拉菜单中可见的视角。 |
|
|
| 视角定义了集群管理员要在视角切换器下拉菜单中显示/隐藏的视角 |
|
|
| ProjectAccess 允许在 Developer 视角 Project 访问页面中自定义可用 ClusterRole 列表，供项目 admin 用于指定角色到其他用户，并限制项目中的访问。如果设置，列表将替换默认的 ClusterRole 选项。 |
|
|
| Quickstarts 允许在控制台中自定义可用的 ConsoleQuickStart 资源。 |
5.1.3. .spec.customization.addPage
- 描述
- addPage 允许在 Developer 视角中的 Add 页面中自定义操作。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| disabledActions 是未向用户显示的操作列表。列表中的每个操作都由其 ID 表示。 |
5.1.4. .spec.customization.customLogoFile
- 描述
- customLogoFile 替换 masthead 和 about 对话框中的默认 OpenShift 徽标。它是对 openshift-config 命名空间中的 ConfigMap 的引用。这可以通过 'oc create configmap custom-logo --from-file=/path/to/file -n openshift-config' 等命令来创建。由于 ConfigMap 大小的限制，镜像大小必须小于 1 MB。ConfigMap 键应包含文件扩展名，以便控制台提供具有正确 MIME 类型的文件。推荐的徽标规格：Dimensions: Max height of 68px，首选最大宽度 200px SVG
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 键允许指向 configmap 中的特定键/值。这对逻辑文件引用非常有用。 |
|
|
|
5.1.5. .spec.customization.developerCatalog
- 描述
- developerCatalog 允许配置显示的开发人员目录类别(filters)和类型(sub-catalogs)。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 开发人员目录中显示的类别。 |
|
|
| DeveloperConsoleCatalogCategory 用于开发人员控制台目录。 |
|
|
| Type 允许启用或禁用用户可以在 Developer 目录中看到的子目录类型。如果省略时，将显示所有子目录类型。 |
5.1.6. .spec.customization.developerCatalog.categories
- 描述
- 开发人员目录中显示的类别。
- 类型
-
array
5.1.7. .spec.customization.developerCatalog.categories[]
- 描述
- DeveloperConsoleCatalogCategory 用于开发人员控制台目录。
- 类型
-
object - 必填
-
id -
label
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| ID 是 URL 中用来在控制台中启用深度链接的标识符。ID 是必需的，且必须具有 1-32 URL 安全(A-Z、a-z、0-9、- 和 _)。 |
|
|
| 标签定义类别显示标签。它是必需的，且必须具有 1-64 个字符。 |
|
|
| subcategories 定义子类别列表。 |
|
|
| DeveloperConsoleCatalogCategoryMeta 是开发人员目录类别的密钥标识符。 |
|
|
| tags 是与类别匹配的字符串列表。所选类别显示所有在类别和项目之间至少有一个重叠标签的项目。 |
5.1.8. .spec.customization.developerCatalog.categories[].subcategories
- 描述
- subcategories 定义子类别列表。
- 类型
-
array
5.1.9. .spec.customization.developerCatalog.categories[].subcategories[]
- 描述
- DeveloperConsoleCatalogCategoryMeta 是开发人员目录类别的密钥标识符。
- 类型
-
object - 必填
-
id -
label
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| ID 是 URL 中用来在控制台中启用深度链接的标识符。ID 是必需的，且必须具有 1-32 URL 安全(A-Z、a-z、0-9、- 和 _)。 |
|
|
| 标签定义类别显示标签。它是必需的，且必须具有 1-64 个字符。 |
|
|
| tags 是与类别匹配的字符串列表。所选类别显示所有在类别和项目之间至少有一个重叠标签的项目。 |
5.1.10. .spec.customization.developerCatalog.types
- 描述
- Type 允许启用或禁用用户可以在 Developer 目录中看到的子目录类型。如果省略时，将显示所有子目录类型。
- 类型
-
object - 必填
-
state
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| disabled 是未向用户显示的开发人员目录类型(sub-catalogs ID)列表。通过控制台插件添加类型(sub-catalogs)，可用的类型(sub-catalog ID)可在集群配置页面上提供，或在控制台中编辑 YAML 时。示例："Devfile", "HelmChart", "BuilderImage"，如果列表为空，或添加了所有可用的子目录类型，则应隐藏完整的开发人员目录。 |
|
|
| enabled 是开发人员目录类型(sub-catalogs ID)的列表，它将向用户显示。通过控制台插件添加类型(sub-catalogs)，可用的类型(sub-catalog ID)可在集群配置页面上提供，或在控制台中编辑 YAML 时。示例："Devfile", "HelmChart", "BuilderImage"，如果列表不是空的，则不会向用户显示一个新的类型，直到它添加到列表为止。如果列表为空，则会显示完整的开发人员目录。 |
|
|
| State 定义是否应启用或禁用目录类型列表。 |
5.1.11. .spec.customization.perspectives
- 描述
- 透视图允许启用/禁用用户在视角切换器下拉菜单中可见的视角。
- 类型
-
数组
5.1.12. .spec.customization.perspectives[]
- 描述
- 视角定义了集群管理员要在视角切换器下拉菜单中显示/隐藏的视角
- 类型
-
object - 必填
-
id -
可见性
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| id 定义视角的 id。示例："dev", "admin"。可用的视角 id 可以在 yaml 编辑器旁边的代码片段部分找到。不正确的或未知 ID 将被忽略。 |
|
|
|
pinnedResources 定义默认固定资源列表，如果用户没有自定义这些固定资源本身，用户会在视角导航中看到这些固定资源。可以通过 |
|
|
| PinnedResourceReference 包括组、版本和资源类型 |
|
|
| 可见性定义了视角的状态，以及该视角是否需要访问检查。 |
5.1.13. .spec.customization.perspectives[].pinnedResources
- 描述
-
pinnedResources 定义默认固定资源列表，如果用户没有自定义这些固定资源本身，用户会在视角导航中看到这些固定资源。可以通过
kubectl api-resources读取可用的 Kubernetes 资源列表。控制台还会提供一个配置 UI 和 YAML 片断，用于列出可固定到导航的可用资源。不正确的或未知资源将被忽略。 - 类型
-
数组
5.1.14. .spec.customization.perspectives[].pinnedResources[]
- 描述
- PinnedResourceReference 包括组、版本和资源类型
- 类型
-
object - 必填
-
group -
resource -
version
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Group 是资源的 API 组。为 core 组输入空字符串。这个值应该只包含小写字母数字字符、连字符和句点。示例： ""、"apps"、"build.openshift.io"等。 |
|
|
| resource 是被引用的类型。它通常是小写的资源类型的复数形式。这个值应该只包含小写字母数字字符和连字符。示例："deployments", "deploymentconfigs", "pods" 等。 |
|
|
| version 是资源的 API 版本。这个值应该只包含小写字母数字字符。示例："v1", "v1beta1", 等。 |
5.1.15. .spec.customization.perspectives[].visibility
- 描述
- 可见性定义了视角的状态，以及该视角是否需要访问检查。
- 类型
-
object - 必填
-
state
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| accessReview 定义 required 和 missing access review 检查。 |
|
|
| State 定义透视图为 enabled 或 disabled 或 access review check。 |
5.1.16. .spec.customization.perspectives[].visibility.accessReview
- 描述
- accessReview 定义 required 和 missing access review 检查。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| missing 定义权限检查列表。只有在至少有一个检查失败时，才会显示视角。省略时，会跳过访问审核，并且不会显示视角，除非需要根据所需访问查看列表的配置进行配置。 |
|
|
| ResourceAttributes 包含对 Authorizer 接口的资源请求的授权属性 |
|
|
| 必需定义权限检查列表。只有在所有检查都成功时才会显示视角。省略时，会跳过访问审核，并且不会显示视角，除非需要根据缺少访问查看列表的配置进行配置。 |
|
|
| ResourceAttributes 包含对 Authorizer 接口的资源请求的授权属性 |
5.1.17. .spec.customization.perspectives[].visibility.accessReview.missing
- 描述
- missing 定义权限检查列表。只有在至少有一个检查失败时，才会显示视角。省略时，会跳过访问审核，并且不会显示视角，除非需要根据所需访问查看列表的配置进行配置。
- 类型
-
数组
5.1.18. .spec.customization.perspectives[].visibility.accessReview.missing[]
- 描述
- ResourceAttributes 包含对 Authorizer 接口的资源请求的授权属性
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Group 是 Resource 的 API 组。"*"代表所有。 |
|
|
| Name 是为"get"请求的资源的名称，或删除"delete"。"" （空）表示全部。 |
|
|
| namespace 是所请求操作的命名空间。目前，对于集群范围的资源 "" (empty)，没有命名空间和所有命名空间"" （空）之间的差别，对于集群范围的资源 "" （空）代表"all"表示来自 SubjectAccessReview 或 SelfSubjectAccessReview 的命名空间范围资源 |
|
|
| 资源是现有资源类型之一。"*"表示全部。 |
|
|
| 子资源是现有资源类型之一。""表示 none。 |
|
|
| verb 是一个 kubernetes 资源 API 动词，如： get, list, watch, create, update, delete, proxy. "*" 表示所有。 |
|
|
| version 是资源的 API 版本。"*"表示所有。 |
5.1.19. .spec.customization.perspectives[].visibility.accessReview.required
- 描述
- 必需定义权限检查列表。只有在所有检查都成功时才会显示视角。省略时，会跳过访问审核，并且不会显示视角，除非需要根据缺少访问查看列表的配置进行配置。
- 类型
-
数组
5.1.20. .spec.customization.perspectives[].visibility.accessReview.required[]
- 描述
- ResourceAttributes 包含对 Authorizer 接口的资源请求的授权属性
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Group 是 Resource 的 API 组。"*"代表所有。 |
|
|
| Name 是为"get"请求的资源的名称，或删除"delete"。"" （空）表示全部。 |
|
|
| namespace 是所请求操作的命名空间。目前，对于集群范围的资源 "" (empty)，没有命名空间和所有命名空间"" （空）之间的差别，对于集群范围的资源 "" （空）代表"all"表示来自 SubjectAccessReview 或 SelfSubjectAccessReview 的命名空间范围资源 |
|
|
| 资源是现有资源类型之一。"*"表示全部。 |
|
|
| 子资源是现有资源类型之一。""表示 none。 |
|
|
| verb 是一个 kubernetes 资源 API 动词，如： get, list, watch, create, update, delete, proxy. "*" 表示所有。 |
|
|
| version 是资源的 API 版本。"*"表示所有。 |
5.1.21. .spec.customization.projectAccess
- 描述
- ProjectAccess 允许在 Developer 视角 Project 访问页面中自定义可用 ClusterRole 列表，供项目 admin 用于指定角色到其他用户，并限制项目中的访问。如果设置，列表将替换默认的 ClusterRole 选项。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| availableClusterRoles 是 ClusterRole 名称列表，可通过项目访问标签页分配给用户。 |
5.1.22. .spec.customization.quickStarts
- 描述
- Quickstarts 允许在控制台中自定义可用的 ConsoleQuickStart 资源。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| disabled 是用户未显示的 ConsoleQuickStart 资源名称的列表。 |
5.1.23. .spec.providers
- 描述
- 提供程序包含使用特定服务提供商的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 状态页面包含 statuspage.io 页面的 ID，其中提供了状态信息。 |
5.1.24. .spec.providers.statuspage
- 描述
- 状态页面包含 statuspage.io 页面的 ID，其中提供了状态信息。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| pageID 是页面的 Statuspage 分配的唯一 ID。这必须是公共页面。 |
5.1.25. .spec.route
- 描述
- 路由包含包含服务证书的主机名和 secret 引用。如果指定了自定义路由，则会使用提供的主机名创建新路由，该主机名下提供控制台。如果自定义主机名使用集群的默认路由后缀，则不需要服务证书的 Secret 规格。如果自定义主机名指向任意域，则需要手动 DNS 配置步骤。如果删除了自定义路由，则会维护默认控制台路由，以便为控制台保留默认主机名。如果没有指定，则使用默认路由。弃用
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| hostname 是所需的自定义域，控制台将在其中可用。 |
|
|
| secret 指向 openshift-config 命名空间中的 secret，其中包含自定义证书和密钥，需要由集群管理员手动创建。引用的 Secret 需要包含以下键值对： - "tls.crt" - 指定自定义证书 - "tls.key" - 指定自定义证书的私钥（如果自定义主机名使用集群的默认路由后缀），则不需要服务证书的 Secret 规格。 |
5.1.26. .spec.route.secret
- 描述
- secret 指向 openshift-config 命名空间中的 secret，其中包含自定义证书和密钥，需要由集群管理员手动创建。引用的 Secret 需要包含以下键值对： - "tls.crt" - 指定自定义证书 - "tls.key" - 指定自定义证书的私钥（如果自定义主机名使用集群的默认路由后缀），则不需要服务证书的 Secret 规格。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| name 是引用的 secret 的 metadata.name |
5.1.27. .status
- 描述
- ConsoleStatus 定义 Console 的观察状态。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| conditions 是条件及其状态列表 |
|
|
| OperatorCondition 只是标准条件字段。 |
|
|
| 生成用于确定项目是否需要协调或更改是否需要反应。 |
|
|
| GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。 |
|
|
| observedGeneration 是您处理的最后生成更改 |
|
|
| readyReplicas 表示有多少副本就绪并处于所需的状态 |
|
|
| 版本是此可用性适用的级别 |
5.1.28. .status.conditions
- 描述
- conditions 是条件及其状态列表
- 类型
-
array
5.1.29. .status.conditions[]
- 描述
- OperatorCondition 只是标准条件字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
5.1.30. .status.generations
- 描述
- 生成用于确定项目是否需要协调或更改是否需要反应。
- 类型
-
array
5.1.31. .status.generations[]
- 描述
- GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 组是您要跟踪的内容组 |
|
|
| hash 是为没有生成的情况下为资源设置的可选字段，它们是敏感内容，如 secret 和 configmaps |
|
|
| lastGeneration 是涉及的工作负载控制器的最后生成 |
|
|
| name 是您要跟踪的内容的名称 |
|
|
| 命名空间(namespace)是您要跟踪的事情 |
|
|
| 资源是您要跟踪的资源类型 |
5.2. API 端点
可用的 API 端点如下：
/apis/operator.openshift.io/v1/consoles-
DELETE：删除控制台集合 -
GET: 列出类型为 Console 的对象 -
POST：创建控制台
-
/apis/operator.openshift.io/v1/consoles/{name}-
DELETE：删除控制台 -
GET：读取指定的控制台 -
PATCH: 部分更新指定的控制台 -
PUT：替换指定的控制台
-
/apis/operator.openshift.io/v1/consoles/{name}/status-
GET：指定控制台的读取状态 -
PATCH: 部分更新指定控制台的状态 -
PUT：替换指定控制台的状态
-
5.2.1. /apis/operator.openshift.io/v1/consoles
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除控制台集合
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 列出控制台的对象
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
POST - 描述
- 创建控制台
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
5.2.2. /apis/operator.openshift.io/v1/consoles/{name}
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 控制台名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除控制台
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| 应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值为零表示立即删除。如果这个值是 nil，则会使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。 |
|
|
| 弃用：请使用 PropagationPolicy，此字段将在 1.7 中弃用。如果依赖对象是孤立的。如果为 true/false，则 "orphan" finalizer 将添加到对象的终结器列表中。可以设置此字段或 PropagationPolicy，但不能同时设置。 |
|
|
| 是否执行垃圾回收。可以设置此字段或 OrphanDependents，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值有： 'Orphan' - 孤立的依赖项; 'Background' - 允许垃圾收集器删除依赖项，"Foreground' - 删除前台所有依赖的级联策略。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 读取指定的控制台
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定的控制台
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定的控制台
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 401 - Unauthorized | 空 |
5.2.3. /apis/operator.openshift.io/v1/consoles/{name}/status
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 控制台名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
GET - 描述
- 指定控制台的读取状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定控制台的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定控制台的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 401 - Unauthorized | 空 |
第 6 章 Config [operator.openshift.io/v1]
- 描述
- config 指定 config operator 的行为，它负责在集群中创建其他组件的初始配置。Operator 还处理 AWS 和基于 Azure 云的集群兼容性等级 1 的安装、迁移或同步云配置：在主发行版本中至少需要 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object - 必填
-
spec
-
6.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| spec 是 Config Operator 所需的行为的规格。 |
|
|
| Status 定义 Config Operator 的观察状态。 |
6.1.1. .spec
- 描述
- spec 是 Config Operator 所需的行为的规格。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制，但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| managementState 指明 Operator 是否应该管理组件 |
|
| `` | observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 的级别输入 |
|
|
| operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制，但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
| `` | unsupportedConfigOverrides 覆盖 Operator 计算的最终配置。红帽不支持使用此字段。滥用此字段可能会导致意外行为或与其他配置选项冲突。在使用此字段前，请参阅红帽支持的指导。使用此属性会阻止集群升级，必须在升级集群前删除它。 |
6.1.2. .status
- 描述
- Status 定义 Config Operator 的观察状态。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| conditions 是条件及其状态列表 |
|
|
| OperatorCondition 只是标准条件字段。 |
|
|
| 生成用于确定项目是否需要协调或更改是否需要反应。 |
|
|
| GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。 |
|
|
| observedGeneration 是您处理的最后生成更改 |
|
|
| readyReplicas 表示有多少副本就绪并处于所需的状态 |
|
|
| 版本是此可用性适用的级别 |
6.1.3. .status.conditions
- 描述
- conditions 是条件及其状态列表
- 类型
-
array
6.1.4. .status.conditions[]
- 描述
- OperatorCondition 只是标准条件字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
6.1.5. .status.generations
- 描述
- 生成用于确定项目是否需要协调或更改是否需要反应。
- 类型
-
array
6.1.6. .status.generations[]
- 描述
- GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 组是您要跟踪的内容组 |
|
|
| hash 是为没有生成的情况下为资源设置的可选字段，它们是敏感内容，如 secret 和 configmaps |
|
|
| lastGeneration 是涉及的工作负载控制器的最后生成 |
|
|
| name 是您要跟踪的内容的名称 |
|
|
| 命名空间(namespace)是您要跟踪的事情 |
|
|
| 资源是您要跟踪的资源类型 |
6.2. API 端点
可用的 API 端点如下：
/apis/operator.openshift.io/v1/configs-
DELETE：删除配置集合 -
GET: 列出类型为 Config 的对象 -
POST：创建配置
-
/apis/operator.openshift.io/v1/configs/{name}-
DELETE：删除配置 -
GET：读取指定的配置 -
PATCH: 部分更新指定的配置 -
PUT：替换指定的 Config
-
/apis/operator.openshift.io/v1/configs/{name}/status-
GET：指定配置的读取状态 -
PATCH: 部分更新指定配置的状态 -
PUT：替换指定配置的状态
-
6.2.1. /apis/operator.openshift.io/v1/configs
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除配置集合
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 列出类型为 Config 的对象
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。不实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须重启其列表，而无需 continue 字段。否则，客户端可能会发送另一个带有 410 错误接收的令牌的列表请求，服务器将以从下一个密钥开始开始的列表响应，但从最新的快照开始，这与上一个列表结果中不一致 - 在第一个列表请求后将包含在响应中，只要它们的密钥位于 "next key" 后。 当 watch 为 true 时不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值开始监视，而不丢失任何修改。 |
|
|
| 一个选择器，用于限制其字段返回的对象列表。默认为任何内容。 |
|
|
| 一个选择器，用于限制其标签返回的对象列表。默认为任何内容。 |
|
|
|
limit 是列表调用返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的 服务器保证，在使用时返回的对象将与在没有限制限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后没有创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制来接收非常大结果的较小的块的客户端可确保它们看到所有可能的对象。如果在块列表中更新对象，则返回第一个列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定如何将 resourceVersion 应用到列表调用。强烈建议您为设置 resourceVersion 的 list 调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
|
当设置
如果 |
|
|
| 列表/watch 调用的超时。这限制了调用的持续时间，无论任何活动或不活跃。 |
|
|
| 观察对所描述资源的更改，并将它们作为添加、更新和删除通知的流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
POST - 描述
- 创建配置
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
6.2.2. /apis/operator.openshift.io/v1/configs/{name}
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| Config 的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
DELETE - 描述
- 删除配置
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| 应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值为零表示立即删除。如果这个值是 nil，则会使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。 |
|
|
| 弃用：请使用 PropagationPolicy，此字段将在 1.7 中弃用。如果依赖对象是孤立的。如果为 true/false，则 "orphan" finalizer 将添加到对象的终结器列表中。可以设置此字段或 PropagationPolicy，但不能同时设置。 |
|
|
| 是否执行垃圾回收。可以设置此字段或 OrphanDependents，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值有： 'Orphan' - 孤立的依赖项; 'Background' - 允许垃圾收集器删除依赖项，"Foreground' - 删除前台所有依赖的级联策略。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 读取指定的 Config
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定的配置
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定的 Config
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 401 - Unauthorized | 空 |
6.2.3. /apis/operator.openshift.io/v1/configs/{name}/status
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| Config 的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
GET - 描述
- 指定配置的读取状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定配置的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对非应用补丁类型(JsonPatch、MergePatch、MergePatch)是可选的。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 强制要"强制"应用请求。这意味着用户将重新分配由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PUT - 描述
- 替换指定配置的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 401 - Unauthorized | 空 |
第 7 章 Config [imageregistry.operator.openshift.io/v1]
- 描述
- config 是 registry operator 兼容性级别 1 管理的 registry 实例的配置对象：在主发行版本中至少为 12 个月或 3 个次版本（以更长的时间为准）。
- 类型
-
object - 必填
-
metadata -
spec
-
7.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| ImageRegistrySpec 定义正在运行的 registry 的 spec。 |
|
|
| ImageRegistryStatus 报告镜像 registry 操作状态。 |
7.1.1. .spec
- 描述
- ImageRegistrySpec 定义正在运行的 registry 的 spec。
- 类型
-
object - 必填
-
replicas
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| affinity 是一组节点关联性调度规则，用于镜像 registry pod。 |
|
|
| defaultRoute 表示是否应使用默认生成的主机名创建面向外部的路由。 |
|
|
| disableRedirect 控制是否通过 Registry 路由所有数据，而不是重定向到后端。 |
|
|
| httpSecret 是 registry 安全上传所需的值，默认生成。 |
|
|
| Loglevel 是整个组件的意图型日志记录。它无法提供精细的控制，但管理操作员必须针对其操作对象解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| Logging 已被弃用，使用 logLevel 替代。 |
|
|
| managementState 指明 Operator 是否应该管理组件 |
|
|
| nodeSelector 为 registry pod 定义节点选择限制。 |
|
| `` | observedConfig 包含一个从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 的级别输入 |
|
|
| operatorLogLevel 是 Operator 本身的意图日志。它无法提供精细的控制，但管理操作员必须自行解释的粗粒度日志记录选择是一个简单的方法。有效值为："Normal", "Debug", "Trace", "TraceAll"。默认值为 "Normal"。 |
|
|
| 代理定义调用 master api、上游 registry 等时使用的代理。 |
|
|
| readonly 表示 registry 实例是否应该拒绝推送新镜像或删除现有镜像的尝试。 |
|
|
| replicas 决定要运行的 registry 实例的数量。 |
|
|
| 请求控制给定 registry 实例在排队额外请求前可以处理多少个并行请求。 |
|
|
| 资源定义 registry Pod 的资源请求+limits。 |
|
|
| rolloutStrategy 为镜像 registry 部署定义 rollout 策略。 |
|
|
| 路由定义应该为 registry 创建的其他面向外部的路由。 |
|
|
| ImageRegistryConfigRoute 包含有关对镜像 registry 的外部路由访问的信息。 |
|
|
| 配置 registry 存储的存储详情，如 S3 存储桶协调。 |
|
|
| 容限(toleration)定义了 registry pod 的容限。 |
|
|
| 此 Toleration 附加到 pod，以使用匹配的 operator <operator> 容许与 triple <key,value,effect> 匹配的任何污点。 |
|
|
| topologySpreadConstraints 指定如何在给定的拓扑中分布匹配的 pod。 |
|
|
| TopologySpreadConstraint 指定如何在给定的拓扑中分布匹配的 pod。 |
|
| `` | unsupportedConfigOverrides 覆盖 Operator 计算的最终配置。红帽不支持使用此字段。滥用此字段可能会导致意外行为或与其他配置选项冲突。在使用此字段前，请参阅红帽支持的指导。使用此属性会阻止集群升级，必须在升级集群前删除它。 |
7.1.2. .spec.affinity
- 描述
- affinity 是一组节点关联性调度规则，用于镜像 registry pod。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 描述 pod 的节点关联性调度规则。 |
|
|
| 描述 pod 关联性调度规则（例如，将这个 pod 位于同一个节点、区等）中。 |
|
|
| 描述 pod 反关联性调度规则（例如，避免将此 pod 放置到同一个节点、区等）。 |
7.1.3. .spec.affinity.nodeAffinity
- 描述
- 描述 pod 的节点关联性调度规则。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、必需关联表达式等）的每个节点，计算出一个总和总和总和总和（如果节点与相应的 matchExpressions 匹配），则计算总和最高的节点是最首选的。 |
|
|
| 空白的首选调度术语与带有隐式权重 0 （例如，它的一个 no-op）的所有对象匹配。空首选调度术语不匹配任何对象（例如，也是 no-op）。 |
|
|
| 如果在调度时没有满足此字段指定的关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足（例如，由于更新），则系统可能或可能无法最终从其节点驱除 pod。 |
7.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 描述
- 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、必需关联表达式等）的每个节点，计算出一个总和总和总和总和（如果节点与相应的 matchExpressions 匹配），则计算总和最高的节点是最首选的。
- 类型
-
array
7.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 描述
- 空白的首选调度术语与带有隐式权重 0 （例如，它的一个 no-op）的所有对象匹配。空首选调度术语不匹配任何对象（例如，也是 no-op）。
- 类型
-
object - 必填
-
preference -
weight
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 与对应权重关联的节点选择器术语。 |
|
|
| 与对应 nodeSelectorTerm 关联的权重，范围为 1-100。 |
7.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference
- 描述
- 与对应权重关联的节点选择器术语。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 按节点标签划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| 按节点字段划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
7.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions
- 描述
- 按节点标签划分的节点选择器要求列表。
- 类型
-
array
7.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]
- 描述
- 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果运算符是 Gt 或 Lt，则值数组必须具有单个元素，它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
7.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields
- 描述
- 按节点字段划分的节点选择器要求列表。
- 类型
-
array
7.1.10. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields[]
- 描述
- 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果运算符是 Gt 或 Lt，则值数组必须具有单个元素，它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
7.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 描述
- 如果在调度时没有满足此字段指定的关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足（例如，由于更新），则系统可能或可能无法最终从其节点驱除 pod。
- 类型
-
object - 必填
-
nodeSelectorTerms
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需。节点选择器术语列表。术语为 ORed。 |
|
|
| null 或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。 |
7.1.12. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms
- 描述
- 必需。节点选择器术语列表。术语为 ORed。
- 类型
-
array
7.1.13. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]
- 描述
- null 或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 按节点标签划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| 按节点字段划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
7.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions
- 描述
- 按节点标签划分的节点选择器要求列表。
- 类型
-
array
7.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]
- 描述
- 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果运算符是 Gt 或 Lt，则值数组必须具有单个元素，它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
7.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields
- 描述
- 按节点字段划分的节点选择器要求列表。
- 类型
-
array
7.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields[]
- 描述
- 节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果运算符是 Gt 或 Lt，则值数组必须具有单个元素，它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
7.1.18. .spec.affinity.podAffinity
- 描述
- 描述 pod 关联性调度规则（例如，将这个 pod 位于同一个节点、区等）中。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点（即，对于满足所有调度要求的节点(resource request、requiredDuringScheduling 关联性表达式等)的每个节点，计算并迭代此字段元素，并在节点具有与对应 podAffinityTerm 匹配的 pod 时，将"weight"添加到总和（如果节点具有最高 podAffinityTerm）、具有最高总和最高的节点是首选。 |
|
|
| 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点，以查找最首选节点。 |
|
|
| 如果在调度时没有满足此字段指定的关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足（例如，由于 pod 标签更新），则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时，与每个 podAffinityTerm 对应的节点列表都会被交集，例如必须满足所有术语。 |
|
|
| 定义一组 pod （即，与给定命名空间相对 labelSelector 匹配的 labelSelector ），该 pod 应该与 pod 共同定位（反关联性）或没有共同定位（反关联性）的节点上运行，其中 co-located 在具有键 <topologyKey> 标签的节点上运行，它与其上运行一组 pod 的 pod 匹配。 |
7.1.19. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 描述
- 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点（即，对于满足所有调度要求的节点(resource request、requiredDuringScheduling 关联性表达式等)的每个节点，计算并迭代此字段元素，并在节点具有与对应 podAffinityTerm 匹配的 pod 时，将"weight"添加到总和（如果节点具有最高 podAffinityTerm）、具有最高总和最高的节点是首选。
- 类型
-
array
7.1.20. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 描述
- 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点，以查找最首选节点。
- 类型
-
object - 必填
-
podAffinityTerm -
weight
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需。与对应权重关联的 pod 关联性术语。 |
|
|
| 与对应的 podAffinityTerm 关联的权重，范围为 1-100。 |
7.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 描述
- 必需。与对应权重关联的 pod 关联性术语。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询，本例中为 pod。 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
7.1.22. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector
- 描述
- 对一组资源进行标签查询，本例中为 pod。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.23. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.24. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.25. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.26. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.27. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.28. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 描述
- 如果在调度时没有满足此字段指定的关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足（例如，由于 pod 标签更新），则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时，与每个 podAffinityTerm 对应的节点列表都会被交集，例如必须满足所有术语。
- 类型
-
array
7.1.29. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]
- 描述
- 定义一组 pod （即，与给定命名空间相对 labelSelector 匹配的 labelSelector ），该 pod 应该与 pod 共同定位（反关联性）或没有共同定位（反关联性）的节点上运行，其中 co-located 在具有键 <topologyKey> 标签的节点上运行，它与其上运行一组 pod 的 pod 匹配。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询，本例中为 pod。 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
7.1.30. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector
- 描述
- 对一组资源进行标签查询，本例中为 pod。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.31. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.32. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.33. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.34. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.35. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.36. .spec.affinity.podAntiAffinity
- 描述
- 描述 pod 反关联性调度规则（例如，避免将此 pod 放置到同一个节点、区等）。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 调度程序更喜欢将 pod 调度到满足此字段指定的反关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 反关联性表达式等）的每个节点，计算通过此字段元素来计算总和总和（如果节点具有与对应的 podAffinityTerm 匹配的 pod）的总和。 |
|
|
| 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点，以查找最首选节点。 |
|
|
| 如果在调度时没有满足此字段指定的反关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的反关联性要求在 Pod 执行期间某一点满足（例如，由于 pod 标签更新），则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时，与每个 podAffinityTerm 对应的节点列表都会被交集，例如必须满足所有术语。 |
|
|
| 定义一组 pod （即，与给定命名空间相对 labelSelector 匹配的 labelSelector ），该 pod 应该与 pod 共同定位（反关联性）或没有共同定位（反关联性）的节点上运行，其中 co-located 在具有键 <topologyKey> 标签的节点上运行，它与其上运行一组 pod 的 pod 匹配。 |
7.1.37. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution
- 描述
- 调度程序更喜欢将 pod 调度到满足此字段指定的反关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 反关联性表达式等）的每个节点，计算通过此字段元素来计算总和总和（如果节点具有与对应的 podAffinityTerm 匹配的 pod）的总和。
- 类型
-
array
7.1.38. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]
- 描述
- 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点，以查找最首选节点。
- 类型
-
object - 必填
-
podAffinityTerm -
weight
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需。与对应权重关联的 pod 关联性术语。 |
|
|
| 与对应的 podAffinityTerm 关联的权重，范围为 1-100。 |
7.1.39. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 描述
- 必需。与对应权重关联的 pod 关联性术语。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询，本例中为 pod。 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
7.1.40. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector
- 描述
- 对一组资源进行标签查询，本例中为 pod。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.41. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.42. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.labelSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.43. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.44. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.45. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm.namespaceSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.46. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 描述
- 如果在调度时没有满足此字段指定的反关联性要求，则 pod 不会被调度到该节点上。如果此字段指定的反关联性要求在 Pod 执行期间某一点满足（例如，由于 pod 标签更新），则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时，与每个 podAffinityTerm 对应的节点列表都会被交集，例如必须满足所有术语。
- 类型
-
array
7.1.47. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]
- 描述
- 定义一组 pod （即，与给定命名空间相对 labelSelector 匹配的 labelSelector ），该 pod 应该与 pod 共同定位（反关联性）或没有共同定位（反关联性）的节点上运行，其中 co-located 在具有键 <topologyKey> 标签的节点上运行，它与其上运行一组 pod 的 pod 匹配。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询，本例中为 pod。 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
7.1.48. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector
- 描述
- 对一组资源进行标签查询，本例中为 pod。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.49. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.50. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].labelSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.51. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union，以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.52. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.53. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[].namespaceSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.54. .spec.proxy
- 描述
- 代理定义调用 master api、上游 registry 等时使用的代理。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 定义镜像 registry 在访问 HTTP 端点时使用的代理。 |
|
|
| HTTPS 定义镜像 registry 在访问 HTTPS 端点时使用的代理。 |
|
|
| noProxy 定义不应通过任何代理的主机名的逗号分隔列表。 |
7.1.55. .spec.requests
- 描述
- 请求控制给定 registry 实例在排队额外请求前可以处理多少个并行请求。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 读取定义镜像 registry 读取的限制。 |
|
|
| write 定义镜像 registry 的写入限制。 |
7.1.56. .spec.requests.read
- 描述
- 读取定义镜像 registry 读取的限制。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| maxInQueue 将的最大排队的 api 请求设置为 registry。 |
|
|
| maxRunning 将 flight api 请求的最大值设置为 registry。 |
|
|
| maxWaitInQueue 设置请求在被拒绝前可在队列中等待的最长时间。 |
7.1.57. .spec.requests.write
- 描述
- write 定义镜像 registry 的写入限制。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| maxInQueue 将的最大排队的 api 请求设置为 registry。 |
|
|
| maxRunning 将 flight api 请求的最大值设置为 registry。 |
|
|
| maxWaitInQueue 设置请求在被拒绝前可在队列中等待的最长时间。 |
7.1.58. .spec.resources
- 描述
- 资源定义 registry Pod 的资源请求+limits。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。此字段不可变。它只能为容器设置。 |
|
|
| ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。 |
|
|
| 限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
7.1.59. .spec.resources.claims
- 描述
- claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。此字段不可变。它只能为容器设置。
- 类型
-
数组
7.1.60. .spec.resources.claims[]
- 描述
- ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。 |
7.1.61. .spec.routes
- 描述
- 路由定义应该为 registry 创建的其他面向外部的路由。
- 类型
-
array
7.1.62. .spec.routes[]
- 描述
- ImageRegistryConfigRoute 包含有关对镜像 registry 的外部路由访问的信息。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 路由的主机名。 |
|
|
| 要创建的路由的名称。 |
|
|
| secretName 指向包含路由要使用的证书的 secret。 |
7.1.63. .spec.storage
- 描述
- 配置 registry 存储的存储详情，如 S3 存储桶协调。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Azure 代表使用 Azure Blob Storage 的配置。 |
|
|
| emptyDir 代表 pod 的主机节点上的临时存储。警告：此存储不能与超过 1 个副本一起使用，不适合生产用途。当因为某种原因从节点中删除 pod 时，emptyDir 中的数据会永久删除。 |
|
|
| GCS 代表使用 Google Cloud Storage 的配置。 |
|
|
| ibmcos 代表使用 IBM Cloud Object Storage 的配置。 |
|
|
| managementState 表示操作器是否管理底层存储单元。如果 Managed，Operator 会在此 Operator 被 Removed时删除存储。 |
|
|
| OSS 代表使用 Alibaba Cloud Object Storage Service 的配置。 |
|
|
| PVC 代表使用 PersistentVolumeClaim 的配置。 |
|
|
| s3 代表使用 Amazon Simple Storage Service 的配置。 |
|
|
| Swift 代表使用 OpenStack 对象存储的配置。 |
7.1.64. .spec.storage.azure
- 描述
- Azure 代表使用 Azure Blob Storage 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| accountName 定义 registry 使用的帐户。 |
|
|
| cloudName 是 registry 使用的 Azure 云环境的名称。如果为空，Operator 将基于 infrastructure 对象进行设置。 |
|
|
| 容器定义 registry 使用的 Azure 容器。 |
7.1.65. .spec.storage.emptyDir
- 描述
- emptyDir 代表 pod 的主机节点上的临时存储。警告：此存储不能与超过 1 个副本一起使用，不适合生产用途。当因为某种原因从节点中删除 pod 时，emptyDir 中的数据会永久删除。
- 类型
-
对象
7.1.66. .spec.storage.gcs
- 描述
- GCS 代表使用 Google Cloud Storage 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| bucket 是您要在其中存储 registry 数据的存储桶名称。可选，如果没有提供，则会生成。 |
|
|
| keyID 是用于加密的 KMS 密钥 ID。可选，在 GCP 上默认加密存储桶。这将允许使用一个自定义加密密钥。 |
|
|
| projectID 是此存储桶应与之关联的 GCP 项目的项目 ID。 |
|
|
| 存储桶所在的 GCS 位置。可选，将根据安装的 GCS 区域来设置。 |
7.1.67. .spec.storage.ibmcos
- 描述
- ibmcos 代表使用 IBM Cloud Object Storage 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| bucket 是您要在其中存储 registry 数据的存储桶名称。可选，如果没有提供，则会生成。 |
|
|
| 位置是存储桶所在的 IBM Cloud 位置。可选，将根据安装的 IBM Cloud 位置进行设置。 |
|
|
| resourceGroupName 是此存储桶及其服务实例关联的 IBM Cloud 资源组的名称。可选，将根据安装的 IBM Cloud 资源组设置。 |
|
|
| resourceKeyCRN 是为服务实例创建的 IBM Cloud 资源密钥的 CRN。通常被称为服务凭证，必须包含 HMAC 类型凭证。可选，如果没有提供，则会计算。 |
|
|
| serviceInstanceCRN 是此存储桶关联的 IBM Cloud Object Storage 服务实例的 CRN。可选，如果没有提供，则会计算。 |
7.1.68. .spec.storage.oss
- 描述
- OSS 代表使用 Alibaba Cloud Object Storage Service 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要在其中存储 registry 数据的存储桶名称。关于 Bucket 命名，您可以查看 [official 文档]（https://www.alibabacloud.com/help/doc-detail/257087.htmEmpty 值意味着没有建议，平台会选择默认值，这可能会随时间变化。目前，默认值将以 <clusterid>-image-registry-<region>-<random 字符串 27 chars> 的形式自动生成 |
|
|
| encryption 指定是否想在服务器端加密数据。如需了解更多详细信息，您可以查看 [official 文档](https://www.alibabacloud.com/help/doc-detail/117914.htm) |
|
|
|
EndpointAccessibility 指定 registry 是否使用 OSS VPC 内部端点 Empty 值，意味着没有建议，平台会选择默认值，可能会随时间变化。目前，默认为 |
|
|
| 区域是存在存储桶的 Alibaba Cloud 区域。如需区域列表，您可以查看[官方文档](https://www.alibabacloud.com/help/doc-detail/31837.html)。空值表示没有建议，平台会选择默认值，这可能会随时间变化。目前，默认值将基于安装的 Alibaba Cloud 区域。 |
7.1.69. .spec.storage.oss.encryption
- 描述
- encryption 指定是否想在服务器端加密数据。如需了解更多详细信息，您可以查看 [official 文档](https://www.alibabacloud.com/help/doc-detail/117914.htm)
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| KMS （密钥管理服务）是一个加密类型，其中包含 KMS KeyID 的结构 |
|
|
|
method 定义可用的 Empty 值的不同保护模式意味着没有建议，平台会选择默认值，这可能会随时间变化。目前，默认为 |
7.1.70. .spec.storage.oss.encryption.kms
- 描述
- KMS （密钥管理服务）是一个加密类型，其中包含 KMS KeyID 的结构
- 类型
-
object - 必填
-
keyID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| keyID 包含 KMS 加密密钥 ID |
7.1.71. .spec.storage.pvc
- 描述
- PVC 代表使用 PersistentVolumeClaim 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 声明定义要使用的永久卷声明的名称。 |
7.1.72. .spec.storage.s3
- 描述
- s3 代表使用 Amazon Simple Storage Service 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| bucket 是您要在其中存储 registry 数据的存储桶名称。可选，如果没有提供，则会生成。 |
|
|
| CloudFront 将 Amazon Cloudfront 配置为 registry 中的存储中间件。 |
|
|
| encrypt 指定 registry 是否以加密格式存储镜像。可选，默认为 false。 |
|
|
| keyID 是用于加密的 KMS 密钥 ID。可选，Encrypt 必须为 true，否则此参数将被忽略。 |
|
|
| 存储桶所在的 AWS 区域。可选，将根据安装的 AWS 区域来设置。 |
|
|
| regionendpoint 是 S3 兼容存储服务的端点。它应该是带有 方案 的有效 URL，例如 https://s3.example.com。可选，基于提供的 Region。 |
|
|
| trustedCA 是包含 CA 捆绑包的配置映射的引用。镜像 registry 及其 Operator 使用此捆绑包中的证书来验证 S3 服务器证书。被 trustedCA 引用的配置映射的命名空间为 "openshift-config"。配置映射中捆绑包的密钥为 "ca-bundle.crt"。 |
|
|
| virtualHostedStyle 启用 S3 虚拟主机风格存储桶路径以及自定义 RegionEndpoint 可选，默认为 false。 |
7.1.73. .spec.storage.s3.cloudFront
- 描述
- CloudFront 将 Amazon Cloudfront 配置为 registry 中的存储中间件。
- 类型
-
object - 必填
-
baseURL -
keypairID -
privateKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| baseurl 包含 SCHEME://HOST[/PATH]，在其中提供 Cloudfront。 |
|
|
| duration 是 Cloudfront 会话的持续时间。 |
|
|
| keypairID 是 AWS 提供的密钥对 ID。 |
|
|
| Privatekey 指向包含 AWS 提供的私钥的 secret。 |
7.1.74. .spec.storage.s3.cloudFront.privateKey
- 描述
- Privatekey 指向包含 AWS 提供的私钥的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？ |
|
|
| 指定是否需要定义 Secret 还是其密钥 |
7.1.75. .spec.storage.s3.trustedCA
- 描述
- trustedCA 是包含 CA 捆绑包的配置映射的引用。镜像 registry 及其 Operator 使用此捆绑包中的证书来验证 S3 服务器证书。被 trustedCA 引用的配置映射的命名空间为 "openshift-config"。配置映射中捆绑包的密钥为 "ca-bundle.crt"。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| name 是引用的配置映射的 metadata.name。此字段必须遵循标准配置映射命名限制。名称只能包含字母数字字符、连字符(-)和句点(.)。它的最大长度为 253 个字符。如果没有指定此字段或为空字符串，则会使用默认信任捆绑包。 |
7.1.76. .spec.storage.swift
- 描述
- Swift 代表使用 OpenStack 对象存储的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| authURL 定义用于获取身份验证令牌的 URL。 |
|
|
| authVersion 指定 OpenStack Auth 的版本。 |
|
|
| 容器定义用于存储 registry 数据的 Swift 容器的名称。 |
|
|
| domain 指定 Identity v3 API 的 Openstack 的域名。 |
|
|
| domainID 为 Identity v3 API 指定 Openstack 的 domain id。 |
|
|
| regionName 定义容器所在的 Openstack 区域。 |
|
|
| 租户定义 registry 使用的 Openstack 租户名称。 |
|
|
| 租户定义 registry 使用的 Openstack 租户 id。 |
7.1.77. .spec.tolerations
- 描述
- 容限(toleration)定义了 registry pod 的容限。
- 类型
-
array
7.1.78. .spec.tolerations[]
- 描述
- 此 Toleration 附加到 pod，以使用匹配的 operator <operator> 容许与 triple <key,value,effect> 匹配的任何污点。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| effect 表示要匹配的污点效果。空意味着匹配所有污点效果。指定后，允许的值为 NoSchedule，PreferNoSchedule 和 NoExecute。 |
|
|
| key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空，则必须存在运算符；组合意味着匹配所有值和所有键。 |
|
|
| Operator 代表键与值的关系。有效的运算符是 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符，以便 pod 可以容忍特定类别的所有污点。 |
|
|
| tolerationSeconds 代表容限的期间（必须生效 NoExecute，否则此字段将被忽略）可以容忍污点。默认情况下，它不会被设置，这意味着容许任何污点（不要驱除）。零值和负值将被视为 0 （立即删除）。 |
|
|
| value 是容限匹配的污点值。如果运算符是 Exists，则该值应该为空，否则仅是一个常规字符串。 |
7.1.79. .spec.topologySpreadConstraints
- 描述
- topologySpreadConstraints 指定如何在给定的拓扑中分布匹配的 pod。
- 类型
-
array
7.1.80. .spec.topologySpreadConstraints[]
- 描述
- TopologySpreadConstraint 指定如何在给定的拓扑中分布匹配的 pod。
- 类型
-
object - 必填
-
maxSkew -
topologyKey -
whenUnsatisfiable
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| labelSelector 用于查找匹配的 pod。与此标签选择器匹配的 Pod 被计算，以确定其对应拓扑域中的 pod 数量。 |
|
|
| matchLabelKeys 是一组 pod 标签键，用于选择要在其中计算分布的 pod。这些键用于从传入的 pod 标签中查找值，这些键值标签由 labelSelector 匹配，以选择现有 pod 的组，用于为传入的 pod 计算。匹配键被禁止在 MatchLabelKeys 和 LabelSelector 中。当 LabelSelector 没有设置时，无法设置 matchLabelKeys。传入的 pod 标签中不存在的键将被忽略。null 或空列表表示仅与 labelSelector 匹配。这是一个 beta 字段，需要启用 MatchLabelKeysInPodTopologySpread 功能门（默认启用）。 |
|
|
|
maxSkew 描述了 pod 可能没有被均匀分布的程度。当 |
|
|
| MinDomains 表示合格的域数量。当具有匹配拓扑键的合格域数量小于 minDomains 时，Pod Topology Spread 会将"global minimum"视为 0，然后执行 Skew 的计算。当匹配拓扑键等于或大于 minDomains 的合格域数量时，这个值不会影响调度。因此，当有资格的域数量小于 minDomains 时，调度程序不会将超过 maxSkew Pod 的调度到这些域。如果值为 nil，则约束的行为就像 MinDomains 等于 1 一样。有效值为大于 0 的整数。如果值不是 nil，WhenUnsatisfiable 必须是 DoNotSchedule。例如，在一个 3 个区集群中，MaxSkew 设置为 2，MinDomains 被设置为 5，且带有与 2/2/2: | zone1 | zone2 | zone2 | zone2 | zone3 | P P | P | P P | P P | P P | P P | 数量的域的数量小于 5 (MinDomains)，因此"global minimum"被视为 0。在这种情况下，如果新 Pod 调度到任何三个区域，则无法调度具有相同 labelSelector 的新 pod，因为 computed skew 将为 3 (3 - 0)，它将违反 MaxSkew。这是一个 beta 字段，需要启用 MinDomainsInPodTopologySpread 功能门（默认启用）。 |
|
|
| NodeAffinityPolicy 表示在计算 pod 拓扑分布偏移时，我们将如何处理 Pod 的 nodeAffinity/nodeSelector。选项为：- Honor：只有与 nodeAffinity/nodeSelector 匹配的节点才会包含在计算中。- Ignore: nodeAffinity/nodeSelector 会被忽略。所有节点都包含在计算中。如果这个值是 nil，则行为等同于 Honor 策略。这是 NodeInclusionPolicyInPodTopologySpread 功能默认启用的 beta 级别功能。 |
|
|
| NodeTaintsPolicy 指示在计算 pod 拓扑分布偏移时如何对待节点污点。选项为：- Honor: 没有污点的节点，以及传入的 pod 具有容限的污点节点。- Ignore: node taint are ignored.所有节点都包括在内。如果这个值是 nil，则行为等同于 Ignore 策略。这是 NodeInclusionPolicyInPodTopologySpread 功能默认启用的 beta 级别功能。 |
|
|
| topologyKey 是节点标签的密钥。带有具有此键和相同值标签的节点被视为在同一拓扑中。我们把每个 <key, value> 视为 "bucket"，并尝试将均衡的 pod 数量放在每个存储桶中。我们将域定义为拓扑的特定实例。另外，我们将一个有资格的域定义为节点满足 nodeAffinityPolicy 和 nodeTaintsPolicy 的要求的域。例如，如果 TopologyKey 为 "kubernetes.io/hostname"，则每个节点都是该拓扑的域。如果 TopologyKey 是 "topology.kubernetes.io/zone"，每个区都是该拓扑的域。这是必填字段。 |
|
|
| whenUnsatisfiable 表示如何在不满足分散约束的情况下处理 pod。- DoNotSchedule (default)告知调度程序不调度它。- ScheduleAnyway 告知调度程序将 pod 调度到任何位置，但为拓扑赋予更高优先级，有助于减少偏差。如果每个可能的节点分配都会在某些拓扑上违反"MaxSkew"，则约束被视为"不satisfiable"。例如，在一个 3 区集群中，MaxSkew 设置为 1，而具有与 3/1/1: | zone1 | zone2 | zone2 | zone3 | P P | P | P | P | P | P | P | P | P | WhenUnsatisfiable 设置为 DoNotSchedule 的 pod 只能调度到 zone2 (zone3)要成为 3/2/1 (3/1/2)，在 zone2 (zone3)中以 ActualSkew (2-1)满足 MaxSkew (1)。换句话说，集群仍然可以实现平衡，但调度程序不会使其更不平衡。这是必填字段。 |
7.1.81. .spec.topologySpreadConstraints[].labelSelector
- 描述
- labelSelector 用于查找匹配的 pod。与此标签选择器匹配的 Pod 被计算，以确定其对应拓扑域中的 pod 数量。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。 |
7.1.82. .spec.topologySpreadConstraints[].labelSelector.matchExpressions
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
7.1.83. .spec.topologySpreadConstraints[].labelSelector.matchExpressions[]
- 描述
- 标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
7.1.84. .status
- 描述
- ImageRegistryStatus 报告镜像 registry 操作状态。
- 类型
-
object - 必填
-
storage -
storageManaged
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| conditions 是条件及其状态列表 |
|
|
| OperatorCondition 只是标准条件字段。 |
|
|
| 生成用于确定项目是否需要协调或更改是否需要反应。 |
|
|
| GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。 |
|
|
| observedGeneration 是您处理的最后生成更改 |
|
|
| readyReplicas 表示有多少副本就绪并处于所需的状态 |
|
|
| 存储指示 registry 的当前应用存储配置。 |
|
|
| StorageManaged 已被弃用，请参阅 Storage.managementState |
|
|
| 版本是此可用性适用的级别 |
7.1.85. .status.conditions
- 描述
- conditions 是条件及其状态列表
- 类型
-
array
7.1.86. .status.conditions[]
- 描述
- OperatorCondition 只是标准条件字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
7.1.87. .status.generations
- 描述
- 生成用于确定项目是否需要协调或更改是否需要反应。
- 类型
-
array
7.1.88. .status.generations[]
- 描述
- GenerationStatus 追踪给定资源的生成，以便可以对强制更新的决策进行。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 组是您要跟踪的内容组 |
|
|
| hash 是为没有生成的情况下为资源设置的可选字段，它们是敏感内容，如 secret 和 configmaps |
|
|
| lastGeneration 是涉及的工作负载控制器的最后生成 |
|
|
| name 是您要跟踪的内容的名称 |
|
|
| 命名空间(namespace)是您要跟踪的事情 |
|
|
| 资源是您要跟踪的资源类型 |
7.1.89. .status.storage
- 描述
- 存储指示 registry 的当前应用存储配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Azure 代表使用 Azure Blob Storage 的配置。 |
|
|
| emptyDir 代表 pod 的主机节点上的临时存储。警告：此存储不能与超过 1 个副本一起使用，不适合生产用途。当因为某种原因从节点中删除 pod 时，emptyDir 中的数据会永久删除。 |
|
|
| GCS 代表使用 Google Cloud Storage 的配置。 |
|
|
| ibmcos 代表使用 IBM Cloud Object Storage 的配置。 |
|
|
| managementState 表示操作器是否管理底层存储单元。如果 Managed，Operator 会在此 Operator 被 Removed时删除存储。 |
|
|
| OSS 代表使用 Alibaba Cloud Object Storage Service 的配置。 |
|
|
| PVC 代表使用 PersistentVolumeClaim 的配置。 |
|
|
| s3 代表使用 Amazon Simple Storage Service 的配置。 |
|
|
| Swift 代表使用 OpenStack 对象存储的配置。 |
7.1.90. .status.storage.azure
- 描述
- Azure 代表使用 Azure Blob Storage 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| accountName 定义 registry 使用的帐户。 |
|
|
| cloudName 是 registry 使用的 Azure 云环境的名称。如果为空，Operator 将基于 infrastructure 对象进行设置。 |
|
|
| 容器定义 registry 使用的 Azure 容器。 |
7.1.91. .status.storage.emptyDir
- 描述
- emptyDir 代表 pod 的主机节点上的临时存储。警告：此存储不能与超过 1 个副本一起使用，不适合生产用途。当因为某种原因从节点中删除 pod 时，emptyDir 中的数据会永久删除。
- 类型
-
对象
7.1.92. .status.storage.gcs
- 描述
- GCS 代表使用 Google Cloud Storage 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| bucket 是您要在其中存储 registry 数据的存储桶名称。可选，如果没有提供，则会生成。 |
|
|
| keyID 是用于加密的 KMS 密钥 ID。可选，在 GCP 上默认加密存储桶。这将允许使用一个自定义加密密钥。 |
|
|
| projectID 是此存储桶应与之关联的 GCP 项目的项目 ID。 |
|
|
| 存储桶所在的 GCS 位置。可选，将根据安装的 GCS 区域来设置。 |
7.1.93. .status.storage.ibmcos
- 描述
- ibmcos 代表使用 IBM Cloud Object Storage 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| bucket 是您要在其中存储 registry 数据的存储桶名称。可选，如果没有提供，则会生成。 |
|
|
| 位置是存储桶所在的 IBM Cloud 位置。可选，将根据安装的 IBM Cloud 位置进行设置。 |
|
|
| resourceGroupName 是此存储桶及其服务实例关联的 IBM Cloud 资源组的名称。可选，将根据安装的 IBM Cloud 资源组设置。 |
|
|
| resourceKeyCRN 是为服务实例创建的 IBM Cloud 资源密钥的 CRN。通常被称为服务凭证，必须包含 HMAC 类型凭证。可选，如果没有提供，则会计算。 |
|
|
| serviceInstanceCRN 是此存储桶关联的 IBM Cloud Object Storage 服务实例的 CRN。可选，如果没有提供，则会计算。 |
7.1.94. .status.storage.oss
- 描述
- OSS 代表使用 Alibaba Cloud Object Storage Service 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要在其中存储 registry 数据的存储桶名称。关于 Bucket 命名，您可以查看 [official 文档]（https://www.alibabacloud.com/help/doc-detail/257087.htmEmpty 值意味着没有建议，平台会选择默认值，这可能会随时间变化。目前，默认值将以 <clusterid>-image-registry-<region>-<random 字符串 27 chars> 的形式自动生成 |
|
|
| encryption 指定是否想在服务器端加密数据。如需了解更多详细信息，您可以查看 [official 文档](https://www.alibabacloud.com/help/doc-detail/117914.htm) |
|
|
|
EndpointAccessibility 指定 registry 是否使用 OSS VPC 内部端点 Empty 值，意味着没有建议，平台会选择默认值，可能会随时间变化。目前，默认为 |
|
|
| 区域是存在存储桶的 Alibaba Cloud 区域。如需区域列表，您可以查看[官方文档](https://www.alibabacloud.com/help/doc-detail/31837.html)。空值表示没有建议，平台会选择默认值，这可能会随时间变化。目前，默认值将基于安装的 Alibaba Cloud 区域。 |
7.1.95. .status.storage.oss.encryption
- 描述
- encryption 指定是否想在服务器端加密数据。如需了解更多详细信息，您可以查看 [official 文档](https://www.alibabacloud.com/help/doc-detail/117914.htm)
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| KMS （密钥管理服务）是一个加密类型，其中包含 KMS KeyID 的结构 |
|
|
|
method 定义可用的 Empty 值的不同保护模式意味着没有建议，平台会选择默认值，这可能会随时间变化。目前，默认为 |
7.1.96. .status.storage.oss.encryption.kms
- 描述
- KMS （密钥管理服务）是一个加密类型，其中包含 KMS KeyID 的结构
- 类型
-
object - 必填
-
keyID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| keyID 包含 KMS 加密密钥 ID |
7.1.97. .status.storage.pvc
- 描述
- PVC 代表使用 PersistentVolumeClaim 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 声明定义要使用的永久卷声明的名称。 |
7.1.98. .status.storage.s3
- 描述
- s3 代表使用 Amazon Simple Storage Service 的配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| bucket 是您要在其中存储 registry 数据的存储桶名称。可选，如果没有提供，则会生成。 |
|
|
| CloudFront 将 Amazon Cloudfront 配置为 registry 中的存储中间件。 |
|
|
| encrypt 指定 registry 是否以加密格式存储镜像。可选，默认为 false。 |
|
|
| keyID 是用于加密的 KMS 密钥 ID。可选，Encrypt 必须为 true，否则此参数将被忽略。 |
|
|
| 存储桶所在的 AWS 区域。可选，将根据安装的 AWS 区域来设置。 |
|
|
| regionendpoint 是 S3 兼容存储服务的端点。它应该是带有 方案 的有效 URL，例如 https://s3.example.com。可选，基于提供的 Region。 |
|
|
| trustedCA 是包含 CA 捆绑包的配置映射的引用。镜像 registry 及其 Operator 使用此捆绑包中的证书来验证 S3 服务器证书。被 trustedCA 引用的配置映射的命名空间为 "openshift-config"。配置映射中捆绑包的密钥为 "ca-bundle.crt"。 |
|
|
| virtualHostedStyle 启用 S3 虚拟主机风格存储桶路径以及自定义 RegionEndpoint 可选，默认为 false。 |
7.1.99. .status.storage.s3.cloudFront
- 描述
- CloudFront 将 Amazon Cloudfront 配置为 registry 中的存储中间件。
- 类型
-
object - 必填
-
baseURL -
keypairID -
privateKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| baseurl 包含 SCHEME://HOST[/PATH]，在其中提供 Cloudfront。 |
|
|
| duration 是 Cloudfront 会话的持续时间。 |
|
|
| keypairID 是 AWS 提供的密钥对 ID。 |
|
|
| Privatekey 指向包含 AWS 提供的私钥的 secret。 |
7.1.100. .status.storage.s3.cloudFront.privateKey
- 描述
- Privatekey 指向包含 AWS 提供的私钥的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
|
|
|
|
|
|
7.1.101.
|
|
|
|
7.1.102.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7.2.
7.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 8 章
8.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8.1.3.
8.1.4.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8.2.
8.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 9 章
9.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.1.3.
9.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
9.1.5.
9.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.2.
9.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 10 章
10.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.1.2.
|
|
|
|
|
|
|
|
10.1.3.
|
|
|
|
|
|
|
|
|
|
|
|
10.1.4.
10.1.5.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.1.6.
10.1.7.
|
|
|
|
|
|
|
|
|
|
|
|
10.1.8.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.1.9.
|
|
|
|
|
|
|
|
10.1.10.
|
|
|
|
|
|
|
|
10.1.11.
|
|
|
|
10.1.12.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.1.13.
|
|
|
|
|
|
|
|
10.1.14.
|
|
|
|
|
|
|
|
10.1.15.
|
|
|
|
10.1.16.
10.1.17.
|
|
|
|
|
|
|
|
|
|
|
|
10.1.18.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.1.19.
10.1.20.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
10.2.
10.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 11 章
11.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
11.1.3.
11.1.4.
|
|
|
|
|
|
|
|
|
|
|
|
11.1.5.
11.1.6.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
11.1.7.
|
|
|
|
|
|
|
|
11.2.
11.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11.2.4.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 12 章
12.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
|
|
12.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.1.3.
12.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
12.1.5.
12.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.1.7.
12.1.8.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.2.
12.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 13 章
13.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
13.1.1.
|
|
|
|
|
|
|
|
13.1.2.
13.1.3.
|
|
|
|
|
|
|
|
13.2.
13.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
13.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
13.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 14 章
14.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.3.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.4.
14.1.5.
|
|
|
|
|
|
|
|
14.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.7.
14.1.8.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.9.
14.1.10.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.11.
|
|
|
|
|
|
|
|
14.1.12.
14.1.13.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.14.
14.1.15.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.16.
14.1.17.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.18.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.19.
14.1.20.
|
|
|
|
|
|
|
|
14.1.21.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.22.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.23.
14.1.24.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.25.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.26.
14.1.27.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.28.
14.1.29.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.30.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.31.
14.1.32.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.33.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.34.
14.1.35.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.36.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.37.
14.1.38.
|
|
|
|
|
|
|
|
14.1.39.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.40.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.41.
14.1.42.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.43.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.44.
14.1.45.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.46.
14.1.47.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.48.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.49.
14.1.50.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.51.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.52.
14.1.53.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.54.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.55.
14.1.56.
|
|
|
|
14.1.57.
14.1.58.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.1.59.
|
|
|
|
|
|
|
|
|
|
|
|
14.1.60.
14.1.61.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
14.2.
14.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 15 章
15.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.3.
|
|
|
|
15.1.4.
|
|
|
|
15.1.5.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.7.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.8.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.9.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.10.
|
|
|
|
15.1.11.
15.1.12.
|
|
|
|
15.1.13.
|
|
|
|
15.1.14.
|
|
|
|
15.1.15.
|
|
|
|
15.1.16.
|
|
|
|
15.1.17.
|
|
|
|
15.1.18.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.19.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.20.
15.1.21.
|
|
|
|
|
|
|
|
15.1.22.
|
|
|
|
|
|
|
|
15.1.23.
|
|
|
|
15.1.24.
15.1.25.
|
|
|
|
|
|
|
|
15.1.26.
|
|
|
|
|
|
|
|
15.1.27.
|
|
|
|
15.1.28.
|
|
|
|
|
|
|
|
15.1.29.
|
|
|
|
15.1.30.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.31.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.32.
|
|
|
|
15.1.33.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.34.
|
|
|
|
|
|
|
|
15.1.35.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.36.
15.1.37.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.38.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.39.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.40.
15.1.41.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.42.
15.1.43.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.44.
|
|
|
|
|
|
|
|
15.1.45.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.46.
15.1.47.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.48.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.49.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.50.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.51.
15.1.52.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
15.1.53.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.54.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.55.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.56.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.1.57.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.58.
|
|
|
|
15.1.59.
15.1.60.
|
|
|
|
15.1.61.
|
|
|
|
15.1.62.
|
|
|
|
15.1.63.
|
|
|
|
15.1.64.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.65.
15.1.66.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.67.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.68.
15.1.69.
|
|
|
|
|
|
|
|
|
|
|
|
15.1.70.
|
|
|
|
|
|
|
|
15.2.
15.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.2.4.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15.2.5.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 16 章
16.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.1.3.
16.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
16.1.5.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.1.6.
16.1.7.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.1.8.
16.1.9.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.1.10.
16.1.11.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.1.12.
|
|
|
|
|
|
|
|
|
|
|
|
16.1.13.
16.1.14.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.2.
16.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.2.4.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 17 章
17.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
17.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
17.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
|
|
|
17.1.3.
17.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
17.1.5.
17.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
17.1.7.
17.1.8.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
17.1.9.
17.1.10.
|
|
|
|
|
|
|
|
17.2.
17.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
17.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
17.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 18 章
18.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
18.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
18.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
18.1.3.
18.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
18.1.5.
18.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
18.1.7.
18.1.8.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
18.2.
18.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
18.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
18.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 19 章
19.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
19.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
19.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
19.1.3.
19.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
19.1.5.
19.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
19.1.7.
19.1.8.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
19.2.
19.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
19.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
19.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 20 章
20.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
|
|
20.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
20.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
20.1.3.
20.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
20.1.5.
20.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
20.2.
20.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
20.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
20.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 21 章
21.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.2.
21.1.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.4.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.5.
|
|
|
|
|
|
|
|
21.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.7.
21.1.8.
|
|
|
|
|
|
|
|
21.1.9.
|
|
|
|
|
|
|
|
|
|
|
|
21.1.10.
21.1.11.
|
|
|
|
|
|
|
|
21.1.12.
21.1.13.
|
|
| |
|
|
|
21.1.14.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.15.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.16.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.17.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.18.
|
|
|
|
21.1.19.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.20.
|
|
|
|
21.1.21.
|
|
|
|
21.1.22.
|
|
|
|
|
|
|
|
|
|
|
|
21.1.23.
21.1.24.
|
|
| |
|
|
|
21.1.25.
21.1.26.
|
|
|
|
|
|
|
|
21.1.27.
|
|
|
|
|
|
|
|
21.1.28.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.29.
|
|
|
|
|
|
|
|
|
|
|
|
21.1.30.
|
|
|
|
21.1.31.
|
|
|
|
21.1.32.
|
|
|
|
21.1.33.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.34.
21.1.35.
|
|
|
|
|
|
|
|
|
|
|
|
21.1.36.
|
|
|
|
|
|
|
|
|
|
|
|
21.1.37.
|
|
|
|
|
|
|
|
21.1.38.
|
|
|
|
|
|
|
|
21.1.39.
|
|
|
|
|
|
|
|
21.1.40.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.1.41.
21.1.42.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
21.1.43.
21.1.44.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.2.
21.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 22 章
22.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
22.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
22.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
22.1.3.
22.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
22.1.5.
22.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
22.2.
22.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
22.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
22.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 23 章
23.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
|
|
23.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
23.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
23.1.3.
23.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
23.1.5.
23.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
23.2.
23.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
23.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
23.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 24 章
More specifically, given an OperatorPKI with <name>, the CNO will manage:
24.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
24.1.1.
|
|
|
|
24.1.2.
|
|
|
|
24.1.3.
24.2.
24.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
24.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
24.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 25 章
25.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
25.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
25.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
25.1.3.
25.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
25.1.5.
25.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
25.2.
25.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
25.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
25.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
第 26 章
26.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
26.1.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
26.1.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
26.1.3.
26.1.4.
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
26.1.5.
26.1.6.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
26.2.
26.2.1.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
26.2.2.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
26.2.3.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Legal Notice
Copyright © 2024 Red Hat, Inc.
OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
Modified versions must remove all Red Hat trademarks.
Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
