18.20. Network [operator.openshift.io/v1]

additionalNetworks

array

additionalNetworks 是启用多个网络时可供 pod 使用的额外网络列表。

additionalNetworks[]

对象

AdditionalNetworkDefinition 配置一个可用的额外网络，但没有默认创建。相反，pod 必须按名称请求它们。必须指定 type，以及与类型匹配的一个 "Config"。

clusterNetwork

array

clusterNetwork 是用于 pod IP 的 IP 地址池。有些网络供应商（如 OpenShift SDN）支持多个 ClusterNetworks。其他产品只支持一个。这等同于 cluster-cidr。

clusterNetwork[]

对象

ClusterNetworkEntry 是一个从中分配 PodIP 的子网。当节点加入集群时，将分配大小为 HostPrefix （以 CIDR 表示法）的网络。如果插件没有使用 HostPrefix 字段，则可以保留不设置。不是所有网络供应商支持多个 ClusterNetworks

defaultNetwork

对象

defaultNetwork 是所有 pod 接收的"默认"网络

deployKubeProxy

布尔值

deployKubeProxy 指定 Operator 是否应该部署独立 kube-proxy。有些网络供应商包括 kube-proxy 或类似的功能。如果未设置，则插件会尝试选择正确的值，在 OpenShift SDN 和 ovn-kubernetes 被使用时为 false，否则为 true。

disableMultiNetwork

布尔值

disableMultiNetwork 指定是否应禁用多个 pod 网络支持。如果未设置，此属性默认为 'false'，并且启用了多个网络支持。

disableNetworkDiagnostics

布尔值

disableNetworkDiagnostics 指定 PodNetworkConnectivityCheck CR 从测试 pod 到每个节点，应禁用 apiserver 和 LB。如果未设置，此属性默认为 'false' 并启用网络诊断。把它设置为 'true' 可减少执行检查的 pod 的额外负载。

exportNetworkFlows

对象

exportNetworkFlows 启用并配置 pod 网络中的网络流元数据导出，使用协议 NetFlow、SFlow 或 IPFIX。目前仅在 OVN-Kubernetes 插件中被支持。如果未设置，则不会将流导出到任何收集器。

kubeProxyConfig

对象

kubeProxyConfig 允许配置所需的代理配置。如果没有指定，则 OpenShift 将直接选择 sensable 默认值。没有被所有网络供应商使用 - 目前只有 openshift-sdn。

logLevel

字符串

logLevel 是针对整个组件的意图日志。它并不提供精细的控制，但管理操作器必须为其操作对象解释的粒度日志记录选择的简单方法。有效值为："Normal", "Debug", " Trace", " TraceAll"。默认为 "Normal"。

managementState

字符串

managementState 指明 Operator 是否应该如何管理组件

迁移

对象

迁移启用并配置集群网络迁移。把它设置为目标网络类型以允许更改默认网络。如果未设置，则更改集群默认网络插件的操作将被拒绝。

observedConfig

``

observedConfig 包含控制器从集群状态观察到的稀疏配置。它存在于 spec 中，因为它是 Operator 级别的输入

operatorLogLevel

字符串

operatorLogLevel 是 Operator 本身的基于日志的意图。它并不提供精细的控制，但是管理操作器必须自行解释的粒度日志记录选择的简单方法。有效值为："Normal", "Debug", " Trace", " TraceAll"。默认为 "Normal"。

serviceNetwork

数组（字符串）

serviceNetwork 是用于服务 IP 当前使用的 ip 地址池，所有现有的网络供应商在此只支持单个值，但这是允许增长的数组。

unsupportedConfigOverrides

``

unsupportedConfigOverrides 包含一个稀疏配置，它将覆盖任何之前设置的选项。它只需要是覆盖它的字段，它将以以下顺序结束：1。硬编码的默认值 2. observedConfig 3. unsupportedConfigOverrides

useMultiNetworkPolicy

布尔值

