Поделиться через

Руководство по устранению неполадок для кэша артефактов

  • Статья

В этом руководстве описаны наиболее распространенные проблемы с реестром, включенным с помощью функции кэша артефактов, определяя симптомы, причины и потенциальные решения для эффективного использования этой функции.

Симптомы и причины

Может включать одну или несколько следующих проблем:

Потенциальные решения

Кэшированные образы не отображаются в динамическом репозитории

Если у вас возникла проблема с кэшируемыми изображениями, которые не отображаются в репозитории в Реестр контейнеров Azure(ACR), рекомендуется проверить путь к репозиторию. Неправильные пути репозитория приводят к тому, что кэшированные образы не отображаются в репозитории в ACR.

  • Сервер входа для Docker Hub docker.io.
  • Сервер входа для Реестр артефактов Microsoft mcr.microsoft.com.

Портал Azure автоматически заполняет эти поля. Однако многие репозитории Docker начинаются с library/ их пути. Например, для кэширования репозитория правильный hello-world путь к репозиторию.docker.io/library/hello-world

Неработоспособные учетные данные

Учетные данные — это набор секретов Key Vault, которые работают в качестве имени пользователя и пароля для частных репозиториев. Неработоспособные учетные данные часто являются результатом того, что эти секреты больше не являются допустимыми. В портал Azure можно выбрать учетные данные, чтобы изменить и применить изменения.

  • Убедитесь, что срок действия секретов в Azure Key Vault истек.
  • Убедитесь, что секреты в Azure Key Vault допустимы.
  • Убедитесь, что доступ к Azure Key Vault назначен.

Чтобы назначить доступ к Azure Key Vault, выполните следующие действия.

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

Дополнительные сведения о Key Vault. Дополнительные сведения о назначении доступа к Azure Key Vault.

Не удается создать правило кэша

Ограничение правила кэша

Если при создании правила кэша возникают проблемы, рекомендуется проверить, созданы ли более 1000 правил кэша.

Рекомендуется удалить любые нежелательные правила кэша, чтобы избежать достижения предела.

Дополнительные сведения о терминологии кэша.

Не удалось создать правило кэша с помощью подстановочного знака

Если вы пытаетесь создать правило кэша, но существует конфликт с существующим правилом. Сообщение об ошибке предполагает, что уже существует правило кэша с подстановочным знаком для указанного целевого репозитория.

Чтобы устранить эту проблему, выполните следующие действия.

  1. Определение существующего правила кэша, вызывающего конфликт. Найдите существующее правило, использующее подстановочный знак (*) для целевого репозитория.

  2. Удалите конфликтующее правило кэша, перекрывающее исходный репозиторий и подстановочный знак.

  3. Создайте новое правило кэша с требуемым подстановочным знаком и целевым репозиторием.

  4. Дважды проверьте конфигурацию кэша, чтобы убедиться, что новое правило применяется правильно, и другие конфликтующие правила отсутствуют.

Поддержка вышестоящего потока

Кэш артефактов в настоящее время поддерживает следующие вышестоящей реестры:

Вышестоящий реестр Поддержка Availability
Docker Hub Поддерживает как прошедшие проверку подлинности, так и не прошедшие проверку подлинности. Azure CLI, портал Azure
Реестр артефактов Microsoft Поддерживает только вытягивание без проверки подлинности. Azure CLI, портал Azure
Общедоступная коллекция реестра эластичных контейнеров AWS (ECR) Поддерживает только вытягивание без проверки подлинности. Azure CLI, портал Azure
Реестр контейнеров GitHub; Поддерживает как прошедшие проверку подлинности, так и не прошедшие проверку подлинности. Azure CLI, портал Azure
Nvidia Поддерживает как прошедшие проверку подлинности, так и не прошедшие проверку подлинности. Azure CLI
Набережная Поддерживает как прошедшие проверку подлинности, так и не прошедшие проверку подлинности. Azure CLI, портал Azure
registry.k8s.io Поддерживает как прошедшие проверку подлинности, так и не прошедшие проверку подлинности. Azure CLI
Реестр контейнеров Google Поддерживает как прошедшие проверку подлинности, так и не прошедшие проверку подлинности. Azure CLI