第 2 章 主网络

流程

1. 可选： 对于使用主网络的 ClusterUserDefinedNetwork CR，请输入以下命令创建带有 k8s.ovn.org/primary-user-defined-network 标签的命名空间：

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: <cudn_namespace_name>
     labels:
       k8s.ovn.org/primary-user-defined-network: ""
   EOF

   Copy to Clipboard Toggle word wrap

2. 为 Layer2 或 Layer3 拓扑类型集群范围的用户定义的网络创建请求：

   1. 创建 YAML 文件，如 cluster-layer-two-udn.yaml，为 Layer2 拓扑定义请求，如下例所示：

      apiVersion: k8s.ovn.org/v1
      kind: ClusterUserDefinedNetwork
      metadata:
        name: <cudn_name> 

      1

      
      spec:
        namespaceSelector: 

      2

      
          matchLabels: 

      3

      
            "<label_1_key>": "<label_1_value>" 

      4

      
            "<label_2_key>": "<label_2_value>" 

      5

      
        network: 

      6

      
          topology: Layer2 

      7

      
          layer2: 

      8

      
            role: Primary 

      9

      
            subnets:
              - "2001:db8::/64"
              - "10.100.0.0/16" 

      10

      Copy to Clipboard Toggle word wrap

      1

      ClusterUserDefinedNetwork CR 的名称。

      2

      集群 UDN CR 应用到的命名空间集合上的标签查询。使用标准 Kubernetes MatchLabel 选择器。不得指向 default 或 openshift channel 命名空间。

      3

      使用 matchLabels 选择器类型，其中使用 AND 关系评估术语。

      4 5

      因为使用了 matchLabels 选择器类型，因此会置备包含 <label_1_key>=<label_1_value> 和 <label_2_key>=<label_2_value> 标签的命名空间。

      6

      描述网络配置。

      7

      topology 字段描述了网络配置；接受的值是 Layer2 和 Layer3。指定 Layer2 拓扑类型会创建一个逻辑交换机，它被所有节点共享。

      8

      此字段指定拓扑配置。它可以是 layer2 或 layer3。

      9

      指定 Primary 或 Secondary。Primary 是 4.18 中唯一支持的 role 规格。

      10

      对于 Layer2 拓扑类型，以下指定 subnet 字段的配置详情：

      • subnets 字段是可选的。
      • subnets 字段的类型是字符串，接受 IPv4 和 IPv6 的标准 CIDR 格式。
      • subnets 字段接受一个或多个项。如果是两个项，它们必须属于不同的系列。例如，子网值 10.100.0.0/16 和 2001:db8::/64。
      • 可以省略 Layer2 子网。如果省略，用户必须为 pod 配置静态 IP 地址。因此，端口安全性只能阻止 MAC 欺骗。如需更多信息，请参阅"使用静态 IP 地址配置 pod"。

   2. 创建 YAML 文件，如 cluster-layer-three-udn.yaml，为 Layer3 拓扑定义您的请求，如下例所示：

      apiVersion: k8s.ovn.org/v1
      kind: ClusterUserDefinedNetwork
      metadata:
        name: <cudn_name> 

      1

      
      spec:
        namespaceSelector: 

      2

      
          matchExpressions: 

      3

      
          - key: kubernetes.io/metadata.name 

      4

      
            operator: In 

      5

      
            values: ["<example_namespace_one>", "<example_namespace_two>"] 

      6

      
        network: 

      7

      
          topology: Layer3 

      8

      
          layer3: 

      9

      
            role: Primary 

      10

      
            subnets: 

      11

      
              - cidr: 10.100.0.0/16
                hostSubnet: 24

      Copy to Clipboard Toggle word wrap

      1

      ClusterUserDefinedNetwork CR 的名称。

      2

      集群 UDN 应用到的命名空间集合上的标签查询。使用标准 Kubernetes MatchLabel 选择器。不得指向 default 或 openshift channel 命名空间。

      3

      使用 matchExpressions 选择器类型，其中使用 OR 关系评估术语。

      4

      指定要匹配的标签键。

      5

      指定 operator。有效值包括： In,NotIn,Exists, 和 DoesNotExist。

      6

      因为使用了 matchExpressions 类型，因此置备命名空间与 <example_namespace_one> 或 <example_namespace_two> 匹配。

      7

      描述网络配置。

      8

      topology 字段描述了网络配置；接受的值是 Layer2 和 Layer3。指定 Layer3 拓扑类型会为每个节点创建一个第 2 层段，各自具有不同的子网。第 3 层路由用于互连节点子网。

      9

      此字段指定拓扑配置。有效值为 layer2 或 layer3。

      10

      指定 Primary 或 Secondary 角色。Primary 是 4.18 中唯一支持的 role 规格。

      11

      对于 Layer3 拓扑类型，以下指定 subnet 字段的配置详情：

      • subnets 字段是必需的。

      • subnets 字段的类型是 cidr 和 hostSubnet ：

        • cidr 是集群子网，它接受一个字符串值。
        • hostSubnet 指定集群子网分割的节点子网前缀。
        • 对于 IPv6，hostSubnet 仅支持 /64 长度。

