Freigeben über

Problembehandlung beim Artefaktstreaming

  • Artikel

Mit den Schritten zur Problembehandlung in diesem Artikel können Sie häufige Probleme beheben, die beim Verwenden des Artefaktstreamings in einer Azure Container Registry (ACR) auftreten können. Diese Schritte und Empfehlungen können helfen, Probleme im Zusammenhang mit Artefaktstreaming zu diagnostizieren und zu beheben. Sie bieten außerdem Einblicke in die zugrunde liegenden Prozesse und Protokolle für Debuggingzwecke.

Problembeschreibung

  • Der Konvertierungsvorgang ist aufgrund eines unbekannten Fehlers fehlgeschlagen.
  • Problembehandlung bei fehlgeschlagenen AKS-Pod-Bereitstellungen.
  • Pod-Bedingungen geben „UpgradeIfStreamableDisabled“ an.
  • Verwenden Sie Digest anstelle von Tag für Streamingartefakte.

Ursachen

  • Probleme mit Authentifizierung, Netzwerklatenz, Abrufen von Images, Streamingvorgängen oder andere Probleme.
  • Probleme mit Abrufen oder Streaming von Images, Streamingartefaktekonfigurationen, Imagequellen und Ressourceneinschränkungen.
  • Probleme mit ACR-Konfigurationen oder -Berechtigungen.

Konvertierungsvorgang fehlgeschlagen

Fehlercode Fehlermeldung Informationen zur Problembehandlung
UNKNOWN_ERROR Der Konvertierungsvorgang ist aufgrund eines unbekannten Fehlers fehlgeschlagen. Verursacht durch einen internen Fehler. Ein Wiederholungsversuch hilft hier. Wenn der Wiederholungsversuch nicht erfolgreich ist, wenden Sie sich an den Support.
RESOURCE_NOT_FOUND Der Konvertierungsvorgang ist fehlgeschlagen, da die Zielressource nicht gefunden wurde. Wenn das Zielimage in der Registrierung nicht gefunden wird, überprüfen Sie Tippfehler im Imagedigest. Wenn das Bild gelöscht wird oder in der Zielregion fehlt (Replikationskonsistenz ist z. B. nicht sofort möglich)
UNSUPPORTED_PLATFORM Die Konvertierung wird derzeit für die Imageplattform nicht unterstützt. Es werden zunächst nur Linux/amd64-Images unterstützt.
NO_SUPPORTED_PLATFORM_FOUND Die Konvertierung wird derzeit für keine der Imageplattformen im Index unterstützt. Es werden zunächst nur Linux/amd64-Images unterstützt. Es wurde kein Image mit dieser Plattform im Zielindex gefunden.
UNSUPPORTED_MEDIATYPE Die Konvertierung wird für den Medientyp des Images nicht unterstützt. Die Konvertierung kann nur Images mit folgenden Medientypen verwenden: application/vnd.oci.image.manifest.v1+json, application/vnd.oci.image.index.v1+json, application/vnd.docker.distribution.manifest.v2+json oder application/vnd.docker.distribution.manifest.list.v2+json
UNSUPPORTED_ARTIFACT_TYPE Die Konvertierung wird für den Artefakttyp des Images nicht unterstützt. Streamingartefakte (Artefakttyp: application/vnd.azure.artifact.streaming.v1) können nicht erneut konvertiert werden.
IMAGE_NOT_RUNNABLE Die Konvertierung wird für nicht ausführbare Images nicht unterstützt. Anfänglich werden nur ausführbare Linux/amd64-Images unterstützt.

Problembehandlung bei fehlgeschlagenen AKS-Pod-Bereitstellungen

Wenn die AKS-Pod-Bereitstellung mit einem Fehler im Zusammenhang mit dem Abrufen von Images fehlschlägt, wie im folgenden Beispiel

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

Um dieses Problem zu beheben, sollten Sie folgende Richtlinien überprüfen:

  1. Überprüfen Sie, ob der AKS über Berechtigungen für den Zugriff auf die Containerregistrierung „mystreamingtest.azurecr.io“ verfügt.
  2. Stellen Sie sicher, dass auf die Containerregistrierung „mystreamingtest.azurecr.io“ zugegriffen werden kann und dass sie ordnungsgemäß an AKS angefügt ist.

Überprüfen Sie die Pod-Bedingung „UpgradeIfStreamableDisabled“:

Wenn die AKS-Pod-Bedingung „UpgradeIfStreamableDisabled“ anzeigt, überprüfen Sie, ob das Image aus einer Azure Container Registry stammt.

Verwenden von Digest anstelle von Tag für Streamingartefakte:

Wenn Sie das Streamingartefakt mit Digest anstelle von Tag bereitstellen (z. B. mystreamingtest.azurecr.io/jupyter/all-spark-notebook@sha256:4ef83ea6b0f7763c230e696709d8d8c398e21f65542db36e82961908bcf58d18), enthält die AKS-Pod-Ereignis- und Bedingungsmeldung keine streamingbezogenen Informationen. Allerdings wird der schnelle Containerstart als zugrunde liegendes Containermodul angezeigt. Diese Engine streamt das Image an AKS, wenn erkannt wird, dass der tatsächliche Image-Inhalt gestreamt werden kann.

Zugehöriger Inhalt

Artefaktstreaming