10.21. Mise en réseau de machines virtuelles

Procédure

1. Modifiez la spécification interfaces du fichier de configuration de votre machine virtuelle :

   kind: VirtualMachine
   spec:
     domain:
       devices:
         interfaces:
           - name: default
             masquerade: {} 1
             ports: 2
               - port: 80
     networks:
     - name: default
       pod: {}

   1

   Se connecter en utilisant le mode mascarade.

   2

   Facultatif : Listez les ports que vous souhaitez exposer à partir de la machine virtuelle, chacun étant spécifié par le champ port. La valeur port doit être un nombre compris entre 0 et 65536. Lorsque le tableau ports n'est pas utilisé, tous les ports de la plage valide sont ouverts au trafic entrant. Dans cet exemple, le trafic entrant est autorisé sur le port 80.

   Note

   Les ports 49152 et 49153 sont réservés à l'usage de la plateforme libvirt et tout autre trafic entrant vers ces ports est supprimé.

2. Créer la machine virtuelle :

   $ oc create -f <vm-name>.yaml

Procédure

1. Dans une nouvelle configuration de machine virtuelle, incluez une interface avec masquerade et configurez l'adresse IPv6 et la passerelle par défaut à l'aide de cloud-init.

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: example-vm-ipv6
   ...
             interfaces:
               - name: default
                 masquerade: {} 1
                 ports:
                   - port: 80 2
         networks:
         - name: default
           pod: {}
         volumes:
         - cloudInitNoCloud:
             networkData: |
               version: 2
               ethernets:
                 eth0:
                   dhcp4: true
                   addresses: [ fd10:0:2::2/120 ] 3
                   gateway6: fd10:0:2::1 4

   1

   Se connecter en utilisant le mode mascarade.

   2

   Autorise le trafic entrant sur le port 80 vers la machine virtuelle.

   3

   L'adresse IPv6 statique déterminée par le champ Network.pod.vmIPv6NetworkCIDR dans la configuration de l'instance de la machine virtuelle. La valeur par défaut est fd10:0:2::2/120.

   4

   L'adresse IP de la passerelle déterminée par le champ Network.pod.vmIPv6NetworkCIDR dans la configuration de l'instance de la machine virtuelle. La valeur par défaut est fd10:0:2::1.

2. Créer la machine virtuelle dans l'espace de noms :

   $ oc create -f example-vm-ipv6.yaml

Procédure

1. Modifiez le manifeste VirtualMachine pour ajouter l'étiquette de création de service :

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: vm-ephemeral
     namespace: example-namespace
   spec:
     running: false
     template:
       metadata:
         labels:
           special: key 1
   # ...

   1

   Ajouter le libellé special: key dans la section spec.template.metadata.labels.

   Note

   Les étiquettes d'une machine virtuelle sont transmises au pod. L'étiquette special: key doit correspondre à l'étiquette de l'attribut spec.selector du manifeste Service.

2. Enregistrez le fichier manifeste VirtualMachine pour appliquer vos modifications.

3. Créez un manifeste Service pour exposer la VM :

   apiVersion: v1
   kind: Service
   metadata:
     name: vmservice 1
     namespace: example-namespace 2
   spec:
     externalTrafficPolicy: Cluster 3
     ports:
     - nodePort: 30000 4
       port: 27017
       protocol: TCP
       targetPort: 22 5
     selector:
       special: key 6
     type: NodePort 7

   1

   Le nom de l'objet Service.

   2

   L'espace de noms dans lequel réside l'objet Service. Il doit correspondre au champ metadata.namespace du manifeste VirtualMachine.

   3

   Facultatif : Spécifie comment les nœuds distribuent le trafic de service reçu sur des adresses IP externes. Cette option ne s'applique qu'aux types de service NodePort et LoadBalancer. La valeur par défaut est Cluster, ce qui permet d'acheminer le trafic de manière uniforme vers tous les points d'extrémité du cluster.

   4

   Facultatif : Lorsqu'elle est définie, la valeur nodePort doit être unique pour tous les services. Si elle n'est pas spécifiée, une valeur comprise dans la plage supérieure à 30000 est attribuée dynamiquement.

   5

   Facultatif : Le port VM à exposer par le service. Il doit faire référence à un port ouvert si une liste de ports est définie dans le manifeste VM. Si targetPort n'est pas spécifié, il prend la même valeur que port.

   6

   La référence à l'étiquette que vous avez ajoutée dans la strophe spec.template.metadata.labels du manifeste VirtualMachine.

   7

   Le type de service. Les valeurs possibles sont ClusterIP, NodePort et LoadBalancer.

4. Enregistrez le fichier manifeste Service.

5. Créez le service en exécutant la commande suivante :

   oc create -f <service_name>.yaml

6. Démarrez la VM. Si la VM est déjà en cours d'exécution, redémarrez-la.

Vérification

1. Interroger l'objet Service pour vérifier qu'il est disponible :

   $ oc get service -n example-namespace

   Exemple de sortie pour le service ClusterIP

   NAME        TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)     AGE
   vmservice   ClusterIP   172.30.3.149   <none>        27017/TCP   2m

   Exemple de sortie pour le service NodePort

   NAME        TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)            AGE
   vmservice   NodePort    172.30.232.73   <none>       27017:30000/TCP    5m

   Exemple de sortie pour le service LoadBalancer

   NAME        TYPE            CLUSTER-IP     EXTERNAL-IP                    PORT(S)           AGE
   vmservice   LoadBalancer    172.30.27.5   172.29.10.235,172.29.10.235     27017:31829/TCP   5s

2. Choisissez la méthode appropriée pour vous connecter à la machine virtuelle :

   • Pour un service ClusterIP, connectez-vous à la VM depuis le cluster en utilisant l'adresse IP et le port du service. Par exemple, vous pouvez vous connecter à l'adresse IP et au port du service :

     $ ssh fedora@172.30.3.149 -p 27017

   • Pour un service NodePort, connectez-vous à la VM en spécifiant l'adresse IP du nœud et le port du nœud en dehors du réseau du cluster. Par exemple, l'adresse IP du nœud et le port du nœud se trouvent en dehors du réseau du cluster :

     $ ssh fedora@$NODE_IP -p 30000

   • Pour un service LoadBalancer, utilisez le client vinagre pour vous connecter à votre machine virtuelle en utilisant l'adresse IP et le port publics. Les ports externes sont alloués dynamiquement.

Procédure

1. Créez un objet SriovNetworkNodePolicy, puis enregistrez le YAML dans le fichier <name>-sriov-node-network.yaml. Remplacez <name> par le nom de cette configuration.

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetworkNodePolicy
   metadata:
     name: <name> 1
     namespace: openshift-sriov-network-operator 2
   spec:
     resourceName: <sriov_resource_name> 3
     nodeSelector:
       feature.node.kubernetes.io/network-sriov.capable: "true" 4
     priority: <priority> 5
     mtu: <mtu> 6
     numVfs: <num> 7
     nicSelector: 8
       vendor: "<vendor_code>" 9
       deviceID: "<device_id>" 10
       pfNames: ["<pf_name>", ...] 11
       rootDevices: ["<pci_bus_id>", "..."] 12
     deviceType: vfio-pci 13
     isRdma: false 14

   1

   Spécifiez un nom pour l'objet CR.

   2

   Indiquer l'espace de noms dans lequel l'opérateur SR-IOV est installé.

   3

   Indiquez le nom de la ressource du plugin de périphérique SR-IOV. Vous pouvez créer plusieurs objets SriovNetworkNodePolicy pour un nom de ressource.

   4

   Spécifiez le sélecteur de nœuds pour sélectionner les nœuds à configurer. Seuls les périphériques réseau SR-IOV des nœuds sélectionnés sont configurés. Le plugin SR-IOV Container Network Interface (CNI) et le plugin de périphérique sont déployés uniquement sur les nœuds sélectionnés.

   5

   Facultatif : Indiquez une valeur entière comprise entre 0 et 99. Un nombre plus petit a une priorité plus élevée, donc une priorité de 10 est plus élevée qu'une priorité de 99. La valeur par défaut est 99.

   6

   Facultatif : Spécifiez une valeur pour l'unité de transmission maximale (MTU) de la fonction virtuelle. La valeur maximale du MTU peut varier selon les modèles de NIC.

   7

   Indiquez le nombre de fonctions virtuelles (VF) à créer pour le périphérique de réseau physique SR-IOV. Pour un contrôleur d'interface réseau (NIC) Intel, le nombre de VF ne peut pas être supérieur au nombre total de VF pris en charge par le périphérique. Pour un NIC Mellanox, le nombre de VF ne peut pas être supérieur à 128.

   8

   Le mappage nicSelector sélectionne l'appareil Ethernet que l'opérateur doit configurer. Il n'est pas nécessaire de spécifier des valeurs pour tous les paramètres. Il est recommandé d'identifier l'adaptateur Ethernet avec suffisamment de précision pour minimiser la possibilité de sélectionner un périphérique Ethernet par inadvertance. Si vous spécifiez rootDevices, vous devez également spécifier une valeur pour vendor, deviceID ou pfNames. Si vous spécifiez pfNames et rootDevices en même temps, assurez-vous qu'ils pointent vers un périphérique identique.

   9

   Facultatif : Indiquez le code hexadécimal du fournisseur de l'appareil réseau SR-IOV. Les seules valeurs autorisées sont 8086 ou 15b3.

   10

   Facultatif : Indiquez le code hexadécimal du périphérique du réseau SR-IOV. Les seules valeurs autorisées sont 158b, 1015, 1017.

   11

   Facultatif : Ce paramètre accepte un tableau d'un ou plusieurs noms de fonctions physiques (PF) pour le périphérique Ethernet.

   12

   Ce paramètre accepte un tableau d'une ou plusieurs adresses de bus PCI pour la fonction physique du périphérique Ethernet. Indiquez l'adresse au format suivant : 0000:02:00.1.

   13

   Le type de pilote vfio-pci est requis pour les fonctions virtuelles dans OpenShift Virtualization.

   14

   Facultatif : Indiquez si le mode RDMA (remote direct memory access) doit être activé. Pour une carte Mellanox, définissez isRdma sur false. La valeur par défaut est false.

   Note

   Si l'indicateur isRDMA est défini sur true, vous pouvez continuer à utiliser le VF compatible RDMA comme un périphérique réseau normal. Un périphérique peut être utilisé dans l'un ou l'autre mode.

2. Facultatif : Étiqueter les nœuds de cluster compatibles SR-IOV avec SriovNetworkNodePolicy.Spec.NodeSelector s'ils ne le sont pas déjà. Pour plus d'informations sur l'étiquetage des nœuds, voir "Understanding how to update labels on nodes".

3. Créer l'objet SriovNetworkNodePolicy:

   oc create -f <name>-sriov-node-network.yaml

   où <name> spécifie le nom de cette configuration.

   Après l'application de la mise à jour de la configuration, tous les pods de l'espace de noms sriov-network-operator passent à l'état Running.

4. Pour vérifier que le dispositif de réseau SR-IOV est configuré, entrez la commande suivante. Remplacez <node_name> par le nom d'un nœud avec le dispositif de réseau SR-IOV que vous venez de configurer.

   oc get sriovnetworknodestates -n openshift-sriov-network-operator <node_name> -o jsonpath='{.status.syncStatus}'

Procédure

1. Créez l'objet SriovNetwork suivant, puis enregistrez le YAML dans le fichier <name>-sriov-network.yaml. Remplacez <name> par un nom pour ce réseau supplémentaire.

2. Pour créer l'objet, entrez la commande suivante. Remplacez <name> par un nom pour ce réseau supplémentaire.

   oc create -f <name>-sriov-network.yaml

