Meer informatie over Azure-VM-Utils

Van toepassing op: ✔️ Flexibele schaalsets voor Linux-VM's ✔️

Het pakket azure-vm-utils biedt essentiële hulpprogramma's en udev-regels om de Linux-ervaring op virtuele Azure-machines te optimaliseren. Dit pakket consolideert hulpprogramma's voor apparaatbeheer voor Small Computer System Interface (SCSI), Non-Volatile Memory Express (NVMe), Microsoft Azure Network Adapter (MANA) en Mellanox-apparaten, waardoor schijfidentificatie en -beheer betrouwbaarder en consistenter zijn in verschillende VM-configuraties.

NVMe udev-regels

Nieuwere VIRTUELE machines (VM's) SKU's in Azure gebruiken de NVMe-interface voor schijfbeheer. VM's met NVMe-interfaces interpreteren en presenteren schijven anders dan vm's die gebruikmaken van SCSI-interfaces. Zie SCSI naar NVMe-conversie voor meer informatie.

NVMe udev-regels in dit pakket consolideren essentiële hulpprogramma's en udev-regels om stabiele, voorspelbare symlinks voor Azure-schijven te maken. Dit pakket biedt een eenvoudige en betrouwbare manier om schijven te identificeren, automatisering, probleemoplossing en beheer eenvoudiger te maken.

WALinuxAgent bevat momenteel udev-regels om verschillende symlinks te bieden voor SCSI-schijven:

  • /dev/disk/azure/resource
  • /dev/disk/azure/root
  • /dev/disk/azure/scsi0/lun<lun>
  • /dev/disk/azure/scsi1/lun<lun>

De regels in WALinuxAgent worden uitgebreid met azure-vm-utils om identificatieondersteuning voor NVMe-apparaten toe te voegen.

De volgende symlinks zijn beschikbaar voor alle exemplaren met NVMe-schijven:

  • /dev/disk/azure/data/by-lun/<lun>
  • /dev/disk/azure/local/by-serial/<serial>
  • /dev/disk/azure/os

Voor v6- en nieuwere VM-grootten met lokale NVMe-schijven die ondersteuning bieden voor naamruimte-id's, zijn ook de volgende koppelingen beschikbaar:

  • /dev/disk/azure/local/by-index/<index>
  • /dev/disk/azure/local/by-name/<name>

SCSI-compatibiliteit

Om compatibiliteit met eerdere versies voor schijven met behulp van SCSI-controllers te garanderen, ondersteunt azure-vm-utils de volgende koppelingen:

  • /dev/disk/azure/os
  • /dev/disk/azure/resource

Opmerking

Sommige VM-grootten worden geleverd met zowel een tijdelijke NVMe-schijf als een tijdelijke SCSI-schijf.

Ondersteuning voor Linux-distributie

De volgende distributies en versies bevatten momenteel az-vm-utils in hun officiële Azure Marketplace-installatiekopieën:

Distributie Versie
Alma Linux 9.8 en hoger
Azure Linux 4.0
Canonical / Ubuntu 22.04 en hoger
Debian 13
Kinvolk / Flatcar 4152.2.3
Oracle Linux 9.8 en hoger
Red Hat 9.8 en hoger
Rocky Linux 9.8 en hoger
SUSE Enterprise Linux 15 SP5 en hoger

Installatie

Als het pakket niet aanwezig is in de standaardinstallatiekopieën van het platform, installeert u het via pakketbeheerders of vanuit de GitHub-opslagplaats.

Handmatige installatie

Voor distributies waarbij azure-vm-utils niet vooraf is geïnstalleerd, bouwt en installeert u deze handmatig:

# 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

Nutsvoorzieningen

azure-nvme-id

Het azure-nvme-id hulpprogramma helpt bij het identificeren van Azure NVMe-apparaten en hun eigenschappen. Dit hulpprogramma is handig voor het oplossen van problemen en het uitvoeren van scripts.

Ga als volgende te werk om het hulpprogramma uit te voeren:

sudo azure-nvme-id

Uitvoeren in udev-modus (meestal gebruikt door udev-regels):

DEVNAME=/dev/nvme0n1 azure-nvme-id --udev

Nadat azure-vm-utils is geïnstalleerd, kunt u de voorspelbare symlinks gebruiken voor schijfbewerkingen in plaats van te vertrouwen op apparaatnamen die tussen opnieuw opstarten kunnen veranderen.

Voorbeelden

Alle Azure-schijfsymlinks weergeven:

find /dev/disk/azure/ -type l

Toegang tot de besturingssysteemschijf:

ls -la /dev/disk/azure/os

Toegang tot gegevensschijven per LUN:

ls -la /dev/disk/azure/data/by-lun/

Toegang tot lokale NVMe-schijven op serienummer:

ls -la /dev/disk/azure/local/by-serial/

Verification

Ga als volgt te werk om te controleren of azure-vm-utils correct werkt op uw VM:

  1. Controleer of het pakket is geïnstalleerd:

    # For RPM-based systems
    rpm -qa azure-vm-utils
    
    # For DEB-based systems
    dpkg -l azure-vm-utils
    
  2. Controleer of udev-regels zijn ingesteld:

    ls -al /usr/lib/udev/rules.d/10-azure-unmanaged-sriov.rules
    ls -al /usr/lib/udev/rules.d/80-azure-disk.rules
    
  3. Controleer Azure schijfkoppelpunten.

    find /dev/disk/azure -type l