Linux 가상 머신을 배포할 때 발생하는 문제 해결

적용 대상: ✔️ Linux VM

새 Azure Virtual Machine(VM)을 만드는 경우, 접하는 일반적인 오류는 프로비전 실패 또는 할당 실패입니다.

• 프로비전 실패는 포털에서 이미지를 캡처하는 동안 잘못된 설정을 선택했거나 준비 단계가 잘못되었기 때문에 OS 이미지가 로드되지 않아서 발생합니다.
• 할당 실패는 클러스터나 지역에 사용할 수 있는 리소스가 없거나 요청한 VM 크기를 지원할 수 없을 때 발생합니다.

Azure 문제와 관련된 정보가 이 문서에 없을 경우 MSDN 및 Stack Overflow에서 Azure 포럼을 방문합니다. 이러한 포럼이나 Twitter의 @AzureSupport에 문제를 게시할 수 있습니다. 또한 Azure 지원 요청을 제출할 수 있습니다. 지원 요청을 제출하려면 Azure 지원 페이지에서 지원 받기를 선택합니다.

증상

일반적인 프로비저닝 실패 시나리오는 사용자 지정 이미지를 만든 다음, VM에서 VM을 배포한 후 VM 상태가 표시되는 creating40분이 지나면 다음과 같은 오류 메시지가 표시됩니다.

Provisioning state Provisioning failed. 
OS Provisioning for VM 'sentilo' did not finish in the allotted time. 
The VM may still finish provisioning successfully. Please check provisioning state later. 
Also, make sure the image has been properly prepared (generalized). * Instructions for Windows: https://azure.microsoft.com/documentation/articles/virtual-machines-windows-upload-image/ * Instructions for Linux: https://azure.microsoft.com/documentation/articles/virtual-machines-linux-capture-image/.

또는

Deployment failed. Correlation ID: f9dcb33a-4e6e-45c5-9c9d-b29dd73da2e0. {
  "status": "Failed",
  "error": {
    "code": "ResourceDeploymentFailure",
    "message": "The resource operation completed with terminal provisioning state 'Failed'.",
    "details": [
      {
        "code": "OSProvisioningInternalError",
        "message": "OS Provisioning failed for VM 'iWishThisWouldCreateVM01' due to an internal error: The VM encountered an error during deployment. Please visit https://aka.ms/linuxprovisioningerror for more information on remediation."
      }
    ]
  }
}

그런 다음 VM 상태가 .로 표시된 것을 failed볼 수 있습니다.

프로비저닝 오류가 발생하는 이유는 무엇인가요?

일반적으로 프로비저닝 실패는 다음과 같은 여러 가지 이유로 발생할 수 있습니다.

• 프로비전 누락 /잘못 구성된 에이전트

  에이전트가 있고 올바르게 작동하는지 확인해야 합니다. cloud-init를 사용해야 하거나 이미지가 이를 지원하지 않는 경우 다음 단계를 검토할 수 있습니다.

• 잘못된 이미지 구성

  cloud-init 및 기타 Azure 이미지 요구 사항을 사용하여 이미지를 설정하는 방법에 대한 지침이 있습니다. 이를 확인하세요.

프로비전 실패 문제 해결

직렬 로그로 시작해야 하는 프로비저닝 실패 이유를 식별하려면 Azure Boot 진단을 사용하여 VM을 배포하여 사용할 수 있습니다.

직렬 로그의 프로비저닝 이벤트에 액세스하려면 실패한 이미지가 있는 VM에 대해 부팅 진단이 사용하도록 설정된 새 VM을 배포해야 합니다.

# create resource group
resourceGroup=myBrokenImageRG
location=westus2
az group create --name $resourceGroup --location $location
# create storage account
storageacct=mydiagdata$RANDOM
az storage account create \
  --resource-group $resourceGroup \
  --name $storageacct \
  --sku Standard_LRS \
  --location $location
# create VM
vmName=iWishThisWouldCreateVM01
brokenImageName=<ResourceID of brokenImage>
sshPubkeyPath=""
az vm create \
    --resource-group $resourceGroup \
    --name $vmName \
    --image $brokenImageName \
    --admin-username azadmin \
    --ssh-key-value $sshPubkeyPath \
    --boot-diagnostics-storage $storageacct