3. 运行以下命令来应用您的请求：

   $ oc create --validate=true -f <example_cluster_udn>.yaml

   Copy to Clipboard Toggle word wrap

   其中 <example_cluster_udn>.yaml 是 Layer2 或 Layer3 配置文件的名称。

4. 运行以下命令验证您的请求是否成功：

   $ oc get clusteruserdefinednetwork <cudn_name> -o yaml

   Copy to Clipboard Toggle word wrap

   其中 <cudn_name> 是您创建集群范围的用户定义的网络的名称。

   输出示例

   apiVersion: k8s.ovn.org/v1
   kind: ClusterUserDefinedNetwork
   metadata:
     creationTimestamp: "2024-12-05T15:53:00Z"
     finalizers:
     - k8s.ovn.org/user-defined-network-protection
     generation: 1
     name: my-cudn
     resourceVersion: "47985"
     uid: 16ee0fcf-74d1-4826-a6b7-25c737c1a634
   spec:
     namespaceSelector:
       matchExpressions:
       - key: custom.network.selector
         operator: In
         values:
         - example-namespace-1
         - example-namespace-2
         - example-namespace-3
     network:
       layer3:
         role: Primary
         subnets:
         - cidr: 10.100.0.0/16
       topology: Layer3
   status:
     conditions:
     - lastTransitionTime: "2024-11-19T16:46:34Z"
       message: 'NetworkAttachmentDefinition has been created in following namespaces:
         [example-namespace-1, example-namespace-2, example-namespace-3]'
       reason: NetworkAttachmentDefinitionReady
       status: "True"
       type: NetworkCreated

   Copy to Clipboard Toggle word wrap

流程

1. 从 Administrator 视角中，点 Networking UserDefinedNetworks。
2. 点 ClusterUserDefinedNetwork。
3. 在 Name 字段中，为集群范围的 UDN 指定名称。
4. 在 Subnet 字段中指定一个值。
5. 在 Project (s) Match Labels 字段中，添加适当的标签以选择集群 UDN 应用到的命名空间。
6. 点 Create。集群范围的 UDN 充当位于命名空间中 pod 的默认主网络，其中包含在第 5 步中指定的标签。

流程

1. 可选： 对于使用主网络的 UserDefinedNetwork CR，请输入以下命令创建带有 k8s.ovn.org/primary-user-defined-network 标签的命名空间：

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: <udn_namespace_name>
     labels:
       k8s.ovn.org/primary-user-defined-network: ""
   EOF

   Copy to Clipboard Toggle word wrap

