Ř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:

  1. Ověřte, jestli má AKS oprávnění pro přístup k registru mystreamingtest.azurecr.iokontejneru .
  2. Ujistěte se, že je registr mystreamingtest.azurecr.io kontejneru 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.