Řešení potíží se streamováním artefaktů
Kroky pro řešení potíží v tomto článku vám můžou pomoct vyřešit běžné problémy, se kterými se můžete setkat při použití streamování artefaktů ve službě Azure Container Registry (ACR). Tyto kroky a doporučení vám můžou pomoct s diagnostikou a řešením problémů souvisejících se streamováním artefaktů a poskytují přehledy o základních procesech a protokolech pro účely ladění.
Příznaky
- Operace převodu selhala kvůli neznámé chybě.
- Řešení potíží s neúspěšnými nasazeními podů AKS
- Podmínky podu označují hodnotu UpgradeIfStreamableDisabled.
- Použití hodnot hash místo značky pro artefakt streamování
Příčiny
- Problémy s ověřováním, latencí sítě, načítáním imagí, operacemi streamování nebo jinými problémy
- Problémy s vyžádáním nebo streamováním obrázků, konfigurací artefaktů streamování, zdroji imagí a omezeními prostředků
- Problémy s konfiguracemi nebo oprávněními ACR
Operace převodu selhala.
| Kód chyby | Chybová zpráva | Informace o řešení potíží |
|---|---|---|
| UNKNOWN_ERROR | Operace převodu selhala kvůli neznámé chybě. | Příčinou je vnitřní chyba. Tady vám pomůže opakování. Pokud je opakování neúspěšné, obraťte se na podporu. |
| RESOURCE_NOT_FOUND | Operace převodu selhala, protože cílový prostředek nebyl nalezen. | Pokud se cílová image v registru nenajde, ověřte překlepy v hodnotě hash image. Pokud je image odstraněná nebo chybí v cílové oblasti (například konzistence replikace není okamžitá) |
| UNSUPPORTED_PLATFORM | Převod se v současné době nepodporuje pro platformu imagí. | Zpočátku se podporují jenom image linuxu/amd64. |
| NO_SUPPORTED_PLATFORM_FOUND | Převod se v současné době nepodporuje u žádné platformy imagí v indexu. | Zpočátku se podporují jenom image linuxu/amd64. V cílovém indexu se nenašla žádná image s touto platformou. |
| UNSUPPORTED_MEDIATYPE | Převod obrázku MediaType není podporován. | Převod může cílit pouze na obrázky s typem média: application/vnd.oci.image.manifest.v1+json, application/vnd.oci.image.index.v1+json, application/vnd.docker.distribution.manifest.v2+json nebo application/vnd.docker.distribution.manifest.list.v2+json |
| UNSUPPORTED_ARTIFACT_TYPE | Převod není podporován pro image ArtifactType. | Artefakty streamování (typ artefaktu: application/vnd.azure.artifact.streaming.v1) nelze znovu převést. |
| IMAGE_NOT_RUNNABLE | Převod není podporován pro nerunnable image. | Zpočátku se podporují jenom linuxové/amd64 spustitelné image. |
Řešení potíží s neúspěšnými nasazeními podů AKS
Pokud nasazení podu AKS selže s chybou související s vyžádáním image, například v následujícím příkladu.
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
Při řešení tohoto problému byste měli zkontrolovat následující pokyny:
- Ověřte, jestli má AKS oprávnění pro přístup k registru
mystreamingtest.azurecr.iokontejneru . - Ujistěte se, že je registr
mystreamingtest.azurecr.iokontejneru přístupný a správně připojený k AKS.
Kontrola podmínky podu UpgradeIfStreamableDisabled:
Pokud podmínka podu AKS zobrazuje UpgradeIfStreamableDisabled, zkontrolujte, jestli je image ze služby Azure Container Registry.
Použití hodnot hash místo značky pro artefakt streamování:
Pokud nasadíte artefakt streamování pomocí hodnoty hash místo značky (například mystreamingtest.azurecr.io/jupyter/all-spark-notebook@sha256:4ef83ea6b0f7763c230e696709d8d8c398e21f65542db36e82961908bcf58d18), nebudou události a podmínky AKS obsahovat informace související se streamováním. Jako základní modul kontejneru se ale zobrazí rychlé spuštění kontejneru. Tento modul streamuje image do AKS, pokud zjistí, že se streamuje skutečný obsah obrázku.