useMultiNetworkPolicy 启用了一个控制器，允许在由 Multus CNI 创建的额外网络中使用 MultiNetworkPolicy 对象。MultiNetworkPolicy 与 NetworkPolicy 对象类似，但 NetworkPolicy 对象仅适用于主接口。使用 MultiNetworkPolicy，您可以控制 pod 可以通过二级接口接收的流量。如果未设置，此属性默认为 'false' 和 MultiNetworkPolicy 对象将被忽略。如果 'disableMultiNetwork' 为 'true'，则忽略此字段的值。

name

字符串

name 是网络的名称。这将填充生成的 CRD，这必须是唯一的。

namespace

字符串

namespace 是网络的命名空间。如果没有在 default 命名空间中创建网络，这会填充生成的 CRD。

rawCNIConfig

字符串

rawCNIConfig 是要在 NetworkAttachmentDefinition CRD 中创建的原始 CNI 配置 json

simpleMacvlanConfig

对象

simpleMacvlanConfig 在 type:NetworkTypeSimpleMacvlan 时配置 macvlan 接口

type

字符串

type 是网络类型，支持的值是 NetworkTypeRaw, NetworkTypeSimpleMacvlan

ipamConfig

对象

ipamConfig 配置 IPAM 模块将用于 IP 地址管理(IPAM)。

master

字符串

Master 是要从中创建 macvlan 接口的主机接口。如果没有指定，它将是默认路由接口

模式

字符串

模式是 macvlan 模式：bridge、private、vepa、passthru。默认值为 bridge

mtu

整数

MTU 是用于 macvlan 接口的 mtu。如果未设置，主机的内核将选择该值。

staticIPAMConfig

对象

staticIPAMConfig 在 type:IPAMTypeStatic 时配置静态 IP 地址

type

字符串

type 是 IPAM 模块的类型将用于 IP 地址管理(IPAM)。支持的值有 IPAMTypeDHCP, IPAMTypeStatic

addresses

array

Address 为接口配置 IP 地址

addresses[]

对象

StaticIPAMAddresses 为静态 IPAM 地址提供 IP 地址和网关

dns

对象

DNS 为接口配置 DNS

Routes

array

路由为接口配置 IP 路由

routes[]

对象

StaticIPAMRoutes 为静态 IPAM 路由提供目的地/Gateway 对

address

字符串

address 是 CIDR 格式的 IP 地址

gateway

字符串

网关是子网内要指定为网关的 IP

domain

字符串

domain 配置用于短主机名查找的本地域的域名

nameservers

数组（字符串）

名称服务器指向 DNS 服务器进行 IP 查找

search

数组（字符串）

搜索配置优先级排序搜索域以获取短主机名查找

目的地

字符串

目的地指向 IP 路由目的地

gateway

字符串

gateway 是路由的下一步 IP 地址（如果未设置），则会假定默认网关（由 CNI 插件决定）。

cidr

字符串

hostPrefix

整数

kuryrConfig

对象

kuryrConfig 配置 kuryr 插件

openshiftSDNConfig

对象

openshiftSDNConfig 配置 openshift-sdn 插件

ovnKubernetesConfig

对象

ovnKubernetesConfig 配置 ovn-kubernetes 插件。目前没有实现。

type

字符串

除了 NetworkTypeRaw 外，支持网络 All NetworkTypes 的类型

controllerProbesPort

整数

端口 kuryr-controller 将侦听就绪度和存活度请求。

daemonProbesPort

整数

端口 kuryr-daemon 将侦听就绪度和存活度请求。

enablePortPoolsPrepopulation

布尔值

当 true 使 Kuryr 预先填充每个新创建的端口池时，enablePortPoolsPrepopulation。Kuryr 使用 Neutron 端口池来达到创建大量时间的事实。Kuryr 保留多个端口准备好附加到 pod 时，而不是在部署时创建它。默认情况下禁用端口预填充。

mtu

整数

MTU 是 Kuryr 在 Neutron 中创建 pod 网络时使用的 MTU。该值必须小于或等于节点网络的 MTU，而 Neutron 必须允许使用此类 MTU 创建租户网络。如果未设置 Pod 网络会使用与节点网络相同的 MTU 创建。

