Устранение неполадок потоковой передачи артефактов
Действия по устранению неполадок, описанные в этой статье, помогут устранить распространенные проблемы, которые могут возникнуть при использовании потоковой передачи артефактов в Реестр контейнеров Azure (ACR). Эти шаги и рекомендации помогают диагностировать и устранять проблемы, связанные с потоковой передачей артефактов, а также предоставлять аналитические сведения о базовых процессах и журналах для отладки.
Симптомы
- Сбой операции преобразования из-за неизвестной ошибки.
- Устранение неполадок с неудачными развертываниями pod AKS.
- Условия pod указывают "UpgradeIfStreamableDisabled".
- Использование дайджеста вместо тега для артефакта потоковой передачи.
Причины
- Проблемы с проверкой подлинности, задержкой сети, извлечением изображений, операциями потоковой передачи или другими проблемами.
- Проблемы с извлечением изображений или потоковой передачей, конфигурациями потоковых артефактов, источниками изображений и ограничениями ресурсов.
- Проблемы с конфигурациями или разрешениями ACR.
Сбой операции преобразования
| Код ошибки | Сообщение об ошибке | Информация об устранении неполадок |
|---|---|---|
| UNKNOWN_ERROR | Сбой операции преобразования из-за неизвестной ошибки. | Вызвана внутренней ошибкой. Повторные попытки помогают здесь. Если повторные попытки не выполнены, обратитесь в службу поддержки. |
| RESOURCE_NOT_FOUND | Сбой операции преобразования, так как целевой ресурс не найден. | Если целевой образ не найден в реестре, проверьте опечатки в дайджесте образа. Если изображение удалено или отсутствует в целевом регионе (например, согласованность репликации не является немедленной) |
| UNSUPPORTED_PLATFORM | Преобразование в настоящее время не поддерживается для платформы изображений. | Изначально поддерживаются только образы linux/amd64. |
| NO_SUPPORTED_PLATFORM_FOUND | Преобразование в настоящее время не поддерживается для любой платформы изображений в индексе. | Изначально поддерживаются только образы linux/amd64. Изображение с этой платформой не найдено в целевом индексе. |
| UNSUPPORTED_MEDIATYPE | Преобразование не поддерживается для образа MediaType. | Преобразование может использовать только целевые изображения с типом мультимедиа: application/vnd.oci.image.manifest.v1+json, application/vnd.oci.image.index.v1+json, application/vnd.docker.distribution.manifest.v2+json или application/vnd.docker.distribution.manifest.list.v2+json |
| UNSUPPORTED_ARTIFACT_TYPE | Преобразование не поддерживается для image ArtifactType. | Потоковая передача артефактов (тип артефакта: application/vnd.azure.artifact.streaming.v1) не может быть преобразована снова. |
| IMAGE_NOT_RUNNABLE | Преобразование не поддерживается для неисключаемых образов. | Изначально поддерживаются только образы linux/amd64 runnable. |
Устранение неполадок с неудачными развертываниями pod AKS Pod
Если развертывание pod AKS завершается сбоем с ошибкой, связанной с извлечением изображений, как показано в следующем примере.
Failed to pull image "mystreamingtest.azurecr.io/jupyter/all-spark-notebook:latest":
rpc error: code = Unknown desc = failed to pull and unpack image
"mystreamingtest.azurecr.io/latestobd/jupyter/all-spark-notebook:latest":
failed to resolve reference "mystreamingtest.azurecr.io/jupyter/all-spark-notebook:latest":
unexpected status from HEAD request to http://localhost:8578/v2/jupyter/all-spark-notebook/manifests/latest?ns=mystreamingtest.azurecr.io:503 Service Unavailable
Чтобы устранить эту проблему, ознакомьтесь со следующими рекомендациями.
- Проверьте, имеет ли AKS разрешения на доступ к реестру
mystreamingtest.azurecr.ioконтейнеров. - Убедитесь, что реестр
mystreamingtest.azurecr.ioконтейнеров доступен и правильно подключен к AKS.
Проверка условия pod UpgradeIfStreamableDisabled:
Если условие pod AKS отображает "UpgradeIfStreamableDisabled", проверьте, находится ли образ из Реестр контейнеров Azure.
Использование дайджеста вместо тега для артефакта потоковой передачи:
При развертывании артефакта потоковой передачи с помощью дайджеста вместо тега (например, mystreamingtest.azurecr.io/jupyter/all-spark-notebook@sha256:4ef83ea6b0f7763c230e696709d8d8c398e21f65542db36e82961908bcf58d18), событие pod AKS и сообщение об условии не будет включать связанные с потоковой передачей сведения. Однако вы видите быстрый запуск контейнера в качестве базового ядра контейнеров. Этот обработчик передает образ в AKS, если он обнаруживает фактическое содержимое изображения.