Events
Mar 17, 11 PM - Mar 21, 11 PM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
In this tutorial, you troubleshoot the most common problems for a registry enabled with the Artifact cache feature by identifying the Symptoms, causes, and potential solutions to effectively use the feature.
May include one or more of the following issues:
Cached images don't appear in a real repository
Credentials have an unhealthy status
Unable to create a cache rule
Unable to create cache rule using a wildcard
If you're having an issue with cached images not showing up in your repository in Azure Container Registry(ACR), we recommend verifying the repository path. Incorrect repository paths lead the cached images to not show up in your repository in ACR.
docker.io
.mcr.microsoft.com
.The Azure portal autofills these fields for you. However, many Docker repositories begin with library/
in their path. For example, in-order to cache the hello-world
repository, the correct Repository Path is docker.io/library/hello-world
.
Credentials are a set of Key Vault secrets that operate as a Username and Password for private repositories. Unhealthy Credentials are often a result of these secrets no longer being valid. In the Azure portal, you can select the credentials, to edit and apply changes.
To assign the access to Azure Key Vault:
az keyvault set-policy --name myKeyVaultName --object-id myObjID --secret-permissions get
Learn more about Key Vaults. Learn more about Assigning the access to Azure Key Vault.
If you're facing issues while creating a Cache rule, we recommend verifying if you have more than 1,000 cache rules created.
We recommend deleting any unwanted cache rules to avoid hitting the limit.
Learn more about the Cache Terminology.
If you're trying to create a cache rule, but there's a conflict with an existing rule. The error message suggests that there's already a cache rule with a wildcard for the specified target repository.
To resolve this issue, you need to follow these steps:
Identify Existing cache rule causing the conflict. Look for an existing rule that uses a wildcard (*) for the target repository.
Delete the conflicting cache rule that is overlapping source repository and wildcard.
Create a new cache rule with the desired wildcard and target repository.
Double-check your cache configuration to ensure that the new rule is correctly applied and there are no other conflicting rules.
Artifact cache currently supports the following upstream registries:
Warning
Customers must generate credential set to source content from Docker hub.
Upstream Registries | Support | Availability |
---|---|---|
Docker Hub | Supports authenticated pulls only. | Azure CLI, Azure portal |
Microsoft Artifact Registry | Supports unauthenticated pulls only. | Azure CLI, Azure portal |
AWS Elastic Container Registry (ECR) Public Gallery | Supports unauthenticated pulls only. | Azure CLI, Azure portal |
GitHub Container Registry | Supports both authenticated and unauthenticated pulls. | Azure CLI, Azure portal |
Quay | Supports both authenticated and unauthenticated pulls. | Azure CLI, Azure portal |
registry.k8s.io | Supports both authenticated and unauthenticated pulls. | Azure CLI |
Google Container Registry | Supports both authenticated and unauthenticated pulls. | Azure CLI |
Events
Mar 17, 11 PM - Mar 21, 11 PM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowTraining
Module
Configure Azure Container Registry for container app deployments - Training
Learn how to create and configure an Azure Container Registry, the process of pushing container images to Azure Container Registry and explore different authentication methods and security features for Azure Container Registry.
Certification
Microsoft Certified: Azure Developer Associate - Certifications
Build end-to-end solutions in Microsoft Azure to create Azure Functions, implement and manage web apps, develop solutions utilizing Azure storage, and more.
Documentation
Optimize Image Pulls with Artifact Cache in ACR - Azure Container Registry
Artifact cache is a feature that allows you to cache container images in Azure Container Registry, improving performance and efficiency.
Manage Public Content in Private Container Registry - Azure Container Registry
Practices and workflows in Azure Container Registry to manage dependencies on public images from Docker Hub and other public content
Preview: Artifact Streaming in Azure Container Registry - Azure Container Registry
Artifact streaming is a feature in Azure Container Registry to enhance managing, scaling, and deploying artifacts through containerized platforms.