第 17 章 Network [config.openshift.io/v1]

描述

网络包含有关网络的集群范围信息。规范名称 为集群。它用于配置所需的网络配置，例如：用于服务/pod IP、网络插件等的 IP 地址池。有关配置此资源时的信息，请查看 network.spec。兼容性级别 1：在主发行版本中至少提供 12 个月或 3 个次版本（以更长的时间为准）。

类型

object

必填

spec

17.1. 规格

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`	标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`对象`	spec 包含用于配置的用户可设置值。作为一般规则，不会直接读取此 SHOULD。相反，您应该使用 NetworkStatus，因为它表示当前部署的配置。目前，大多数 spec 字段在安装后都是不可变的。请查看各个类别以了解每个人的更多详情。
`status`	`对象`	status 包含从集群中观察到的值。它们可能无法被覆盖。

17.1.1. .spec

描述: spec 包含用于配置的用户可设置值。作为一般规则，不会直接读取此 SHOULD。相反，您应该使用 NetworkStatus，因为它表示当前部署的配置。目前，大多数 spec 字段在安装后都是不可变的。请查看各个类别以了解每个人的更多详情。
类型: object

属性	类型	描述
`clusterNetwork`	`array`	用于 pod IP 的 IP 地址池。在安装后，此字段是不可变的。
`clusterNetwork[]`	`对象`	ClusterNetworkEntry 是从中分配 pod IP 地址的连续块。
`externalIP`	`对象`	ExternalIP 为影响 Service.ExternalIP 的控制器定义配置。如果为 nil，则不允许设置 ExternalIP。
`networkType`	`字符串`	networkType 是要部署的插件（如 OpenShiftSDN）。这应该与 cluster-network-operator 理解的值匹配，否则不会安装任何网络。目前支持的值有： - OpenShiftSDN this field after installation.
`serviceNetwork`	`数组（字符串）`	服务的 IP 地址池.目前，我们只支持一个条目。在安装后，此字段是不可变的。
`serviceNodePortRange`	`字符串`	端口范围允许用于 NodePort 类型的服务。如果没有指定，则使用默认值 30000-32767。未指定 NodePort 的此类服务将从此范围内自动分配。可在安装集群后更新此参数。

17.1.2. .spec.clusterNetwork

描述: 用于 pod IP 的 IP 地址池。在安装后，此字段是不可变的。
类型: array

17.1.3. .spec.clusterNetwork[]

描述: ClusterNetworkEntry 是从中分配 pod IP 地址的连续块。
类型: object

属性	类型	描述
`cidr`	`字符串`	pod IP 的完整块。
`hostPrefix`	`整数`	分配给每个节点的块的大小（前缀）。如果插件没有使用此字段，则可以取消设置它。

17.1.4. .spec.externalIP

描述: ExternalIP 为影响 Service.ExternalIP 的控制器定义配置。如果为 nil，则不允许设置 ExternalIP。
类型: object

属性	类型	描述
`autoAssignCIDRs`	`数组（字符串）`	autoAssignCIDRs 是自动分配 Service.ExternalIP 的 CIDR 列表。当服务是 LoadBalancer 类型时，会分配它们。通常，这仅适用于裸机集群。在 Openshift 3.x 中，这被误认为是"IngressIPs"。自动分配外部 IP 不会受到任何 ExternalIPPolicy 规则的影响。目前，只能提供一个条目。
`policy`	`对象`	policy 是应用于 ExternalIP 字段的一组限制。如果为 nil 或空，则不允许设置 ExternalIP。

17.1.5. .spec.externalIP.policy

描述: policy 是应用于 ExternalIP 字段的一组限制。如果为 nil 或空，则不允许设置 ExternalIP。
类型: object

属性	类型	描述
`allowedCIDRs`	`数组（字符串）`	allowedCIDRs 是允许的 CIDR 列表。
`rejectedCIDRs`	`数组（字符串）`	rejectedCIDRs 是禁止的 CIDR 列表。它们优先于 allowedCIDRs。

17.1.6. .status

描述: status 包含从集群中观察到的值。它们可能无法被覆盖。
类型: object

属性	类型	描述
`clusterNetwork`	`array`	用于 pod IP 的 IP 地址池。
`clusterNetwork[]`	`对象`	ClusterNetworkEntry 是从中分配 pod IP 地址的连续块。
`clusterNetworkMTU`	`整数`	clusterNetworkMTU 是 pod 网络间的 MTU。
`conditions`	`数组`	条件代表 network.config 当前状态的观察。已知的 .status.conditions.type are: "NetworkTypeMigrationInProgress", "NetworkTypeMigrationMTUReady", "NetworkTypeMigrationTargetCNIAvailable", "NetworkTypeMigrationTargetCNIInUse" 和 "NetworkTypeMigrationOriginalCNIPurged"
`conditions[]`	`对象`	条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如，输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"` // other fields }
`迁移`	`对象`	迁移包含集群网络迁移配置。
`networkType`	`字符串`	networkType 是部署的插件（如 OpenShiftSDN）。
`serviceNetwork`	`数组（字符串）`	服务的 IP 地址池.目前，我们只支持一个条目。