openStackServiceNetwork

字符串

openStackServiceNetwork 包含从中为 OpenStack Octavia 的 Amphora 虚拟机分配 IP 的网络 CIDR。请注意，对于 Amphora 驱动程序 Octavia，每个负载均衡器都使用来自该网络的两个 IP - 一个由 OpenShift 指定，第二个用于 VRRP 连接。由于第一人由 OpenShift 的 OpenShift 管理，第二个由 Neutron 的 IPAM 管理，它们需要来自不同的池。因此，openStackServiceNetwork 需要至少是 serviceNetwork 的两倍，并且整个 serviceNetwork 必须与 openStackServiceNetwork 重叠。cluster-network-operator 可确保从 openStackServiceNetwork 中的范围获取 VRRP IP，这与 serviceNetwork 重叠，从而防止冲突。如果没有设置 cluster-network-operator，则使用 serviceNetwork，方法是将前缀大小减少为 1。

poolBatchPorts

整数

poolBatchPorts 设置应在单个批处理请求中创建的多个端口来扩展端口池。默认值为 3。有关端口池的更多信息，请参阅 enablePortPoolsPrepopulation 设置。

poolMaxPorts

整数

poolMaxPorts 设置保存在端口池中的最大可用端口数。如果端口数量超过此设置，则空闲端口将被删除。设置 0 将禁用此上限，有效防止池缩小，这是默认值。有关端口池的更多信息，请参阅 enablePortPoolsPrepopulation 设置。

poolMinPorts

整数

poolMinPorts 设置应保留在端口池中的最少可用端口数。如果端口数量低于此设置，则会创建新端口并添加到池中。默认值为 1。有关端口池的更多信息，请参阅 enablePortPoolsPrepopulation 设置。

enableUnidling

布尔值

启用统一控制服务代理是否支持闲置和取消闲置服务。默认情况下启用取消闲置。

模式

字符串

mode 是"Multitenant"、"Subnet" 或 "NetworkPolicy" 之一

mtu

整数

MTU 是用于隧道接口的 mtu。如果未设置，则默认为 1450。这必须比机器的 uplink 小 50 字节。

useExternalOpenvswitch

布尔值

使用ExternalOpenvswitch 来控制 Operator 是否部署 OVS DaemonSet 本身，或者希望其他人启动 OVS。从 4.6 开始，OVS 始终作为系统服务运行，这个标志将被忽略。DEPRECATED: 从 4.6 开始无法正常工作

vxlanPort

整数

vxlanPort 是所有 vxlan 数据包使用的端口。默认值为 4789。

genevePort

整数

Geneve 端口是 geneve encapulation 使用的 UDP 端口。默认为 6081

hybridOverlayConfig

对象

hybridOverlayConfig 为不使用 OVN 的对等点配置额外的覆盖网络。

ipsecConfig

对象

ipsecConfig 为集群中的 pod 网络上的 pod 启用并配置 IPsec。

mtu

整数

MTU 是用于隧道接口的 MTU。这必须比 uplink mtu 小 100 字节。默认为 1400

policyAuditConfig

对象

policyAuditConfig 是网络策略审计事件的配置。如果未设置，则使用报告的默认值。

hybridClusterNetwork

array

hybridClusterNetwork 定义分配给额外覆盖网络上的节点的网络空间。

hybridClusterNetwork[]

对象

ClusterNetworkEntry 是一个从中分配 PodIP 的子网。当节点加入集群时，将分配大小为 HostPrefix （以 CIDR 表示法）的网络。如果插件没有使用 HostPrefix 字段，则可以保留不设置。不是所有网络供应商支持多个 ClusterNetworks

hybridOverlayVXLANPort

整数

hybridOverlayVXLANPort 定义额外覆盖网络使用的 VXLAN 端口号。默认为 4789

cidr

字符串

hostPrefix

整数

目的地

字符串

