9.3. 将虚拟机连接到主用户定义的网络

流程

1. 从 Administrator 视角中，点 Administration Namespaces。
2. 点 Create Namespace。
3. 在 Name 字段中，为命名空间指定一个名称。名称必须包含小写字母数字字符或 '-'，且必须以字母数字字符开头和结尾。
4. 在 Labels 字段中，添加 k8s.ovn.org/primary-user-defined-network 标签。
5. 可选：如果要将命名空间与现有集群范围的 UDN 一起使用，请添加 ClusterUserDefinedNetwork 自定义资源的 spec.namespaceSelector 字段中定义的适当标签。
6. 可选：指定一个默认网络策略。
7. 点 Create 创建命名空间。

流程

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

流程

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

流程

1. 创建一个 Namespace 对象作为一个类似以下示例的 YAML 文件：

   apiVersion: v1
   kind: Namespace
   metadata:
     name: my-namespace
     labels:
       k8s.ovn.org/primary-user-defined-network: "" 

   1

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   与 UDN 关联的命名空间需要该标签。如果命名空间与现有集群 UDN 一起使用，还必须添加 ClusterUserDefinedNetwork 自定义资源的 spec.namespaceSelector 字段中定义的适当标签。

2. 运行以下命令来应用 Namespace 清单：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 创建 UserDefinedNetwork 对象以指定自定义网络配置：

   UserDefinedNetwork 清单示例

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

   1

   
     namespace: my-namespace 

   2

   
   spec:
     topology: Layer2 

   3

   
     layer2:
       role: Primary 

   4

   
       subnets:
         - "10.0.0.0/24"
         - "2001:db8::/60"
     ipam:
       lifecycle: Persistent 

   5

   Copy to Clipboard Toggle word wrap

   1

   指定 UserDefinedNetwork 自定义资源的名称。

   2

   指定虚拟机所在的命名空间。命名空间必须具有 k8s.ovn.org/primary-user-defined-network 标签。命名空间不能为 default，openshift requirements 命名空间，或者与 Cluster Network Operator (CNO)定义的任何全局命名空间匹配。

   3

   指定网络的拓扑配置。所需的值为 Layer2。Layer2 拓扑会创建一个逻辑交换机，供所有节点共享。

   4

   指定 UDN 是 primary 或 secondary。Primary 角色意味着 UDN 充当虚拟机的主网络，所有默认流量都通过此网络。

   5

   指定虚拟工作负载在重新引导和迁移后具有一致的 IP 地址。当指定 ipam.lifecycle: Persistent 时，需要 spec.layer2.subnets 字段。

2. 运行以下命令来应用 UserDefinedNetwork 清单：

   $ oc apply -f --validate=true <filename>.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 创建 ClusterUserDefinedNetwork 对象来指定自定义网络配置：

   ClusterUserDefinedNetwork 清单示例

   kind: ClusterUserDefinedNetwork
   metadata:
     name: cudn-l2-net 

   1

   
   spec:
     namespaceSelector: 

   2

   
       matchExpressions: 

   3

   
       - key: kubernetes.io/metadata.name
         operator: In 

   4

   
         values: ["red-namespace", "blue-namespace"]
     network:
       topology: Layer2 

   5

   
       layer2:
         role: Primary 

   6

   
         ipam:
           lifecycle: Persistent
         subnets:
           - 203.203.0.0/16

   Copy to Clipboard Toggle word wrap

   1

   指定 ClusterUserDefinedNetwork 自定义资源的名称。

   2

   指定集群 UDN 应用到的命名空间集合。命名空间选择器不得指向 default、openshift channel 命名空间或 Cluster Network Operator (CNO) 定义的任何全局命名空间。

   3

   指定选择器的类型。在本例中，matchExpressions 选择器选择带有标签 kubernetes.io/metadata.name 且值为 red-namespace 或 blue-namespace 的对象。

   4

   指定 Operator 的类型。可能的值有 In、NotIn 和 Exists。

   5

   指定网络的拓扑配置。所需的值为 Layer2。Layer2 拓扑会创建一个逻辑交换机，供所有节点共享。

   6

   指定 UDN 是 primary 或 secondary。Primary 角色意味着 UDN 充当虚拟机的主网络，所有默认流量都通过此网络。

2. 运行以下命令来应用 ClusterUserDefinedNetwork 清单：

   $ oc apply -f --validate=true <filename>.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 按照以下步骤启用 passt 网络绑定插件技术预览功能：

   1. 从 Virtualization 视角中，单击 Overview。
   2. 在 Virtualization 页面中，点 Settings 选项卡。
   3. 点 Preview features，为主用户定义的网络设置 Enable Passt binding to on。
2. 从 Virtualization 视角中，点 VirtualMachines。
3. 选择一个虚拟机以打开 VirtualMachine 详情页。
4. 点 Configuration 选项卡。
5. 单击 Network。
6. 点击 Network interfaces 页中的 Options 菜单 并选择 Edit。
7. 在 Edit network interface 对话框中，从 Network 列表中选择默认 pod 网络附加。
8. 展开 Advanced，然后选择 Passt 绑定。
9. 点击 Save。
10. 如果您的虚拟机正在运行，重启它以使更改生效。

流程

1. 编辑 VirtualMachine 清单以添加 UDN 接口详情，如下例所示：

   VirtualMachine 清单示例：

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: example-vm
     namespace: my-namespace 

   1

   
   spec:
     template:
       spec:
         domain:
           devices:
             interfaces:
               - name: udn-l2-net 

   2

   
                 binding:
                   name: l2bridge 

   3

   
   # ...
         networks:
         - name: udn-l2-net 

   4

   
           pod: {}
   # ...

   Copy to Clipboard Toggle word wrap

   1

   虚拟机所在的命名空间。这个值必须与定义 UDN 的命名空间匹配。

   2

   用户定义的网络接口的名称。

   3

   用于连接到虚拟机的绑定插件的名称。可能的值有 l2bridge 和 passt。默认值为 l2bridge。

   4

   网络的名称。这必须与 spec.template.spec.domain.devices.interfaces.name 字段的值匹配。

2. 可选：如果您使用 Plug a Simple Socket Transport (passt)网络绑定插件，请运行以下命令将 HyperConverged 自定义资源(CR)中的 hco.kubevirt.io/deployPasstNetworkBinding 注解设置为 true ：

   $ oc annotate hco kubevirt-hyperconverged -n kubevirt-hyperconverged hco.kubevirt.io/deployPasstNetworkBinding=true --overwrite

   Copy to Clipboard Toggle word wrap
   重要

   使用 passt 绑定插件将虚拟机附加到主 UDN 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

   有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

3. 运行以下命令来应用 VirtualMachine 清单：

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap