Dela via

Felsökningsguide för artefaktcache

  • Artikel

I den här självstudien felsöker du de vanligaste problemen för ett register som är aktiverat med funktionen Artefaktcache genom att identifiera symptom, orsaker och potentiella lösningar för att effektivt använda funktionen.

Symptom och orsaker

Kan innehålla ett eller flera av följande problem:

Potentiella lösningar

Cachelagrade avbildningar visas inte på en livelagringsplats

Om du har problem med att cachelagrade avbildningar inte visas på lagringsplatsen i Azure Container Registry (ACR) rekommenderar vi att du verifierar lagringsplatsens sökväg. Felaktiga lagringsplatssökvägar gör att cachelagrade avbildningar inte visas på lagringsplatsen i ACR.

  • Inloggningsservern för Docker Hub är docker.io.
  • Inloggningsservern för Microsoft Artifact Registry är mcr.microsoft.com.

Azure-portalen fyller automatiskt i dessa fält åt dig. Många Docker-lagringsplatser börjar dock med library/ i deras sökväg. För att cachelagrat hello-world lagringsplatsen är docker.io/library/hello-worldtill exempel rätt sökväg till lagringsplatsen .

Autentiseringsuppgifter som inte är felfria

Autentiseringsuppgifter är en uppsättning Key Vault-hemligheter som fungerar som användarnamn och lösenord för privata lagringsplatser. Felaktiga autentiseringsuppgifter är ofta ett resultat av att dessa hemligheter inte längre är giltiga. I Azure-portalen kan du välja autentiseringsuppgifterna för att redigera och tillämpa ändringar.

  • Kontrollera att hemligheterna i Azure Key Vault har upphört att gälla.
  • Kontrollera att hemligheterna i Azure Key Vault är giltiga.
  • Kontrollera att åtkomsten till Azure Key Vault har tilldelats.

Så här tilldelar du åtkomst till Azure Key Vault:

az keyvault set-policy --name myKeyVaultName --object-id myObjID --secret-permissions get

Läs mer om Key Vaults. Läs mer om hur du tilldelar åtkomst till Azure Key Vault.

Det går inte att skapa en cacheregel

Gräns för cacheregel

Om du har problem med att skapa en cacheregel rekommenderar vi att du kontrollerar om du har skapat fler än 1 000 cacheregler.

Vi rekommenderar att du tar bort oönskade cacheregler för att undvika att nå gränsen.

Läs mer om cacheterminologin.

Det går inte att skapa cacheregeln med ett jokertecken

Om du försöker skapa en cacheregel, men det finns en konflikt med en befintlig regel. Felmeddelandet tyder på att det redan finns en cacheregel med ett jokertecken för den angivna mållagringsplatsen.

För att lösa det här problemet måste du följa dessa steg:

  1. Identifiera befintlig cacheregel som orsakar konflikten. Leta efter en befintlig regel som använder ett jokertecken (*) för mållagringsplatsen.

  2. Ta bort den cacheregel som är i konflikt med överlappande källlagringsplats och jokertecken.

  3. Skapa en ny cacheregel med önskat jokertecken och mållagringsplats.

  4. Dubbelkolla cachekonfigurationen för att säkerställa att den nya regeln tillämpas korrekt och att det inte finns några andra motstridiga regler.

Stöd för överordnad

Artefaktcache stöder för närvarande följande överordnade register:

Överordnad register Support Tillgänglighet
Docker Hub Stöder både autentiserade och oautentiserade hämtningar. Azure CLI, Azure-portalen
Microsoft Artifact Registry Stöder endast oautentiserade hämtningar. Azure CLI, Azure-portalen
Offentligt galleri för AWS Elastic Container Registry (ECR) Stöder endast oautentiserade hämtningar. Azure CLI, Azure-portalen
GitHub Container Registry Stöder både autentiserade och oautentiserade hämtningar. Azure CLI, Azure-portalen
Nvidia Stöder både autentiserade och oautentiserade hämtningar. Azure CLI
Kaj Stöder både autentiserade och oautentiserade hämtningar. Azure CLI, Azure-portalen
registry.k8s.io Stöder både autentiserade och oautentiserade hämtningar. Azure CLI
Google Container Registry Stöder både autentiserade och oautentiserade hämtningar. Azure CLI