你正在查看的文档所针对的是 Kubernetes 版本: v1.25
Kubernetes v1.25 版本的文档已不再维护。你现在看到的版本来自于一份静态的快照。如需查阅最新文档,请点击 最新版本。
ClusterCIDR v1alpha1
apiVersion: networking.k8s.io/v1alpha1
import "k8s.io/api/networking/v1alpha1"
ClusterCIDR
ClusterCIDR 表示启用 MultiCIDRRangeAllocator 时针对每个节点 Pod CIDR 分配进行的单个配置 (参阅针对 kube-controller-manager 的配置)。 一个集群可能有任意数量的 ClusterCIDR 资源,在为节点分配 CIDR 时将考虑所有这些资源。 当节点选择算符与相关节点匹配并且有空闲 CIDR 可供分配时,ClusterCIDR 才能有资格用于给定的节点。 在存在多个匹配的 ClusterCIDR 资源的情况下,分配器将尝试使用内部启发式算法来解决这一问题, 但可以使用节点选择算符与该节点匹配的任何 ClusterCIDR。
apiVersion: networking.k8s.io/v1alpha1
kind: ClusterCIDR
metadata (ObjectMeta)
标准的对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (ClusterCIDRSpec)
spec 是 ClusterCIDR 的预期状态。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
ClusterCIDRSpec
ClusterCIDRSpec 定义 ClusterCIDR 的预期状态。
perNodeHostBits (int32),必需
perNodeHostBits 定义每个节点要配置的主机位数。 子网掩码决定有多少地址用于网络位和主机位。 例如 IPv4 地址 192.168.0.0/24 将该地址拆分为 24 位用于网络部分和 8 位用于主机部分。 要分配 256 个 IP,需将此字段设置为 8(针对 IPv4 的掩码为 /24,针对 IPv6 的掩码为 /120)。 最小值为 4(16 个 IP)。此字段是不可变的。
ipv4 (string)
ipv4 以 CIDR 表示法定义 IPv4 IP 块(例如 “10.0.0.0/8”)。 必须至少指定 ipv4 和 ipv6 之一。该字段是不可变的。
ipv6 (string)
ipv6 以 CIDR 表示法定义 IPv6 IP 块(例如 “fd12:3456:789a:1::/64”)。 必须至少指定 ipv4 和 ipv6 之一。 该字段是不可变的。
nodeSelector (NodeSelector)
nodeSelector 定义该配置适用于哪些节点。 空白或值为 nil 的 nodeSelector 选择所有节点。该字段是不可变的。
节点选择算符表示在一组节点上一个或多个标签查询结果的并集; 也就是说,它表示由节点选择算符条件表示的选择算符的逻辑或计算结果。
nodeSelector.nodeSelectorTerms ([]NodeSelectorTerm),必需
必需。节点选择算符条件的列表。这些条件以逻辑与进行计算。
一个 null 或空的节点选择算符条件不会与任何对象匹配。这些要求会按逻辑与的关系来计算。 TopologySelectorTerm 类别实现了 NodeSelectorTerm 的子集。
nodeSelector.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)
基于节点标签所设置的节点选择算符要求的列表。
nodeSelector.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)
基于节点字段所设置的节点选择算符要求的列表。
ClusterCIDRList
ClusterCIDRList 包含 ClusterCIDR 的列表。
apiVersion: networking.k8s.io/v1alpha1
kind: ClusterCIDRList
metadata (ListMeta)
标准的对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]ClusterCIDR),必需
items 是 ClusterCIDRs 的列表。
操作
get
读取指定的 ClusterCIDR
HTTP 请求
GET /apis/networking.k8s.io/v1alpha1/clustercidrs/{name}
参数
name (路径参数):string,必需
ClusterCIDR 的名称
pretty (查询参数):string
响应
200 (ClusterCIDR): OK
401: Unauthorized
list
列出或监视 ClusterCIDR 类别的对象
HTTP 请求
GET /apis/networking.k8s.io/v1alpha1/clustercidrs
参数
allowWatchBookmarks (查询参数):boolean
continue (查询参数):string
fieldSelector (查询参数):string
labelSelector (查询参数):string
limit (查询参数):integer
pretty (查询参数):string
resourceVersion (查询参数):string
resourceVersionMatch (查询参数):string
timeoutSeconds (查询参数):integer
watch (查询参数):boolean
响应
200 (ClusterCIDRList): OK
401: Unauthorized
create
创建 ClusterCIDR
HTTP 请求
POST /apis/networking.k8s.io/v1alpha1/clustercidrs
参数
body: ClusterCIDR,必需
dryRun (查询参数):string
fieldManager (查询参数):string
fieldValidation (查询参数):string
pretty (查询参数):string
响应
200 (ClusterCIDR): OK
201 (ClusterCIDR): Created
202 (ClusterCIDR): Accepted
401: Unauthorized
update
替换指定的 ClusterCIDR
HTTP 请求
PUT /apis/networking.k8s.io/v1alpha1/clustercidrs/{name}
参数
name (路径参数):string,必需
ClusterCIDR 的名称
body: ClusterCIDR,必需
dryRun (查询参数):string
fieldManager (查询参数):string
fieldValidation (查询参数):string
pretty (查询参数):string
响应
200 (ClusterCIDR): OK
201 (ClusterCIDR): Created
401: Unauthorized
patch
部分更新指定的 ClusterCIDR
HTTP 请求
PATCH /apis/networking.k8s.io/v1alpha1/clustercidrs/{name}
参数
name (路径参数):string,必需
ClusterCIDR 的名称
body: Patch,必需
dryRun (查询参数):string
fieldManager (查询参数):string
fieldValidation (查询参数):string
force (查询参数):boolean
pretty (查询参数):string
响应
200 (ClusterCIDR): OK
201 (ClusterCIDR): Created
401: Unauthorized
delete
删除 ClusterCIDR
HTTP 请求
DELETE /apis/networking.k8s.io/v1alpha1/clustercidrs/{name}
参数
name (路径参数):string,必需
ClusterCIDR 的名称
body: DeleteOptions
dryRun (查询参数):string
gracePeriodSeconds (查询参数):integer
pretty (查询参数):string
propagationPolicy (查询参数):string
响应
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
删除 ClusterCIDR 的集合
HTTP 请求
DELETE /apis/networking.k8s.io/v1alpha1/clustercidrs
参数
body: DeleteOptions
continue (查询参数):string
dryRun (查询参数):string
fieldSelector (查询参数):string
gracePeriodSeconds (查询参数):integer
labelSelector (查询参数):string
limit (查询参数):integer
pretty (查询参数):string
propagationPolicy (查询参数):string
resourceVersion (查询参数):string
resourceVersionMatch (查询参数):string
timeoutSeconds (查询参数):integer
响应
200 (Status): OK
401: Unauthorized