다음을 통해 공유

Azure-VM-Utils 대해 알아보기

적용 대상: ✔️ Linux VM ✔️ 유연한 확장 집합

azure-vm-utils 패키지는 Azure Virtual Machines에서 Linux 환경을 최적화하기 위한 필수 유틸리티 및 udev 규칙을 제공합니다. 이 패키지는 SCSI(Small Computer System Interface), NVMe(비휘발성 메모리 익스프레스), MANA(Microsoft Azure 네트워크 어댑터) 및 Mellanox 디바이스용 디바이스 관리 도구를 통합하여 여러 VM 구성에서 디스크 식별 및 관리를 보다 안정적이고 일관되게 만듭니다.

NVMe udev 규칙

Azure의 최신 VM(가상 머신) SKU는 디스크 관리를 위해 NVMe 인터페이스를 사용합니다. NVMe 인터페이스가 있는 VM은 SCSI 인터페이스를 사용하는 VM과 다르게 디스크를 해석하고 표시합니다. 자세한 내용은 SCSI에서 NVMe로의 변환을 참조하세요.

이 패키지의 NVMe udev 규칙은 중요한 도구 및 udev 규칙을 통합하여 Azure 디스크에 대한 안정적이고 예측 가능한 symlink를 만듭니다. 이 패키지는 디스크를 식별하는 쉽고 안정적인 방법을 제공하여 자동화, 문제 해결 및 관리를 더 간단하게 만듭니다.

WALinuxAgent에는 현재 SCSI 디스크에 대한 몇 가지 symlink를 제공하는 udev 규칙이 포함되어 있습니다.

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

WALinuxAgent에 있는 규칙은 NVMe 디바이스에 대한 식별 지원을 추가하기 위해 azure-vm-utils로 확장되고 있습니다.

NVMe 디스크가 있는 모든 인스턴스에 대해 다음 symlink가 제공됩니다.

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

네임스페이스 식별자를 지원하는 로컬 NVMe 디스크가 있는 v6 이상 VM 크기의 경우 다음 링크도 사용할 수 있습니다.

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

SCSI 호환성

SCSI 컨트롤러를 사용하는 디스크에 대한 이전 버전과의 호환성을 보장하기 위해 azure-vm-utils는 다음 링크를 지원합니다.

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

비고

일부 VM 크기에는 SCSI 임시 디스크 외에도 NVMe 임시 디스크가 함께 제공됩니다.

Linux 배포 지원

다음 배포판 및 버전에는 현재 공식 Azure Marketplace 이미지에 az-vm-utils가 포함됩니다.

Distribution 버전
페도라 42
킨볼크 /플랫카 4152.2.3
Azure Linux 2.0
Canonical / Ubuntu 22.04, 24.04, 25.04

설치

패키지가 기본 플랫폼 이미지에 없는 경우 패키지 관리자 또는 GitHub 리포지토리를 통해 설치합니다.

수동 설치

azure-vm-utils가 사전 설치되지 않은 배포의 경우 수동으로 빌드하고 설치합니다.

# 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

Utilities

azure-nvme-id

이 유틸리티는 azure-nvme-id Azure NVMe 디바이스 및 해당 속성을 식별하는 데 도움이 됩니다. 이 유틸리티는 문제 해결 및 스크립팅에 유용합니다.

유틸리티를 실행하려면 다음을 수행합니다.

sudo azure-nvme-id

udev 모드에서 실행하려면(일반적으로 udev 규칙에서 사용):

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

azure-vm-utils가 설치되면 다시 부팅 간에 변경될 수 있는 디바이스 이름을 사용하는 대신 디스크 작업에 예측 가능한 symlink를 사용할 수 있습니다.

예시

모든 Azure 디스크 심볼릭 링크를 나열합니다.

find /dev/disk/azure/ -type l

OS 디스크에 액세스합니다.

ls -la /dev/disk/azure/os

LUN으로 데이터 디스크에 액세스:

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

일련 번호로 로컬 NVMe 디스크에 액세스합니다.

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

확인

azure-vm-utils가 VM에서 올바르게 작동하는지 확인하려면 다음을 수행합니다.

  1. 패키지가 설치되어 있는지 확인합니다.

    # For RPM-based systems
rpm -qa azure-vm-utils

# For DEB-based systems
dpkg -l azure-vm-utils

  2. udev 규칙이 제자리에 있는지 확인합니다.

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

  3. Azure 디스크의 심볼릭 링크를 확인합니다.

    find /dev/disk/azure -type l
  • Last updated on