직렬 로그를 보려면 포털로 이동하거나 아래 명령을 실행하여 serialConsoleLogBlobUri 로그를 다운로드할 수 있습니다.

az vm boot-diagnostics get-boot-log-uris --name $vmName --resource-group $resourceGroup

시스템 이벤트 및 프로비전 이벤트에 대한 직렬 로그 이해

VM이 처음으로 만들어지면 cloud-init가 시작되어 ISO를 탑재하고, 네트워크 연결을 설정하고, VM을 만드는 동안 전달된 속성을 설정하고, 사용 후 삭제 디스크(지원되는 VM 크기)를 탑재하고, 초기 OS 구성이 완료되었음을 Azure 플랫폼에 다시 알릴 수 있습니다.

일반 오류

비활성화된 UDF 모듈

직렬 로그에서 오류 :

[   10.855501] cloud-init[732]: Cloud-init v. 20.4.1-0ubuntu1~18.04.1 running 'init-local' at Thu, 28 Jan 2021 23:43:02 +0000. Up 10.68 seconds.
[   10.869581] cloud-init[732]: 2021-01-28 23:43:03,097 - azure.py[WARNING]: /dev/sr0 was not mountable
[   10.875608] cloud-init[732]: 2021-01-28 23:43:03,106 - azure.py[ERROR]: No Azure metadata found
[   10.885776] cloud-init[732]: 2021-01-28 23:43:03,107 - azure.py[ERROR]: Could not crawl Azure metadata: No Azure metadata found
[   14.634117] cloud-init[732]: 2021-01-28 23:43:06,876 - azure.py[WARNING]: Reported failure to Azure fabric.

waagent.log 오류:

"UDF driver Blocklisted 2020/09/11 19:16:40.240016 ERROR Daemon Provisioning failed: [ProtocolError] [CopyOvfEnv] Error mounting dvd: [OSUtilError] Failed to mount dvd deviceInner error: [mount -o ro -t udf,iso9660 /dev/sr0 /mnt/cdrom/secure] returned 32: mount: /mnt/cdrom/secure: wrong fs type, bad option, bad superblock on /dev/sr0, missing codepage or helper program, or other error."

원인: UDF 드라이버가 커널에 로드되지 않습니다. VM이 프로비전하는 데 필요합니다. 이미지 요구 사항을 참조 하세요.

Azure에서 VM을 처음 프로비전하면 Azure 호스트는 VM에 'cdrom iso 디스크 프로비전'을 제공합니다. 이 프로비저닝 디스크는 일반적으로 /dev/sr0을 통해 VM에 표시됩니다. 프로비저닝 디스크 내에는 VM의 프로비저닝 정보가 포함된 프로비저닝 매니페스트가 있습니다. VM 내 프로비저닝 에이전트는 프로비전 디스크를 탑재하고, 프로비전 매니페스트를 읽고, 그에 따라 VM을 프로비전해야 합니다.

프로비저닝 디스크는 커 cdrom iso disk널에 필요하므로 이 디스크를 성공적으로 탑재하려면 Linux UDF 드라이버가 필요합니다. Linux 이미지에 대한 Microsoft 설명서에서 참조됩니다. 이 VM의 경우 로그는 프로비전 디스크가 탑재되지 못하여 VM 프로비저닝이 실패했음을 나타냅니다. 가장 가능성이 큰 이유는 UDF 드라이버가 없거나 차단되어 있기 때문입니다.

해결 방법: UDF 드라이버가 커널에 로드되도록 구성되어 있는지 확인합니다.

UDF 드라이버를 차단하는 일반적인 방법은 내 /etc/modprobe.d/구성을 사용하는 것입니다. 고객/이미지 소유자와 협력하여 Linux UDF 드라이버가 있고 차단되지 않았는지 확인하세요. 커널 드라이버 차단/차단 해제에 대한 이 문서를 참조하세요.

VM 태그의 유니코드 문자 문제

cloud-init.log 오류:

  File "/usr/lib/python2.7/site-packages/cloudinit/sources/DataSourceAzure.py", line 1316, in _get_metadata_from_imds
    except json.decoder.JSONDecodeError:
AttributeError: 'module' object has no attribute 'JSONDecodeError'

원인: VM 태그에는 비 ascii 문자가 있고 cloud-init 버전이 20.3보다 오래되었기 때문에 발생합니다.

해결 방법: 이미지가 cloud-init 20.3 이하를 사용하거나 지원하는지 확인하거나 VM 태그에서 비 ascii 문자를 제거합니다.

유니코드 문자가 있는 암호

cloud-init.log 오류:

File "/usr/lib/python2.7/site-packages/cloudinit/sources/DataSourceAzure.py", line 1153, in encrypt_pass
    return crypt.crypt(password, salt_id + util.rand_str(strlen=16))
  File "/usr/lib64/python2.7/crypt.py", line 55, in crypt
    return _crypt.crypt(word, salt)
UnicodeEncodeError: 'ascii' codec can't encode characters in position 10-11: ordinal not in range(128)

원인: 제공된 암호에 지원되지 않는 문자(비 ascii)가 있기 때문에 발생합니다.

해결 방법: ascii 문자만 있는 암호를 제공합니다.

Dhclient 권한

cloud-init.log 오류 :

Command: ['/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhclient', '-1', '-v', '-lf', '/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhcp.leases', '-pf', '/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhclient.pid', 'eth0', '-sf', '/bin/true']
Exit code: -
Reason: [Errno 13] Permission denied: b'/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhclient'

원인: 이전 버전의 cloud-init(버전 20.3 이전)는 내에서 /var/tmp복사하고 실행하여 DHCP를 dhclient 수행합니다. VM에 의해 실행이 없는 것으로 noexec 탑재된 경우 /var/tmp DHCP는 내에서 /var/tmp실행할 수 있는 권한이 없기 때문에 dhclient 실패합니다.

Cloud-init 버전 >= 20.3에는 사용 권한 문제가 있는 경우 복사하여 실행 /var/tmp 하지 않고 "있는 그대로" 실행하는 dhclient 수정 사항이 포함되어 있습니다.

해결 방법: 버전 20.3보다 오래된 cloud-init를 실행하는 VM의 경우 탑재되지 않도록 /var/tmp VM을 noexec구성합니다. 또는 VM의 cloud-init 패키지를 버전 >= 20.3으로 업그레이드합니다.

더 많은 로그 가져오기

문제를 이해하기 위해 VM에서 더 많은 로그가 필요한 경우 이미지에 구운 사용자를 사용하여 직렬 콘솔을 사용하여 VM에 SSH할 수 있습니다. 구운 사용자가 없는 경우 사용자와 함께 이미지를 다시 만들거나 프로비전에 실패한 VM의 OS 디스크를 다른 VM에 탑재하는 AZ VM 복구 도구를 사용할 수 있습니다.

az vm repair create  \
    --resource-group $resourceGroup \
    --name $vmName \
    --repair-username repairadm \
    --repair-password AnotherPassword123! \
    --repair-vm-name repairVM \
    --verbose

cloud-init.log 이해

cloud-init 로그에 액세스할 수 있는 경우 cloud-init 문제 해결 설명서를 검토 합니다.

활동 로그 수집

문제 해결을 시작하려면 활동 로그를 수집하여 문제와 관련된 오류를 식별합니다. 다음 링크에는 수행할 프로세스에 대한 자세한 내용이 포함되어 있습니다.

배포 작업 보기

활동 로그를 보고 Azure 리소스 관리

지원 받기

지침을 참조했으며 여전히 문제를 해결할 수 없는 경우 지원 사례를 열 수 있습니다. 이렇게 할 때 올바른 제품 및 지원 항목을 선택하세요. 이렇게 하면 올바른 지원 팀이 참여합니다.

사례 제품 선택:

Product Family: Azure
Product: Virtual Machine Running (Window\Linux)
Support Topic: <COMPLETE>
Support Subtopic: <COMPLETE>

도움을 요청하십시오.

질문이 있거나 도움이 필요한 경우 지원 요청을 생성하거나Azure 커뮤니티 지원에 문의하세요. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.