3. Facultatif : Pour confirmer que l'objet NetworkAttachmentDefinition associé à l'objet SriovNetwork que vous avez créé à l'étape précédente existe, entrez la commande suivante. Remplacez <namespace> par l'espace de noms que vous avez spécifié dans l'objet SriovNetwork.

   oc get net-attach-def -n <namespace>

Procédure

1. Inclure les détails du réseau SR-IOV dans les pages spec.domain.devices.interfaces et spec.networks de la configuration de la VM :

   kind: VirtualMachine
   ...
   spec:
     domain:
       devices:
         interfaces:
         - name: <default> 1
           masquerade: {} 2
         - name: <nic1> 3
           sriov: {}
     networks:
     - name: <default> 4
       pod: {}
     - name: <nic1> 5
       multus:
           networkName: <sriov-network> 6
   ...

   1

   Un nom unique pour l'interface qui est connectée au réseau de pods.

   2

   La liaison masquerade au réseau de pods par défaut.

   3

   Un nom unique pour l'interface SR-IOV.

   4

   Le nom de l'interface réseau du pod. Ce nom doit être identique à celui de interfaces.name que vous avez défini précédemment.

   5

   Le nom de l'interface SR-IOV. Il doit être identique au nom interfaces.name que vous avez défini précédemment.

   6

   Le nom de la définition de l'attachement au réseau SR-IOV.

2. Appliquer la configuration de la machine virtuelle :

   oc apply -f <vm-sriov.yaml> 1

   1

   Le nom du fichier YAML de la machine virtuelle.

Procédure

1. Modifiez le fichier de configuration de la VM pour ajouter l'annotation sidecar.istio.io/inject: "true".

   Exemple de fichier de configuration

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     labels:
       kubevirt.io/vm: vm-istio
     name: vm-istio
   spec:
     runStrategy: Always
     template:
       metadata:
         labels:
           kubevirt.io/vm: vm-istio
           app: vm-istio 1
         annotations:
           sidecar.istio.io/inject: "true" 2
       spec:
         domain:
           devices:
             interfaces:
             - name: default
               masquerade: {} 3
             disks:
             - disk:
                 bus: virtio
               name: containerdisk
             - disk:
                 bus: virtio
               name: cloudinitdisk
           resources:
             requests:
               memory: 1024M
         networks:
         - name: default
           pod: {}
         terminationGracePeriodSeconds: 180
         volumes:
         - containerDisk:
             image: registry:5000/kubevirt/fedora-cloud-container-disk-demo:devel
           name: containerdisk

   1

   La paire clé/valeur (étiquette) qui doit être associée à l'attribut du sélecteur de service.

   2

   L'annotation permettant d'activer l'injection automatique de sidecar.

   3

   La méthode de liaison (mode masqué) à utiliser avec le réseau de pods par défaut.

2. Appliquer la configuration de la VM :

   oc apply -f <vm_name>.yaml 1

   1

   Le nom du fichier YAML de la machine virtuelle.

3. Créez un objet Service pour exposer votre VM au réseau de services.

     apiVersion: v1
     kind: Service
     metadata:
       name: vm-istio
     spec:
       selector:
         app: vm-istio 1
       ports:
         - port: 8080
           name: http
           protocol: TCP

   1

   Le sélecteur de service qui détermine l'ensemble des pods ciblés par un service. Cet attribut correspond au champ spec.metadata.labels dans le fichier de configuration de la VM. Dans l'exemple ci-dessus, l'objet Service nommé vm-istio cible le port TCP 8080 sur n'importe quel module portant l'étiquette app=vm-istio.

4. Créer le service :

   oc create -f <service_name>.yaml 1

   1

   Le nom du fichier YAML du service.

Procédure

1. Dans la console OpenShift Container Platform, cliquez sur Virtualization VirtualMachines dans le menu latéral.
2. Sélectionnez un nom de machine virtuelle pour ouvrir la page VirtualMachine details.