17.1.7. .status.clusterNetwork

描述: 用于 pod IP 的 IP 地址池。
类型: array

17.1.8. .status.clusterNetwork[]

描述: ClusterNetworkEntry 是从中分配 pod IP 地址的连续块。
类型: object

属性	类型	描述
`cidr`	`字符串`	pod IP 的完整块。
`hostPrefix`	`整数`	分配给每个节点的块的大小（前缀）。如果插件没有使用此字段，则可以取消设置它。

17.1.9. .status.conditions

描述: 条件代表 network.config 当前状态的观察。已知的 .status.conditions.type are: "NetworkTypeMigrationInProgress", "NetworkTypeMigrationMTUReady", "NetworkTypeMigrationTargetCNIAvailable", "NetworkTypeMigrationTargetCNIInUse" 和 "NetworkTypeMigrationOriginalCNIPurged"
类型: array

17.1.10. .status.conditions[]

描述

条件包含此 API 资源当前状态的一个方面的详情。--- 这个结构旨在直接用作字段路径 .status.conditions 中的数组。例如，输入 FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions" // other fields }

类型

object

必填

lastTransitionTime
message
reason
status
type

属性	类型	描述
`lastTransitionTime`	`字符串`	lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间。这应该是底层条件变化的时间。如果为未知，则使用 API 字段更改的时间是可以接受的。
`message`	`字符串`	Message 是人类可读的消息，指示有关转换的详细信息。这可能是一个空字符串。
`observedGeneration`	`整数`	observedGeneration 代表 .metadata.generation，这是条件设置所基于的条件。例如，如果 .metadata.generation 目前为 12，但 .status.conditions[x].observedGeneration 是 9，则代表条件与实例的当前状态已不匹配。
`reason`	`字符串`	reason 包含程序标识符，指示条件最后一次转换的原因。特定条件类型的制作者可能会定义预期的值和此字段的含义，以及这些值是否被视为有保证的 API。该值应该是 CamelCase 字符串。此字段可能不是空的。
`status`	`字符串`	条件的状态，True, False, Unknown 之一。
`type`	`字符串`	CamelCase 或 foo.example.com/CamelCase 中的条件类型。-- Many .condition.type 值在资源间是一致的，但因为任意条件可能很有用（请参阅 .node.status.conditions），deconflict 的能力非常重要。它匹配的正则表达式是 (dns1123SubdomainFmt/)? (qualifiedNameFmt)

17.1.11. .status.migration

描述: 迁移包含集群网络迁移配置。
类型: object

属性	类型	描述
`mtu`	`object`	MTU 包含 MTU 迁移配置。
`networkType`	`字符串`	networkType 是要部署的目标插件。目前支持的值有： OpenShiftSDN、OVNKubernetes

17.1.12. .status.migration.mtu

描述: MTU 包含 MTU 迁移配置。
类型: object

属性	类型	描述
`机器`	`object`	机器包含机器的 uplink 的 MTU 迁移配置。
`network`	`object`	network 包含 default 网络的 MTU 迁移配置。

17.1.13. .status.migration.mtu.machine

描述: 机器包含机器的 uplink 的 MTU 迁移配置。
类型: object

属性	类型	描述
`from`	`整数`	从是要从中迁移的 MTU。
`至`	`整数`	要迁移到的 MTU。

17.1.14. .status.migration.mtu.network

描述: network 包含 default 网络的 MTU 迁移配置。
类型: object

属性	类型	描述
`from`	`整数`	从是要从中迁移的 MTU。
`至`	`整数`	要迁移到的 MTU。