Probleemoplossingsgids voor artefactcache
In deze zelfstudie lost u de meest voorkomende problemen op voor een register dat is ingeschakeld met de functie Artefactcache door de symptomen, oorzaken en mogelijke oplossingen te identificeren om de functie effectief te gebruiken.
Symptomen en oorzaken
Dit kan een of meer van de volgende problemen bevatten:
Afbeeldingen in cache worden niet weergegeven in een echte opslagplaats
Referenties hebben een slechte status
Kan geen cacheregel maken
Kan geen cacheregel maken met behulp van een jokerteken
Mogelijke oplossingen
Afbeeldingen in de cache worden niet weergegeven in een liveopslagplaats
Als u een probleem ondervindt met installatiekopieën in de cache die niet worden weergegeven in uw opslagplaats in Azure Container Registry (ACR), raden we u aan het pad naar de opslagplaats te controleren. Onjuiste opslagplaatspaden leiden ertoe dat de afbeeldingen in de cache niet worden weergegeven in uw opslagplaats in ACR.
- De aanmeldingsserver voor Docker Hub is
docker.io. - De aanmeldingsserver voor Microsoft-artefactregister is
mcr.microsoft.com.
In Azure Portal worden deze velden automatisch voor u ingevuld. Veel Docker-opslagplaatsen beginnen echter in library/ hun pad. Als u bijvoorbeeld de opslagplaats in de cache wilt opslaan, is docker.io/library/hello-worldhet juiste pad naar de hello-world opslagplaats.
Beschadigde referenties
Referenties zijn een set Key Vault-geheimen die werken als gebruikersnaam en wachtwoord voor privéopslagplaatsen. Beschadigde referenties zijn vaak het gevolg van deze geheimen die niet langer geldig zijn. In Azure Portal kunt u de referenties selecteren om wijzigingen te bewerken en toe te passen.
- Controleer of de geheimen in Azure Key Vault zijn verlopen.
- Controleer of de geheimen in Azure Key Vault geldig zijn.
- Controleer of de toegang tot De Azure Key Vault is toegewezen.
De toegang tot Azure Key Vault toewijzen:
az keyvault set-policy --name myKeyVaultName --object-id myObjID --secret-permissions get
Meer informatie over Key Vaults. Meer informatie over het toewijzen van de toegang tot Azure Key Vault.
Kan geen cacheregel maken
Limiet voor cacheregels
Als u problemen ondervindt bij het maken van een cacheregel, raden we u aan te controleren of er meer dan 1000 cacheregels zijn gemaakt.
Het is raadzaam om ongewenste cacheregels te verwijderen om te voorkomen dat de limiet wordt bereikt.
Meer informatie over de cacheterminologie.
Kan geen cacheregel maken met behulp van een jokerteken
Als u een cacheregel probeert te maken, maar er een conflict is met een bestaande regel. Het foutbericht geeft aan dat er al een cacheregel is met een jokerteken voor de opgegeven doelopslagplaats.
U kunt dit probleem oplossen door de volgende stappen uit te voeren:
Identificeer de bestaande cacheregel die het conflict veroorzaakt. Zoek naar een bestaande regel die gebruikmaakt van een jokerteken (*) voor de doelopslagplaats.
Verwijder de conflicterende cacheregel die overlappende bronopslagplaats en jokertekens.
Maak een nieuwe cacheregel met het gewenste jokerteken en de doelopslagplaats.
Controleer de cacheconfiguratie om ervoor te zorgen dat de nieuwe regel correct wordt toegepast en er geen andere conflicterende regels zijn.
Upstream-ondersteuning
De artefactcache ondersteunt momenteel de volgende upstream-registers:
Waarschuwing
Klanten moeten referenties genereren die zijn ingesteld op broninhoud van Docker Hub.
| Upstream-registers | Ondersteuning | Beschikbaarheid |
|---|---|---|
| Docker Hub | Ondersteunt alleen geverifieerde pulls. | Azure CLI, Azure Portal |
| Microsoft-artefactregister | Ondersteunt alleen niet-geverifieerde pulls. | Azure CLI, Azure Portal |
| Openbare GALERIE AWS Elastic Container Registry (ECR) | Ondersteunt alleen niet-geverifieerde pulls. | Azure CLI, Azure Portal |
| GitHub Container Registry | Ondersteunt zowel geverifieerde als niet-geverifieerde pulls. | Azure CLI, Azure Portal |
| Kade | Ondersteunt zowel geverifieerde als niet-geverifieerde pulls. | Azure CLI, Azure Portal |
| registry.k8s.io | Ondersteunt zowel geverifieerde als niet-geverifieerde pulls. | Azure-CLI |
| Google Container Registry | Ondersteunt zowel geverifieerde als niet-geverifieerde pulls. | Azure CLI |