Rozwiązywanie problemów z przesyłaniem strumieniowym artefaktów
Kroki rozwiązywania problemów w tym artykule mogą pomóc w rozwiązaniu typowych problemów, które mogą wystąpić podczas korzystania z przesyłania strumieniowego artefaktów w usłudze Azure Container Registry (ACR). Te kroki i zalecenia mogą pomóc zdiagnozować i rozwiązać problemy związane z przesyłaniem strumieniowym artefaktów, a także zapewnić wgląd w podstawowe procesy i dzienniki na potrzeby debugowania.
Objawy
- Operacja konwersji nie powiodła się z powodu nieznanego błędu.
- Rozwiązywanie problemów z nieudanymi wdrożeniami zasobników usługi AKS.
- Warunki zasobnika wskazują "UpgradeIfStreamableDisabled".
- Użycie skrótu zamiast tagu dla artefaktu przesyłania strumieniowego.
Przyczyny
- Problemy z uwierzytelnianiem, opóźnieniem sieci, pobieraniem obrazów, operacjami przesyłania strumieniowego lub innymi problemami.
- Problemy dotyczące ściągania lub przesyłania strumieniowego obrazów, konfiguracji artefaktów przesyłania strumieniowego, źródeł obrazów i ograniczeń zasobów.
- Problemy z konfiguracjami lub uprawnieniami usługi ACR.
Operacja konwersji nie powiodła się
| Kod błędu | Komunikat o błędzie | Informacje o rozwiązywaniu problemów |
|---|---|---|
| UNKNOWN_ERROR | Operacja konwersji nie powiodła się z powodu nieznanego błędu. | Spowodowane przez błąd wewnętrzny. Spróbuj ponownie tutaj. Jeśli ponowna próba zakończy się niepowodzeniem, skontaktuj się z pomocą techniczną. |
| RESOURCE_NOT_FOUND | Operacja konwersji nie powiodła się, ponieważ nie znaleziono zasobu docelowego. | Jeśli obraz docelowy nie znajduje się w rejestrze, sprawdź literówki w skrótzie obrazu. Jeśli obraz zostanie usunięty lub brakuje go w regionie docelowym (na przykład spójność replikacji nie jest natychmiastowa) |
| UNSUPPORTED_PLATFORM | Konwersja nie jest obecnie obsługiwana dla platformy obrazów. | Początkowo obsługiwane są tylko obrazy linux/amd64. |
| NO_SUPPORTED_PLATFORM_FOUND | Konwersja nie jest obecnie obsługiwana dla żadnej platformy obrazów w indeksie. | Początkowo obsługiwane są tylko obrazy linux/amd64. W indeksie docelowym nie można odnaleźć obrazu z tą platformą. |
| UNSUPPORTED_MEDIATYPE | Konwersja nie jest obsługiwana dla obrazu MediaType. | Konwersja może dotyczyć obrazów tylko z typem nośnika: application/vnd.oci.image.manifest.v1+json, application/vnd.oci.image.index.v1+json, application/vnd.distribution.manifest.v2+json lub application/vnd.docker.distribution.list.v2+json |
| UNSUPPORTED_ARTIFACT_TYPE | Konwersja nie jest obsługiwana dla obrazu ArtifactType. | Artefakty przesyłania strumieniowego (typ artefaktu: application/vnd.azure.artifact.streaming.v1) nie można ponownie przekonwertować. |
| IMAGE_NOT_RUNNABLE | Konwersja nie jest obsługiwana w przypadku obrazów nieuruchomialnych. | Początkowo obsługiwane są tylko obrazy z możliwością uruchamiania linux/amd64. |
Rozwiązywanie problemów z nieudanymi wdrożeniami zasobników usługi AKS
Jeśli wdrożenie zasobnika usługi AKS zakończy się niepowodzeniem z powodu błędu związanego z ściąganiem obrazu, podobnie jak w poniższym przykładzie.
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
Aby rozwiązać ten problem, należy sprawdzić następujące wskazówki:
- Sprawdź, czy usługa AKS ma uprawnienia dostępu do rejestru
mystreamingtest.azurecr.iokontenerów. - Upewnij się, że rejestr
mystreamingtest.azurecr.iokontenerów jest dostępny i prawidłowo dołączony do usługi AKS.
Sprawdzanie warunku zasobnika "UpgradeIfStreamableDisabled":
Jeśli warunek zasobnika usługi AKS zawiera wartość "UpgradeIfStreamableDisabled", sprawdź, czy obraz pochodzi z usługi Azure Container Registry.
Używanie skrótu zamiast tagu dla artefaktu przesyłania strumieniowego:
Jeśli wdrożysz artefakt przesyłania strumieniowego przy użyciu skrótu zamiast tagu (na przykład mystreamingtest.azurecr.io/jupyter/all-spark-notebook@sha256:4ef83ea6b0f7763c230e696709d8d8c398e21f65542db36e82961908bcf58d18), zdarzenie zasobnika usługi AKS i komunikat warunku nie będą zawierać informacji pokrewnych przesyłania strumieniowego. Jednak szybkie uruchamianie kontenera jest widoczne jako podstawowy aparat kontenera. Ten aparat przesyła strumieniowo obraz do usługi AKS, jeśli wykryje, że rzeczywista zawartość obrazu jest przesyłana strumieniowo.