destination 是策略日志消息的位置。无论这个配置是什么，持久性日志总是转储到 /var/log/ovn/ 的主机，但也可以配置其他 syslog 输出，如下所示。有效值为： - "libc" 使用主机节点的 journdald 进程的 libc syslog （）函数 - "udp:host:port" 通过 UDP 发送 syslog - "unix:file" 用于直接使用 UNIX 域套接字 - "null" 来丢弃记录到 syslog 的所有消息。

maxFileSize

整数

maxFilesSize 是 ACL_audit 日志文件的最大值，在轮转发生单元以 MB 为单位，默认为 50MB

rateLimit

整数

ratelimit 是每个节点每秒生成的大约最大消息数。如果未设置默认值 20 msg/sec。

syslogFacility

字符串

用于生成的消息的 RFC5424 工具的 syslogFacility，如 "kern"。默认为 "local0"

ipfix

对象

IPFIX 定义 IPFIX 配置。

netFlow

对象

NetFlow 定义 NetFlow 配置。

sFlow

对象

sFlow 定义 SFlow 配置。

collectors

数组（字符串）

ipfixCollectors 是字符串列表，格式为 ip:port，最多 10 个项目

collectors

数组（字符串）

NetFlow 定义 NetFlow 收集器，它将消耗从 OVS 导出的流程数据。它是格式为 ip:port 的字符串列表，最多有十个项目

collectors

数组（字符串）

sFlowCollectors 是字符串列表，格式为 ip:port，最多 10 个项目

bindAddress

字符串

默认到 0.0.0.0 上的 "bind" 地址

iptablesSyncPeriod

字符串

内部 kube-proxy 参数。在较早版本的 OCP 中，出于性能原因，有时需要在大型集群中调整此调整，但这已不再需要，因此不需要修改默认值。默认：30s

proxyArguments

对象

传递给 kubeproxy 进程的任何其他参数

proxyArguments{}

数组（字符串）

ProxyArgumentList 是传递给 kubeproxy 进程的参数列表

networkType

字符串

networkType 是网络迁移的目标类型，支持的值是 OpenShiftSDN、OVNKubernetes

conditions

array

conditions 是条件及其状态列表

conditions[]

对象

OperatorCondition 只是标准条件字段。

generations

array

生成用于确定何时需要协调项目，或者以需要反应的方式更改项目。

generations[]

对象

GenerationStatus 跟踪给定资源的生成，以便可以做出有关强制更新的决策。

observedGeneration

整数

observedGeneration 是您已处理的最后生成变化

readyReplicas

整数

readyReplicas 指示有多少副本就绪并处于所需的状态

version

字符串

版本是此可用性适用于的级别

lastTransitionTime

字符串

message

字符串

reason

字符串

status

字符串

type

字符串

group

字符串

group 是您要跟踪的项的组

hash

字符串

hash 是为没有生成的资源设置的可选字段，内容敏感，如 secret 和 configmaps

lastGeneration

整数

lastGeneration 是涉及的工作负载控制器的最后生成

name

字符串

name 是您要跟踪的项的名称

namespace

字符串

命名空间是您跟踪的事情的位置

resource

字符串

Resource 是您要跟踪的事情的资源类型

pretty

字符串

如果 'true'，则输出被用户友善。

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。

继续

字符串

从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。

当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

200 - OK

Status_v2 模式

401 - Unauthorized

空

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。

继续

字符串

从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。

当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

200 - OK

NetworkList 模式

401 - Unauthorized

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

正文（body）

网络 模式

200 - OK

网络 模式

201 - Created

网络 模式

202 - Accepted

网络 模式

401 - Unauthorized

空

name

字符串

网络的名称

pretty

字符串

如果 'true'，则输出被用户友善。

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。

正文（body）

DeleteOptions_v2 schema

200 - OK

Status_v2 模式

202 - Accepted

Status_v2 模式

401 - Unauthorized

空

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

200 - OK

网络 模式

401 - Unauthorized

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

正文（body）

Patch 模式

200 - OK

网络 模式

401 - Unauthorized

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

正文（body）

网络 模式

200 - OK

网络 模式

201 - Created

网络 模式

401 - Unauthorized

空