23.7. Ajout d'un pod à un réseau supplémentaire SR-IOV

Procédure

1. Ajouter une annotation à l'objet Pod. Un seul des formats d'annotation suivants peut être utilisé :

   1. Pour attacher un réseau supplémentaire sans aucune personnalisation, ajoutez une annotation avec le format suivant. Remplacez <network> par le nom du réseau supplémentaire à associer au pod :

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

      1

      Pour spécifier plus d'un réseau supplémentaire, séparez chaque réseau par une virgule. N'incluez pas d'espace entre les virgules. Si vous spécifiez plusieurs fois le même réseau supplémentaire, plusieurs interfaces réseau seront attachées à ce pod.

   2. Pour joindre un réseau supplémentaire avec des personnalisations, ajoutez une annotation avec le format suivant :

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

      1

      Indiquer le nom du réseau supplémentaire défini par un objet NetworkAttachmentDefinition.

      2

      Spécifier l'espace de noms dans lequel l'objet NetworkAttachmentDefinition est défini.

      3

      Facultatif : Spécifiez un remplacement de l'itinéraire par défaut, tel que 192.168.17.1.

2. Pour créer le module, entrez la commande suivante. Remplacez <name> par le nom du module.

   $ oc create -f <name>.yaml

3. Facultatif : Pour confirmer que l'annotation existe dans le CR Pod, entrez la commande suivante, en remplaçant <name> par le nom du module.

   $ oc get pod <name> -o yaml

   Dans l'exemple suivant, le pod example-pod est rattaché au réseau supplémentaire net1:

   $ oc get pod example-pod -o yaml
   apiVersion: v1
   kind: Pod
   metadata:
     annotations:
       k8s.v1.cni.cncf.io/networks: macvlan-bridge
       k8s.v1.cni.cncf.io/networks-status: |- 1
         [{
             "name": "openshift-sdn",
             "interface": "eth0",
             "ips": [
                 "10.128.2.14"
             ],
             "default": true,
             "dns": {}
         },{
             "name": "macvlan-bridge",
             "interface": "net1",
             "ips": [
                 "20.2.2.100"
             ],
             "mac": "22:2f:60:a5:f8:00",
             "dns": {}
         }]
     name: example-pod
     namespace: default
   spec:
     ...
   status:
     ...

   1

   Le paramètre k8s.v1.cni.cncf.io/networks-status est un tableau JSON d'objets. Chaque objet décrit l'état d'un réseau supplémentaire attaché au pod. La valeur de l'annotation est stockée sous forme de texte brut.

Procédure

1. Créez la spécification de pod SR-IOV suivante, puis enregistrez le YAML dans le fichier <name>-sriov-pod.yaml. Remplacez <name> par un nom pour ce pod.

   L'exemple suivant montre une spécification de pod SR-IOV :

   apiVersion: v1
   kind: Pod
   metadata:
     name: sample-pod
     annotations:
       k8s.v1.cni.cncf.io/networks: <name> 1
   spec:
     containers:
     - name: sample-container
       image: <image> 2
       command: ["sleep", "infinity"]
       resources:
         limits:
           memory: "1Gi" 3
           cpu: "2" 4
         requests:
           memory: "1Gi"
           cpu: "2"

   1

   Remplacer <name> par le nom de la définition de l'attachement au réseau SR-IOV CR.

   2

   Remplacez <image> par le nom de l'image sample-pod.

   3

   Pour créer le pod SR-IOV avec une garantie de qualité de service, définissez memory limits égal à memory requests.

   4

   Pour créer le pod SR-IOV avec une qualité de service garantie, définissez cpu limits égal à cpu requests.

2. Créez l'exemple de pod SR-IOV en exécutant la commande suivante :

   $ oc create -f <filename> 1

   1

   Remplacez <filename> par le nom du fichier que vous avez créé à l'étape précédente.

3. Confirmez que le site sample-pod est configuré avec une qualité de service garantie.

   $ oc describe pod sample-pod

4. Confirmez que le site sample-pod est doté d'unités centrales exclusives.

   $ oc exec sample-pod -- cat /sys/fs/cgroup/cpuset/cpuset.cpus

5. Confirmez que le dispositif SR-IOV et les CPU alloués à l'adresse sample-pod se trouvent sur le même nœud NUMA.

   $ oc exec sample-pod -- cat /sys/fs/cgroup/cpuset/cpuset.cpus