2. 为 Layer2 或 Layer3 拓扑类型用户定义的网络创建请求：

   1. 创建一个 YAML 文件，如 my-layer-two-udn.yaml，为 Layer2 拓扑定义您的请求，如下例所示：

      apiVersion: k8s.ovn.org/v1
      kind: UserDefinedNetwork
      metadata:
        name: udn-1 

      1

      
        namespace: <some_custom_namespace>
      spec:
        topology: Layer2 

      2

      
        layer2: 

      3

      
          role: Primary 

      4

      
          subnets:
            - "10.0.0.0/24"
            - "2001:db8::/60" 

      5

      Copy to Clipboard Toggle word wrap

      1

      UserDefinedNetwork 资源的名称。这不应该是 default 或重复 Cluster Network Operator (CNO) 创建的任何全局命名空间。

      2

      topology 字段描述了网络配置；接受的值是 Layer2 和 Layer3。指定 Layer2 拓扑类型会创建一个逻辑交换机，它被所有节点共享。

      3

      此字段指定拓扑配置。它可以是 layer2 或 layer3。

      4

      指定 Primary 或 Secondary 角色。

      5

      对于 Layer2 拓扑类型，以下指定 subnet 字段的配置详情：

      • subnets 字段是可选的。
      • subnets 字段的类型是字符串，接受 IPv4 和 IPv6 的标准 CIDR 格式。
      • subnets 字段接受一个或多个项。如果是两个项，它们必须属于不同的系列。例如，子网值 10.100.0.0/16 和 2001:db8::/64。
      • 可以省略 Layer2 子网。如果省略，用户需要为 pod 配置 IP 地址。因此，端口安全性只能阻止 MAC 欺骗。
      • 当指定 ipamLifecycle 字段时，Layer2 subnets 字段是必须的。

   2. 创建一个 YAML 文件，如 my-layer-three-udn.yaml，为 Layer3 拓扑定义您的请求，如下例所示：

      apiVersion: k8s.ovn.org/v1
      kind: UserDefinedNetwork
      metadata:
        name: udn-2-primary 

      1

      
        namespace: <some_custom_namespace>
      spec:
        topology: Layer3 

      2

      
        layer3: 

      3

      
          role: Primary 

      4

      
          subnets: 

      5

      
            - cidr: 10.150.0.0/16
              hostSubnet: 24
            - cidr: 2001:db8::/60
              hostSubnet: 64
      # ...

      Copy to Clipboard Toggle word wrap

      1

      UserDefinedNetwork 资源的名称。这不应该是 default 或重复 Cluster Network Operator (CNO) 创建的任何全局命名空间。

      2

      topology 字段描述了网络配置；接受的值是 Layer2 和 Layer3。指定 Layer3 拓扑类型会为每个节点创建一个第 2 层段，各自具有不同的子网。第 3 层路由用于互连节点子网。

      3

      此字段指定拓扑配置。有效值为 layer2 或 layer3。

      4

      指定 Primary 或 Secondary 角色。

      5

      对于 Layer3 拓扑类型，以下指定 subnet 字段的配置详情：

      • subnets 字段是必需的。

      • subnets 字段的类型是 cidr 和 hostSubnet ：

        • CIDR 等同于集群的 clusterNetwork 配置设置。CIDR 中的 IP 地址分布到用户定义的网络中的 pod。此参数接受字符串值。
        • hostSubnet 定义每个节点子网的前缀。
        • 对于 IPv6，hostSubnet 仅支持 /64 长度。

3. 运行以下命令来应用您的请求：

   $ oc apply -f <my_layer_two_udn>.yaml

   Copy to Clipboard Toggle word wrap

   其中 <my_layer_two_udn>.yaml 是 Layer2 或 Layer3 配置文件的名称。

4. 运行以下命令验证您的请求是否成功：

   $ oc get userdefinednetworks udn-1 -n <some_custom_namespace> -o yaml

   Copy to Clipboard Toggle word wrap

   其中 some_custom_namespace 是您为用户定义的网络创建的命名空间。

   输出示例

   apiVersion: k8s.ovn.org/v1
   kind: UserDefinedNetwork
   metadata:
     creationTimestamp: "2024-08-28T17:18:47Z"
     finalizers:
     - k8s.ovn.org/user-defined-network-protection
     generation: 1
     name: udn-1
     namespace: some-custom-namespace
     resourceVersion: "53313"
     uid: f483626d-6846-48a1-b88e-6bbeb8bcde8c
   spec:
     layer2:
       role: Primary
       subnets:
       - 10.0.0.0/24
       - 2001:db8::/60
     topology: Layer2
   status:
     conditions:
     - lastTransitionTime: "2024-08-28T17:18:47Z"
       message: NetworkAttachmentDefinition has been created
       reason: NetworkAttachmentDefinitionReady
       status: "True"
       type: NetworkCreated

   Copy to Clipboard Toggle word wrap

流程

1. 从 Administrator 视角中，点 Networking UserDefinedNetworks。
2. 点 Create UserDefinedNetwork。
3. 从 Project name 列表中，选择您之前创建的命名空间。
4. 在 Subnet 字段中指定一个值。
5. 点 Create。用户定义的网络充当您在此命名空间中创建的 pod 的默认主网络。