5.2. 配置和使用多个网络

流程

1. 可选：运行以下命令来验证 MicroShift 集群是否使用 Multus CNI 运行：

   $ oc get pods -n openshift-multus

   输出示例

   NAME                READY   STATUS    RESTARTS   AGE
   dhcp-daemon-dfbzw   1/1     Running   0          5h
   multus-rz8xc        1/1     Running   0          5h

2. 运行以下命令来创建 NetworkAttachmentDefinition 配置文件，并使用以下示例文件作为参考：

   $ oc apply -f network-attachment-definition.yaml

   NetworkAttachmentDefinition 文件示例

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: bridge-conf
   spec:
     config: '{
         "cniVersion": "0.4.0",
         "type": "bridge", 1
         "bridge": "br-test", 2
         "mode": "bridge",
         "ipam": {
           "type": "host-local", 3
           "ranges": [
             [
               {
                 "subnet": "10.10.0.0/24",
                 "rangeStart": "10.10.0.20",
                 "rangeEnd": "10.10.0.50",
                 "gateway": "10.10.0.254"
                }
             ],
             [
               {
                 "subnet": "fd00:IJKL:MNOP:10::0/64", 4
                 "rangeStart": "fd00:IJKL:MNOP:10::1",
                 "rangeEnd": "fd00:IJKL:MNOP:10::9"
           "dataDir": "/var/lib/cni/br-test"
         }
       }'

   1

   type 值指定 CNI 插件的名称。本例使用 bridge 类型。

   2

   bridge 值是使用的 MicroShift 主机上的网桥名称。pod 的额外接口连接到该网桥。如果主机上不存在接口，则 Bridge CNI 会创建它。如果接口已存在，它将被重复使用。在本例中，接口名称为 br-test。

   3

   IPAM 类型。

   4

   IPv6 地址可以添加到二级接口。

   注意

   使用网桥的名称特定于插件 的网桥 类型。其他插件在其 NetworkAttachmentDefinition 中使用不同的字段。例如，macvlan 和 ipvlan 配置使用 master 指定要附加的主机接口。

流程

1. 为 Pod YAML 文件添加注解。只能使用以下注解格式之一：

   1. 要在没有自定义的情况下附加额外网络，请使用以下格式添加注解。将 <network> 替换为要与 pod 关联的额外网络的名称：

      apiVersion: v1
      kind: Pod
      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: <network>[,<network>,...] 1
      # ...

      1

      将 & lt;network > 替换为要与 pod 关联的额外网络的名称。要指定多个额外网络，请使用逗号分隔各个网络。逗号之间不可包括空格。如果您多次指定同一额外网络，则该 pod 会将多个网络接口附加到该网络。

      网桥类型额外网络的注解示例

      apiVersion: v1
      kind: Pod
      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: bridge-conf
      # ...

   2. 要通过自定义来附加额外网络，请添加具有以下格式的注解：

      apiVersion: v1
      kind: Pod
      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: |-
            [
              {
                "name": "<network>", 1
                "namespace": "<namespace>", 2
                "default-route": ["<default-route>"] 3
              }
            ]
      # ...

      1

      指定 NetworkAttachmentDefinition 对象定义的额外网络的名称。

      2

      指定定义 NetworkAttachmentDefinition 对象的命名空间。

      3

      可选：为默认路由指定覆盖，如 192.168.17.1。

2. 要创建 Pod YAML 文件并为额外网络添加 NetworkAttachmentDefinition 注解，请运行以下命令并使用示例 YAML：

   $ oc apply -f ./<test-bridge>.yaml 1

   1

   将 <test-bridge > 替换为您要使用的 pod 名称。

   输出示例

   pod/test-bridge created

   test-bridge pod YAML 示例

   apiVersion: v1
   kind: Pod
   metadata:
     name: test-bridge
     annotations:
       k8s.v1.cni.cncf.io/networks: bridge-conf
     labels:
       app: test-bridge
   spec:
     terminationGracePeriodSeconds: 0
     containers:
     - name: hello-microshift
       image: quay.io/microshift/busybox:1.36
       command: ["/bin/sh"]
       args: ["-c", "while true; do echo -ne \"HTTP/1.0 200 OK\r\nContent-Length: 16\r\n\r\nHello MicroShift\" | nc -l -p 8080 ; done"]
       ports:
       - containerPort: 8080
         protocol: TCP
       securityContext:
         allowPrivilegeEscalation: false
         capabilities:
           drop:
           - ALL
         runAsNonRoot: true
         runAsUser: 1001
         runAsGroup: 1001
         seccompProfile:
           type: RuntimeDefault

3. 确保 NetworkAttachmentDefinition 注解正确：

   NetworkAttachmentDefinition 注解示例

   apiVersion: v1
   kind: Pod
   metadata:
     annotations:
       k8s.v1.cni.cncf.io/networks: bridge-conf
   # ...

4. 可选： 要确认 Pod YAML 中是否存在 NetworkAttachmentDefinition 注解，请运行以下命令，将 < name& gt; 替换为 pod 的名称。

   $ oc get pod <name> -o yaml 1

   1

   将 <name > 替换为您要使用的 pod 名称。在以下示例中使用了 test-bridge。

   在以下示例中，test-bridge 附加到 net1 额外网络：

   $ oc get pod test-bridge -o yaml

   输出示例

   apiVersion: v1
   kind: Pod
   metadata:
     annotations:
       k8s.v1.cni.cncf.io/networks: bridge-conf
       k8s.v1.cni.cncf.io/network-status: |- 1
         [{
             "name": "ovn-kubernetes",
             "interface": "eth0",
             "ips": [
                 "10.42.0.18"
             ],
             "default": true,
             "dns": {}
         },{
             "name": "bridge-conf",
             "interface": "net1",
             "ips": [
                 "20.2.2.100"
             ],
             "mac": "22:2f:60:a5:f8:00",
             "dns": {}
         }]
     name: pod
     namespace: default
   spec:
   # ...
   status:
   # ...

   1

   k8s.v1.cni.cncf.io/network-status 参数是对象的 JSON 数组。每个对象描述附加到 pod 的额外网络的状态。注解值保存为纯文本值。

5. 运行以下命令验证 pod 是否正在运行：

   $ oc get pod

   输出示例

   NAME          READY   STATUS    RESTARTS   AGE
   test-bridge   1/1     Running   0          81s

前提条件

1. 您创建并应用 NetworkAttachmentDefinition 对象配置。

流程

1. 运行以下命令验证主机上是否已创建网桥：

   $ ip a show br-test

   输出示例

   22: br-test: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
       link/ether 96:bf:ca:be:1d:15 brd ff:ff:ff:ff:ff:ff
       inet6 fe80::34e2:bbff:fed2:31f2/64 scope link
          valid_lft forever preferred_lft forever

2. 运行以下命令，为网桥配置 IP 地址：

   $ sudo ip addr add 10.10.0.10/24 dev br-test

3. 运行以下命令，验证 IP 地址配置是否已添加到桥接中：

   $ ip a show br-test

   输出示例

   22: br-test: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
       link/ether 96:bf:ca:be:1d:15 brd ff:ff:ff:ff:ff:ff
       inet 10.10.0.10/24 scope global br-test 1
          valid_lft forever preferred_lft forever
       inet6 fe80::34e2:bbff:fed2:31f2/64 scope link
          valid_lft forever preferred_lft forever

   1

   IP 地址按预期配置。

4. 运行以下命令，验证 pod 的 IP 地址：

   $ oc get pod test-bridge --output=jsonpath='{.metadata.annotations.k8s\.v1\.cni\.cncf\.io/network-status}'

   输出示例

   [{
       "name": "ovn-kubernetes",
       "interface": "eth0",
       "ips": [
           "10.42.0.17"
       ],
       "mac": "0a:58:0a:2a:00:11",
       "default": true,
       "dns": {}
   },{
       "name": "default/bridge-conf", 1
       "interface": "net1",
       "ips": [
           "10.10.0.20"
       ],
       "mac": "82:01:98:e5:0c:b7",
       "dns": {}

   1

   网桥额外网络会如预期附加。

5. 可选： 您可以使用 oc exec 访问 pod 并使用 ip 命令确认其接口：

   $ oc exec -ti test-bridge -- ip a

   输出示例

   1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue qlen 1000
       link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
       inet 127.0.0.1/8 scope host lo
          valid_lft forever preferred_lft forever
       inet6 ::1/128 scope host
          valid_lft forever preferred_lft forever
   2: eth0@if21: <BROADCAST,MULTICAST,UP,LOWER_UP,M-DOWN> mtu 1500 qdisc noqueue
       link/ether 0a:58:0a:2a:00:11 brd ff:ff:ff:ff:ff:ff
       inet 10.42.0.17/24 brd 10.42.0.255 scope global eth0
          valid_lft forever preferred_lft forever
       inet6 fe80::858:aff:fe2a:11/64 scope link
          valid_lft forever preferred_lft forever
   3: net1@if23: <BROADCAST,MULTICAST,UP,LOWER_UP,M-DOWN> mtu 1500 qdisc noqueue
       link/ether 82:01:98:e5:0c:b7 brd ff:ff:ff:ff:ff:ff
       inet 10.10.0.20/24 brd 10.10.0.255 scope global net1 1
          valid_lft forever preferred_lft forever
       inet6 fe80::8001:98ff:fee5:cb7/64 scope link
          valid_lft forever preferred_lft forever

   1

   Pod 按预期附加到 net 1 接口上的 10.10.0.20 IP 地址。

6. 通过从 MicroShift 主机访问 pod 中的 HTTP 服务器来确认连接按预期工作。使用以下命令：

   $ curl 10.10.0.20:8080

   输出示例

   Hello MicroShift