Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : ✔️ Machines virtuelles Linux ✔️ Ensembles de mise à l'échelle flexibles
Le package azure-vm-utils fournit des utilitaires et des règles udev essentiels pour optimiser l’expérience Linux sur les machines virtuelles Azure. Ce package consolide les outils de gestion des appareils pour small computer system Interface (SCSI), NVMe (Non volatile Memory Express), Microsoft Azure Network Adapter (MANA) et les appareils Mellanox, ce qui rend l’identification et la gestion des disques plus fiables et cohérentes dans différentes configurations de machine virtuelle.
Règles udev NVMe
Les références SKU de machines virtuelles plus récentes sur Azure utilisent l’interface NVMe pour la gestion des disques. Les machines virtuelles avec des interfaces NVMe interprètent et présentent des disques différemment des machines virtuelles qui utilisent des interfaces SCSI. Pour plus d’informations, consultez la conversion SCSI vers NVMe.
Les règles udev NVMe de ce package consolident les outils critiques et les règles udev afin de créer des liens symboliques stables et prévisibles pour les disques Azure. Ce package offre un moyen simple et fiable d’identifier les disques, ce qui simplifie l’automatisation, la résolution des problèmes et la gestion.
Symlinks
WALinuxAgent inclut actuellement des règles udev afin de fournir plusieurs liens symboliques pour les disques SCSI :
/dev/disk/azure/resource/dev/disk/azure/root/dev/disk/azure/scsi0/lun<lun>/dev/disk/azure/scsi1/lun<lun>
Les règles trouvées dans WALinuxAgent sont étendues avec azure-vm-utils pour ajouter la prise en charge de l’identification pour les appareils NVMe.
Les liens symboliques suivants sont fournis pour toutes les instances avec des disques NVMe :
/dev/disk/azure/data/by-lun/<lun>/dev/disk/azure/local/by-serial/<serial>/dev/disk/azure/os
Pour les dimensions v6 et versions ultérieures de machines virtuelles équipées de disques NVMe locaux prenant en charge les identificateurs d’espaces de noms, les liens suivants sont également disponibles :
/dev/disk/azure/local/by-index/<index>/dev/disk/azure/local/by-name/<name>
Compatibilité SCSI
Pour garantir la compatibilité rétroactive des disques utilisant des contrôleurs SCSI, azure-vm-utils prend en charge les liens suivants :
/dev/disk/azure/os/dev/disk/azure/resource
Note
Certaines tailles de machine virtuelle sont fournies avec un disque temporaire NVMe en plus d’un disque temporaire SCSI.
Prise en charge de la distribution Linux
Les distributions et versions suivantes incluent actuellement az-vm-utils dans leurs images officielles de la Place de marché Azure :
| Répartition | Version |
|---|---|
| Fedora | 42 |
| Kinvolk / Flatcar | 4152.2.3 |
| Linux Azure | 2.0 |
| Canonical / Ubuntu | 22.04, 24.04, 25.04 |
Installation
Si le package n’est pas présent dans l’image de plateforme par défaut, installez-le via des gestionnaires de package ou à partir du dépôt GitHub.
Installation manuelle
Pour les distributions où azure-vm-utils n’est pas préinstallé, générez et installez-le manuellement :
# Clone the repository
git clone https://github.com/Azure/azure-vm-utils.git
cd azure-vm-utils
# Build the package
cmake .
make
# Install (requires root privileges)
sudo make install
Services publics
azure-nvme-id
L’utilitaire azure-nvme-id permet d’identifier les appareils NVMe Azure et leurs propriétés. Cet utilitaire est utile pour la résolution des problèmes et les scripts.
Pour exécuter l’utilitaire :
sudo azure-nvme-id
Pour s’exécuter en mode udev (généralement utilisé par les règles udev) :
DEVNAME=/dev/nvme0n1 azure-nvme-id --udev
Utilisation des liens symboliques
Une fois azure-vm-utils installé, vous pouvez utiliser les liens symboliques prévisibles pour les opérations de disque au lieu de compter sur les noms d’appareils susceptibles de changer entre les redémarrages.
Examples
Répertorier tous les liens symboliques de disques Azure :
find /dev/disk/azure/ -type l
Accédez au disque du système d’exploitation :
ls -la /dev/disk/azure/os
Accéder aux disques de données par LUN :
ls -la /dev/disk/azure/data/by-lun/
Accédez aux disques NVMe locaux par numéro de série :
ls -la /dev/disk/azure/local/by-serial/
Vérification
Pour vérifier que azure-vm-utils fonctionne correctement sur votre machine virtuelle :
Vérifiez si le package est installé :
# For RPM-based systems rpm -qa azure-vm-utils # For DEB-based systems dpkg -l azure-vm-utilsVérifiez que les règles udev sont en place :
ls -al /usr/lib/udev/rules.d/10-azure-unmanaged-sriov.rules ls -al /usr/lib/udev/rules.d/80-azure-disk.rulesVérifier les liens symboliques de disques Azure :
find /dev/disk/azure -type l