Azure Virtual Desktop에서 사용자 지정 이미지 템플릿 문제 해결
Azure Virtual Desktop의 사용자 지정 이미지 템플릿을 사용하면 세션 호스트 VM(가상 머신)을 배포할 때 사용할 수 있는 사용자 지정 이미지를 쉽게 만들 수 있습니다. 이 문서는 발생할 수 있는 몇 가지 문제를 해결하는 데 도움이 됩니다.
이미지를 만들 때의 일반적인 문제 해결
Azure Image Builder는 Hashicorp Packer를 사용하여 이미지를 만듭니다. Packer는 모든 로그 항목을 customization.log라는 파일로 출력합니다. 기본적으로 이 파일은 Azure Image Builder가 명명 규칙을 IT_<ResourceGroupName>_<TemplateName>_<GUID>사용하여 자동으로 만든 리소스 그룹에 있습니다. 템플릿 만들기 단계에서 고유한 이름을 지정하여 이 이름을 재정의할 수 있습니다.
이 리소스 그룹에는 packerlogs라는 Blob 컨테이너가 있는 스토리지 계정이 있습니다. 컨테이너에는 로그 파일을 찾을 수 있는 GUID가 있는 폴더가 있습니다. 이미지를 사용자 지정하는 데 사용하는 기본 제공 스크립트의 항목은 Starting AVD AIB Customization: {<Script name>}: {<Timestamp>}스크립트와 관련된 오류를 찾는 데 도움이 됩니다.
Azure Image Builder 로그를 해석하는 방법에 대한 자세한 내용은 Azure VM Image Builder 문제 해결을 참조 하세요.
Important
Microsoft 지원 고객이 만든 스크립트 또는 Microsoft 리포지토리에서 복사하여 수정한 스크립트 또는 템플릿에 대한 문제를 처리하지 않습니다. 문제를 열 수 있는 GitHub 리포지토리에서 이러한 도구를 공동 작업하고 개선할 수 있습니다. 자세한 내용은 고객 또는 타사 스크립트를 지원하지 않는 이유를 참조 하세요.
리소스 그룹은 비어 있어야 합니다.
Azure Image Builder에서 사용할 고유한 리소스 그룹을 지정하는 경우 이미지 빌드가 시작되기 전에 비어 있어야 합니다. 즉, 이 목적을 위해 기존 리소스 그룹을 다시 사용하려는 경우 그 안에 있는 모든 리소스만 삭제하면 됩니다. 또는 이러한 항목을 유지해야 하는 경우 템플릿 만들기의 빌드 속성 탭에서 다른 새 리소스 그룹을 지정할 수 있습니다.
스크립트를 사용할 수 없음
다음 메시지가 표시되면:
리소스 <URI> 를 사용할 수 없습니다. 파일이 있고 Image Builder에서 액세스할 수 있는지 확인하세요.
스크립트에 대한 URI(Uniform Resource Identifier)를 확인합니다. GitHub 또는 웹 서비스와 같이 공개적으로 사용 가능한 위치여야 합니다.
Azure Compute Gallery VM 이미지 정의 세대 불일치
다음 메시지가 표시되면:
유효성 검사 실패: Hyper-V 버전 유효성 검사 오류(여러 Hyper-V 버전에 대한 교차 생성은 지원되지 않음). 제공된 SIG: <리소스 ID>에는 원본 이미지 <버전과 다른 Hyper-V 생성 <버전>>이 있습니다.
원본 이미지 생성이 Azure Compute Gallery VM 이미지 정의에 대해 지정한 세대와 동일한지 확인합니다.
사용할 이미지를 선택하면 원본 이미지의 세대가 표시됩니다. Azure Portal, az sig image-definition list 참조 명령을 사용하는 Azure CLI 또는 Get-AzGalleryImageDefinition cmdlet을 사용하는 PowerShell에서 VM 이미지 정의의 세대를 확인할 수 있습니다.
지정된 서브넷에 대해 PrivateLinkService 네트워크 정책을 사용하지 않도록 설정하지 않았습니다.
"지정된 서브넷에 대해 PrivateLinkService 네트워크 정책을 사용하지 않도록 설정하지 않았습니다"라는 오류 메시지가 표시되는 경우 서브넷에서 프라이빗 서비스 정책을 사용하지 않도록 설정해야 합니다. 자세한 내용은 서브넷에서 프라이빗 서비스 정책 비활성화를 참조하세요.
Windows 10 이미지에서 다른 언어를 설치하거나 사용하도록 설정하는 문제
다른 언어는 Install-Language PowerShell cmdlet을 사용하는 사용자 지정 이미지 템플릿에서 추가할 수 있습니다. Windows 10 Enterprise 및 Windows 10 Enterprise 다중 세션 이미지에서 다른 언어를 설치하거나 사용하도록 설정하는 데 문제가 있는 경우 다음을 확인합니다.
이미지에 그룹 정책별로 언어 팩을 설치하는 작업을 비활성화하지 않았습니다. 정책 설정은 다음 위치에서 찾을 수 있습니다.
컴퓨터 구성>관리 템플릿>제어판>국가 및 언어 옵션>언어 팩 및 언어 기능 설치 제한
사용자 구성>관리 템플릿>제어판>국가 및 언어 옵션>언어 팩 및 언어 기능 설치 제한
세션 호스트는 Windows 업데이트 연결하여 언어 및 최신 누적 업데이트를 다운로드할 수 있습니다.
Azure Portal의 원본 이미지 탭에서 진행할 수 없음
Azure Portal에서 사용자 지정 이미지 템플릿을 만들 때 Azure Compute Gallery를 원본 유형으로 선택하면 원본 이미지 탭에서 진행하지 못할 수도 있습니다. 탭 이름 옆에 빨간색 X 가 나타납니다. 해결 방법으로[이전]을 선택하여 [기본] 탭으로 돌아가서 [다음]을 선택하여 [원본 이미지] 탭으로 돌아갑니다. 이제 다음 탭으로 진행할 수 있으며 탭 이름 옆에 녹색 확인 표시가 나타납니다.
Azure Container Groups 작업 중에 권한 부여 오류가 발생했습니다.
사용자 지정 이미지 템플릿은 Azure Image Builder에 대한 종속성으로 인해 구독에 등록된 리소스 공급자가 필요합니다 Microsoft.ContainerInstance . 오류가 표시되면 다음을 수행합니다.
개체 ID가 'GUID'인 클라이언트 '<<GUID>>'에는 범위 '/subscriptions</subscription ID>'에 대해 'Microsoft.ContainerInstance/register/action' 작업을 수행할 권한이 없거나 범위가 잘못되었습니다.
구독에 리소스 공급자를 Microsoft.ContainerInstance 등록해야 합니다. 리소스 공급자를 등록한 후 작업을 다시 시도하세요. 등록 상태를 확인하는 방법 및 필요한 경우 등록하는 방법에 대한 자세한 내용은 Azure 리소스 공급자 및 유형을 참조하세요.