Устранение неполадок с миграцией веб-приложений
В этой статье описываются некоторые распространенные проблемы и определенные ошибки, которые могут возникнуть при попытке перенести веб-приложения с помощью службы "Миграция Azure".
проблемы с миграцией веб-приложения
В этой таблице перечислены шаги по устранению следующих проблем миграции:
Код ошибки | Сообщение об ошибке | Действия по устранению неполадок |
---|---|---|
AccessDenied | Доступ запрещен. | Проверьте сведения об ошибке. Возможно, она вызвана изменением, сделанным после последнего обнаружения веб-приложения. Убедитесь, что веб-приложение по-прежнему успешно обнаруживается, и(или) сначала устраните проблемы с доступом к нему для его обнаружения. |
AddConflict | Назначение роли уже существует. | Это может быть связано с AKS версии 1.23 и выше. Если используется AKS 1.23 и выше, то, прежде чем создавать образ Docker, измените скрипт, как описано в разделе Создание образа контейнера. |
AppContentAlreadyExists | Содержимое приложения appContent.zip уже присутствует в хранилище перед копированием содержимого. | Повторите миграцию с помощью новой учетной записи хранения. Если проблема не исчезает, обратитесь в службу поддержки. |
AppZipUploadFailed | Ошибка при отправке содержимого приложения в учетную запись хранения. | Повторите попытку, если это временная проблема, и убедитесь в наличии подключения устройства к учетной записи хранения Azure, указанной для данной миграции. |
CopyAppContentToApplianceFailure | Произошла ошибка при копировании содержимого с веб-сервера IIS на устройство. | Для получения дополнительной информации ознакомьтесь со сведениями об ошибке. Убедитесь в наличии подключения устройства к веб-серверу. Для этого, например, проверьте, удавалось ли успешно обнаружить веб-приложение в последнее время. |
IISWebAppExceededMaxContentSize | Размер содержимого для миграции с помощью этого средства превысил максимально допустимый (2 ГБ). | Используемый метод развертывания поддерживает только содержимое размером до 2 ГБ. Если размер несжатого содержимого превышает 2 ГБ, при обнаружении этой ошибки миграция не будет предпринята. Этот факт следует указать при оценке веб-приложения. Он может указывать на то, что размер содержимого файла изменился с момента последнего обнаружения веб-приложения. |
IISWebAppFailureCompressingSiteContent | Произошло исключение при сжатии содержимого сайта. | Для получения дополнительной информации ознакомьтесь со сведениями об ошибке. Это может быть связано с разрешениями на физические файлы, в том числе с блокировкой доступа для учетной записи администратора, используемой для обнаружения веб-приложения и переноса содержимого сайта. |
IISWebAppMigrationError | Ошибка при копировании содержимого приложения. | Дополнительные сведения приводятся в сообщении об ошибке. |
IISWebAppNotFoundOnServer | Имя сайта, соответствующее веб-приложению, не найдено на веб-сервере. | Это может быть вызвано изменениями на веб-сервере, сделанными после последнего обнаружения веб-приложения, например операциями удаления или переименования сайта. Убедитесь, что обнаружение веб-приложений проводилось недавно и сайт по-прежнему существует на веб-сервере. |
IISWebAppUNCContentDirectory | Веб-приложение содержит только содержимое каталога UNC. Миграция каталогов UNC в настоящее время не поддерживается. | В настоящее время миграция содержимого в общих папках UNC не поддерживается. Эта ошибка возникает, если весь контент сайта находится в общих папках UNC; если существуют каталоги содержимого общего доступа, не относящиеся к UNC, они будут перенесены. |
IISWebServerAccessFailedError | Не удается получить доступ к конфигурации IIS. | Это может быть вызвано недостаточным доступом к расположениям API конфигурации и управления IIS. Для миграции веб-приложений используется тот же механизм идентификации и подключения, что и для обнаружения веб-приложений. Проверьте, не изменились ли параметры с момента последнего успешного обнаружения веб-приложения и удается ли его по-прежнему успешно обнаруживать на этом веб-сервере. |
IISWebServerIISNotFoundError | Компонент консоли управления IIS не включен. | Эта ошибка указывает, что компонент консоли управления IIS не включен на веб-сервере и, скорее всего, вызвана изменением веб-сервера с момента последнего успешного обнаружения веб-приложения. Убедитесь, что роль веб-сервера (IIS), включая консоль управления IIS (часть средств управления), включена и что обнаружение веб-приложений может обнаруживать веб-приложения для целевого веб-сервера. |
IISWebServerInvalidSiteConfig | Обнаружена недопустимая конфигурация IIS: на сайте не определено корневое приложение. | Это указывает на недопустимую конфигурацию одного или нескольких сайтов на сервере IIS. Добавьте корневое приложение "/" для всех веб-сайтов на сервере IIS или удалите связанные с ним (нефункциональные) сайты. |
IISWebServerPowerShellError | Ошибка во время операции PowerShell. | Дополнительные сведения приводятся в сообщении об ошибке. Удаленная оболочка PowerShell используется для упаковки содержимого сайта с веб-сервера без необходимости установки каких-либо продуктов или изменений компьютера на веб-сервере. |
IISWebServerPowerShellVersionLessThan4 | Версия PowerShell на веб-сервере IIS ниже минимально допустимой версии PowerShell 4. | Миграция поддерживается только для веб-серверов IIS с PowerShell версии не ниже 4. Чтобы миграция стала возможной, установите на веб-сервере PowerShell версии 4. |
IISWebServerUnableToConnect | Невозможно подключиться к серверу. | Проверьте сведения об ошибке. Возможно, она вызвана изменением, сделанным после последнего успешного обнаружения веб-приложения. Убедитесь, что веб-приложение по-прежнему успешно обнаруживается, и(или) сначала устраните проблемы с доступом к нему для его обнаружения. |
IISWebServerZeroWebAppsFound | На целевом сервере IIS не найдено ни одного веб-приложения. | Это может означать, что веб-сервер был изменен после завершения последнего обнаружения веб-приложения. Убедитесь, что обнаружение веб-приложений проводилось недавно и что веб-приложения не были удалены с веб-сервера. |
NullResult | Скрипт PowerShell не вернул результатов. | Удаленная оболочка PowerShell используется для упаковки содержимого сайта с веб-сервера без установки каких-либо продуктов или постоянных файлов на сервере. Эта ошибка может означать, что значение MaxMemoryPerShell на сервере IIS слишком низкое или было изменено после завершения обнаружения веб-приложений. Попробуйте увеличить значение MaxMemoryPerShell на сервере IIS с помощью следующей команды: Set-Item WSMan:\localhost\Shell\MaxMemoryPerShellMB 4096 |
ResultFileContentJSONParseError | Приводит к непредвиденному формату. | Если вы видите эту ошибку, обратитесь в службу поддержки. |
ScriptExecutionTimedOutOnVm | Истекло время ожидания операции. | Эта ошибка может указывать на то, что после последнего обнаружения веб-приложения на сервере было что-то изменено. Убедитесь, что обнаружение веб-приложений по-прежнему проводится и выполняется успешно. |
StorageAuthenticationFailed | Не удалось пройти проверку подлинности в контейнере службы хранилища Azure. | Для получения дополнительной информации ознакомьтесь со сведениями об ошибке. |
StorageBlobAlreadyExists | BLOB-объект содержимого приложения уже присутствует перед отправкой содержимого приложения. | Повторите миграцию с помощью новой учетной записи хранения. |
StorageGenericError | Ошибка, связанная со службой хранилища Azure. | Этап развертывания Resource Manager Azure завершится, только если содержимое (appContent.zip) или файл ошибки (error.json) появится в контейнере хранилища сайта. Если NuGet не может отправить файл error.json в случаях ошибки, процесс развертывания Resource Manager Azure будет по-прежнему ожидать содержимое, пока не истечет время ожидания. Это может указывать на проблему с подключением устройства к указанной учетной записи хранения, используемой при миграции. |
UnableToConnectToPhysicalServer | Не удалось подключиться к удаленному серверу. | Проверьте сведения об ошибке. Возможно, она вызвана изменением, сделанным после последнего обнаружения веб-приложения. Проверьте, не возникают ли ошибки при попытке обнаружения веб-приложения, и в первую очередь устраните проблемы с подключением для обнаружения веб-приложений. |
UnableToConnectToServer | Не удалось подключиться к удаленному серверу. | Проверьте сведения об ошибке. Возможно, она вызвана изменением, сделанным после последнего обнаружения веб-приложения. Проверьте, не возникают ли ошибки при попытке обнаружения веб-приложения, и в первую очередь устраните проблемы с подключением для обнаружения веб-приложений. |
Следующие шаги
- Продолжайте выполнять масштабируемую миграцию ASP.NET веб-приложений в службу приложение Azure.
- После успешного завершения миграции можно изучить следующие действия на основе конкретных требований веб-приложения:
- Сопоставление существующего пользовательского DNS-имени.
- Защита пользовательской DNS с помощью привязки TLS/SSL.
- Безопасное подключение к ресурсам Azure.
- Рекомендации по развертыванию.
- Рекомендации по безопасности.
- Сетевые функции.
- Мониторинг Служба приложений с помощью Azure Monitor.
- Настройка проверки подлинности Microsoft Entra.
- Ознакомьтесь с рекомендациями по развертыванию в службе приложение Azure.