웹앱 마이그레이션 문제 해결

  • 아티클

이 문서에서는 Azure Migrate를 사용하여 웹앱을 마이그레이션하려고 할 때 발생할 수 있는 몇 가지 일반적인 문제와 특정 오류에 대해 설명합니다.

Web Apps 마이그레이션 문제

이 표에는 다음 마이그레이션 문제를 해결하기 위한 단계가 나열되어 있습니다.

오류 코드 오류 메시지 문제 해결 단계
AccessDenied 액세스가 거부되었습니다. 오류 세부 정보를 확인합니다. 이는 마지막 웹앱 검색 이후 변경 내용 때문일 수 있습니다. 웹앱 검색이 여전히 성공적인지 확인하거나 웹앱 검색 액세스 문제를 먼저 해결합니다.
AddConflict 역할 할당이 이미 있습니다. 이는 AKS 1.23+ 버전 때문일 수 있습니다. AKS 1.23 이상을 사용하는 경우 Docker 이미지를 빌드하기 전에 컨테이너 이미지 빌드에 언급된 대로 스크립트를 편집하세요.
AppContentAlreadyExists 애플리케이션 콘텐츠 appContent.zip은 콘텐츠 복사 전에 스토리지에 이미 존재합니다. 새 스토리지 계정을 사용하여 마이그레이션을 다시 시도합니다. 이 문제가 지속적으로 발생하면 지원에 문의하세요.
AppZipUploadFailed 스토리지 계정에 애플리케이션 콘텐츠를 업로드하는 동안 오류가 발생했습니다. 일시적인 문제인 경우 다시 시도하고 어플라이언스와 마이그레이션을 위해 지정된 Azure Storage 계정 간의 연결을 확인합니다.
CopyAppContentToApplianceFailure IIS 웹 서버에서 어플라이언스로 콘텐츠를 복사하는 중 오류가 발생했습니다. 자세한 내용은 오류 세부 정보를 확인합니다. 최근에 성공한 웹앱 검색을 찾는 것과 같이 어플라이언스와 웹 서버 간의 연결을 확인합니다.
IISWebAppExceededMaxContentSize 콘텐츠 크기가 이 도구를 사용한 마이그레이션의 최대 콘텐츠 크기(2GB)를 초과했습니다. 사용된 배포 방법은 최대 2GB 크기의 콘텐츠만 지원합니다. 압축되지 않은 콘텐츠가 2GB보다 크면 이 오류와 함께 마이그레이션이 시도되지 않습니다. 이는 웹앱 평가에서 플래그 지정되어야 하며 마지막 웹앱 검색이 완료된 이후 파일 콘텐츠 크기 변경을 나타낼 수 있습니다.
IISWebAppFailureCompressingSiteContent 사이트 콘텐츠를 압축하는 중에 예외가 발생했습니다. 자세한 내용은 오류 세부 정보를 확인합니다. 이는 사이트 콘텐츠의 웹앱 검색 및 마이그레이션에 사용되는 관리자 계정에 대한 액세스가 차단된 경우를 포함하여 실제 파일 권한과 관련될 수 있습니다.
IISWebAppMigrationError 앱 콘텐츠 복사 작업 중 오류가 발생했습니다. 자세한 내용은 오류 메시지를 확인합니다.
IISWebAppNotFoundOnServer 웹 서버에서 사이트 이름과 일치하는 웹 애플리케이션을 찾을 수 없습니다. 이는 사이트 삭제 또는 이름 바꾸기 작업과 같이 마지막 웹앱 검색이 완료된 이후 웹 서버의 변경 내용 때문일 수 있습니다. 웹앱 검색이 최근에 완료되었고 사이트가 여전히 웹 서버에 존재하는지 확인합니다.
IISWebAppUNCContentDirectory 웹앱에는 UNC 디렉터리 콘텐츠만 포함됩니다. UNC 디렉터리는 현재 마이그레이션이 지원되지 않습니다. 현재 UNC 공유의 콘텐츠에 대한 마이그레이션은 지원되지 않습니다. 이 오류는 모든 사이트 콘텐츠가 UNC 공유에 있고 마이그레이션될 비 UNC 공유 콘텐츠 디렉터리가 있는 경우 발생합니다.
IISWebServerAccessFailedError IIS 구성에 액세스할 수 없습니다. 이는 IIS 구성 및 관리 API 위치에 대한 액세스 권한이 충분하지 않기 때문에 발생할 수 있습니다. 웹앱 마이그레이션은 웹앱 검색과 동일한 ID 및 연결 메커니즘을 사용합니다. 마지막으로 성공한 웹앱 검색 이후 설정이 변경되었는지, 이 웹 서버에 대해 해당 검색을 계속 성공했는지 확인합니다.
IISWebServerIISNotFoundError IIS 관리 콘솔 기능이 사용하도록 설정되어 있지 않습니다. 이 오류는 IIS 관리 콘솔 기능이 웹 서버에서 사용하도록 설정되지 않았으며 마지막으로 성공한 웹앱 검색이 완료된 이후 웹 서버가 변경되었을 가능성이 있음을 나타냅니다. IIS 관리 콘솔 기능(관리 도구의 일부)을 포함하는 웹 서버(IIS) 역할이 사용하도록 설정되어 있고 웹앱 검색이 대상 웹 서버에 대한 웹앱을 검색할 수 있는지 확인합니다.
IISWebServerInvalidSiteConfig 잘못된 IIS 구성이 발견되었습니다. 사이트에 정의된 루트 애플리케이션이 없습니다. 이는 IIS 서버에 있는 하나 이상의 사이트에 대한 잘못된 사이트 구성을 나타냅니다. IIS 서버의 모든 웹 사이트에 대해 루트 "/" 애플리케이션을 추가하거나 연결된(작동하지 않는) 사이트를 제거합니다.
IISWebServerPowerShellError PowerShell 작업 중 오류가 발생했습니다. 자세한 내용은 오류 메시지를 확인하세요. 원격 PowerShell은 웹 서버에 제품을 설치하거나 컴퓨터를 변경할 필요 없이 웹 서버에서 사이트 콘텐츠를 패키지하는 데 사용됩니다.
IISWebServerPowerShellVersionLessThan4 IIS 웹 서버의 PowerShell 버전은 최소 필수 PowerShell 버전 4보다 낮습니다. 마이그레이션은 PowerShell V4 이상 버전이 있는 IIS 웹 서버에서만 지원됩니다. 이 마이그레이션을 사용하도록 설정하려면 PowerShell v4로 웹 서버를 업데이트합니다.
IISWebServerUnableToConnect 서버에 연결할 수 없습니다. 오류 세부 정보를 확인합니다. 이는 마지막으로 성공한 웹앱 검색 이후 변경 내용 때문일 수 있습니다. 웹앱 검색이 여전히 성공적인지 확인하거나 웹앱 검색 액세스 문제를 먼저 해결합니다.
IISWebServerZeroWebAppsFound 대상 IIS 서버에서 웹앱을 찾을 수 없습니다. 이는 마지막 웹앱 검색이 완료된 후 웹 서버가 수정되었음을 나타낼 수 있습니다. 웹앱 검색이 최근에 완료되었고 웹앱이 웹 서버에서 제거되지 않았는지 확인합니다.
NullResult PowerShell 스크립트는 결과를 반환하지 않았습니다. 원격 PowerShell은 서버에 제품이나 영구 파일을 설치할 필요 없이 웹 서버에서 사이트 콘텐츠를 패키지하는 데 사용됩니다. 이 오류는 IIS 서버의 MaxMemoryPerShell 값이 너무 낮거나 웹앱 검색이 완료된 이후에 변경되었음을 나타낼 수 있습니다. 다음과 같은 명령을 사용하여 IIS 서버에서 MaxMemoryPerShell 값을 늘려 보세요. Set-Item WSMan:\localhost\Shell\MaxMemoryPerShellMB 4096
ResultFileContentJSONParseError 예기치 않은 형식으로 결과가 나타납니다. 이 오류가 표시되면 지원에 문의하세요.
ScriptExecutionTimedOutOnVm 작업 시간 초과 이 오류는 마지막 웹앱 검색 이후 서버의 변경 내용을 나타낼 수 있습니다. 웹앱 검색이 여전히 실행 중이고 성공적인지 확인합니다.
StorageAuthenticationFailed Azure Storage 컨테이너로 인증하지 못했습니다. 자세한 내용은 오류 세부 정보를 확인하세요.
StorageBlobAlreadyExists 앱 콘텐츠를 업로드하기 전에 이미 앱 콘텐츠 Blob이 있습니다. 새 스토리지 계정을 사용하여 마이그레이션을 다시 시도합니다.
StorageGenericError Azure Storage 관련 오류입니다. Azure Resource Manager 배포 단계는 사이트의 스토리지 컨테이너에 콘텐츠(appContent.zip) 또는 오류 파일(error.json)이 나타나는 경우에만 완료됩니다. 오류가 발생한 경우 NuGet이 error.json 파일을 업로드할 수 없으면 Azure Resource Manager 배포는 시간이 초과될 때까지 계속되며 콘텐츠를 기다립니다. 이는 어플라이언스와 마이그레이션에서 사용 중인 지정된 스토리지 계정 간의 연결 문제를 나타낼 수 있습니다.
UnableToConnectToPhysicalServer 원격 서버에 연결하지 못했습니다. 오류 세부 정보를 확인합니다. 이는 마지막 웹앱 검색 이후 변경 내용 때문일 수 있습니다. 먼저 웹앱 검색 오류를 확인하고 웹앱 검색 연결 문제를 해결합니다.
UnableToConnectToServer 원격 서버에 연결하지 못했습니다. 오류 세부 정보를 확인합니다. 이는 마지막 웹앱 검색 이후 변경 내용 때문일 수 있습니다. 먼저 웹앱 검색 오류를 확인하고 웹앱 검색 연결 문제를 해결합니다.

다음 단계