Перемещение реестра контейнеров Azure в другой регион

В этой статье показано, как переместить ресурсы реестра контейнеров Azure в другой регион в той же подписке клиента Active Directory.

Примечание.

Если вам нужно распространять одинаковые образы контейнеров в нескольких регионах Azure, реестр контейнеров Azure также поддерживает георепликацию. Путем георепликации реестра (требуется уровень служб "Премиум") можно обслуживать несколько регионов с одинаковыми именами образов и тегов из одного реестра.

Предпосылки

Вы можете переместить реестр только в том же клиенте Active Directory. Это ограничение применяется к реестрам, зашифрованным и незашифрованным с помощью ключа, управляемого клиентом.
Если в исходном реестре включены зоны доступности , целевой регион также должен поддерживать зоны доступности. Дополнительные сведения о поддержке зоны доступности для реестра контейнеров Azure см. в разделе Включение избыточности зоны в реестре контейнеров Azure.

Соображения по конечным точкам обслуживания

Конечные точки службы виртуальной сети для реестра контейнеров Azure ограничивают доступ к указанной виртуальной сети. Конечные точки также могут ограничить доступ к списку диапазонов адресов IPv4 (интернет-протокол версии 4). Доступ любого пользователя, подключающегося к реестру из-за пределов этих источников, запрещен. Если конечные точки службы были настроены в исходном регионе для ресурса реестра, то же самое необходимо сделать в целевом. Ниже приведены действия по этому сценарию.

Для успешного восстановления реестра в целевом регионе необходимо создать виртуальную сеть и подсеть заранее. Если перемещение этих двух ресурсов выполняется с помощью средства Azure Resource Mover, конечные точки службы не могут быть настроены автоматически, и поэтому необходимо предоставить ручную конфигурацию.
Во-вторых, необходимо вносить изменения в IaC реестра контейнеров Azure. В networkAcl разделе под virtualNetworkRules добавьте правило для целевой подсети. Убедитесь, что ignoreMissingVnetServiceEndpoint флаг имеет значение False, поэтому IaC не сможет развернуть реестр контейнеров Azure, если конечная точка службы не настроена в целевом регионе. Это гарантирует выполнение предварительных требований в целевом регионе.

Рассмотрение частной конечной точки

Приватный канал Azure обеспечивает частное подключение из виртуальной сети к платформе Azure как услуга (PaaS), клиентским службам или партнерским службам Майкрософт. Приватный канал упрощает сетевую архитектуру и защищает подключение между конечными точками в Azure, устраняя уязвимость данных к общедоступному Интернету.

Для успешного восстановления вашего ресурса в целевом регионе необходимо создать виртуальную сеть и подсеть до начала фактического восстановления.

Время простоя

Сведения о возможных простоях см. в Cloud Adoption Framework для Azure: выберите метод перемещения.

Подготовьте

Примечание.

Если вы хотите переместить реестр контейнеров, который не содержит данных конкретного клиента и перемещается самостоятельно, вы можете развернуть реестр заново с помощью Bicep или JSON.

Чтобы просмотреть другие шаблоны конфигурации доступности, перейдите к разделу "Определение ресурсов" с помощью Bicep, шаблонов ARM и поставщика Terraform AzAPI

Чтобы подготовиться к перемещению с помощью миграции данных:

Создайте карту зависимостей со всеми службами Azure, используемыми реестром. Для служб, которые подпадают под рамки перемещения, необходимо выбрать соответствующую стратегию перемещения.
Определите исходный макет сети для реестра контейнеров Azure (ACR), например брандмауэра и сетевой изоляции.
Извлеките все необходимые образы из исходного реестра для импорта в целевой реестр. Чтобы получить изображения, выполните следующую команду:
```
Get-AzContainerRegistryRepository -RegistryName registry
```
Используйте задачи ACR для получения конфигураций службы автоматизации исходного реестра для импорта в целевой реестр.

Экспорт шаблона

Чтобы начать, экспортируйте шаблон Resource Manager. Этот шаблон содержит параметры, описывающие реестр контейнеров. Дополнительные сведения об использовании экспортированных шаблонов см. в статье "Использование экспортированного шаблона на портале Azure " и ссылки на шаблон.

На портале Azure перейдите в исходный реестр.
В меню в разделе "Автоматизация" выберите "Экспорт шаблона>"Скачать".
Найдите скачанный c портала ZIP-файл и распакуйте его в любую выбранную папку.

В ZIP-файле содержатся файлы JSON, включающие шаблон и скрипты для развертывания шаблона.

Изменение шаблона

Проверьте свойства реестра в скачанном файле JSON шаблона и внесите необходимые изменения. Сделайте как минимум следующее:

Измените имя defaultValue реестра на нужное имя целевого реестра.

location Обновление требуемого региона Azure для целевого реестра

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "registries_myregistry_name": {
      "defaultValue": "myregistry",
      "type": "String"
    }
  },
  "variables": {},
  "resources": [
    {
      "type": "Microsoft.ContainerRegistry/registries",
      "apiVersion": "2020-11-01-preview",
      "name": "[parameters('myregistry_name')]",
      "location": "centralus",
      ...
    }
  ]
}

Проверьте все связанные ресурсы в скачанном шаблоне, например карты области реестра, конфигурацию репликации, параметры диагностики, такие как log analytics.
Если исходный реестр зашифрован, зашифруйте целевой реестр с помощью ключа, управляемого клиентом , и обновите шаблон с параметрами для требуемого управляемого удостоверения, хранилища ключей и ключа. Ключ, управляемый клиентом, можно включить только при развертывании реестра.

Создать группу ресурсов

Создайте группу ресурсов для целевого реестра с помощью az group create. В следующем примере создается группа ресурсов с именем myResourceGroup в расположении eastus.

az group create --name myResourceGroup --location eastus

Повторное развертывание

Используйте команду az deployment group create для развертывания целевого реестра с помощью шаблона:

az deployment group create \
  --name mydeployment \
  --resource-group myResourceGroup \
  --template-file template.json

Примечание.

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

Импорт содержимого из одного реестра в целевой реестр

После создания реестра в целевом регионе:

Используйте команду az acr import или эквивалентную команду Import-AzContainerImagePowerShell, чтобы импортировать образы и другие артефакты, которые вы хотите сохранить из исходного реестра в целевой реестр. Примеры команд см. в разделе "Импорт образов контейнеров" в реестр контейнеров.
Используйте команды Azure CLI az acr repository list и az acr repository show-tags или эквиваленты Azure PowerShell, чтобы перечислить содержимое исходного реестра.
Выполните команду импорта для отдельных артефактов или создайте скрипт для выполнения на списке артефактов.

В следующем примере скрипта Azure CLI перечисляются исходные репозитории и теги, а затем импортируются артефакты в целевой реестр в той же подписке Azure. Измените по мере необходимости для импорта определенных репозиториев или тегов. Сведения о импорте из реестра в другой подписке или клиенте см. в примерах импорта образов контейнеров в реестр контейнеров.
```
#!/bin/bash
# Modify registry names for your environment
SOURCE_REG=myregistry
TARGET_REG=targetregistry

# Get list of source repositories
REPO_LIST=$(az acr repository list \
    --name $SOURCE_REG --output tsv)

# Enumerate tags and import to target registry
for repo in $REPO_LIST; do
    TAGS_LIST=$(az acr repository show-tags --name $SOURCE_REG --repository $repo --output tsv);
    for tag in $TAGS_LIST; do
        echo "Importing $repo:$tag";
        az acr import --name $TARGET_REG --source $SOURCE_REG.azurecr.io/$repo":"$tag;
    done
done
```
Свяжите зависимые ресурсы с целевым реестром контейнеров Azure, например рабочей областью Log Analytics в параметрах диагностики.
Настройте интеграцию реестра контейнеров Azure с обоими типами кластеров AKS, созданными или еще не созданными, выполнив следующую команду:
```
Set-AzAksCluster -Name myAKSCluster -ResourceGroupName myResourceGroup -AcrNameToAttach <acr-name>
```
Внесите необходимые изменения в файл манифеста Kubernetes для интеграции с перенесенным реестром контейнеров Azure (ACR).
Обновите системы разработки и развертывания, чтобы использовать целевой реестр вместо исходного реестра.
Обновите все правила брандмауэра клиента, чтобы разрешить доступ к целевому реестру.

Проверьте

Подтвердите следующие сведения в целевом реестре:

Параметры реестра, такие как имя реестра, уровень служб, общедоступный доступ и репликация
Репозитории и теги для содержимого, которое требуется сохранить.

Удаление исходного реестра

После развертывания целевого реестра, перенесенного содержимого и проверенных параметров реестра можно удалить исходный реестр.

Чтобы переместить ресурсы реестра в новую группу ресурсов в той же подписке или [новой подписке], см. статью "Перемещение ресурсов Azure в новую группу ресурсов или подписку".
Дополнительные сведения о импорте образов контейнеров в реестр контейнеров Azure из общедоступного реестра или другого частного реестра.
См. справочник по шаблону Resource Manager для реестра контейнеров Azure.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-01-22

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

Перемещение реестра контейнеров Azure в другой регион

Предпосылки

Соображения по конечным точкам обслуживания

Рассмотрение частной конечной точки

Рекомендации по интеграции DNS частной конечной точки Azure

Время простоя

Подготовьте

Экспорт шаблона

Изменение шаблона

Создать группу ресурсов

Повторное развертывание

Импорт содержимого из одного реестра в целевой реестр

Проверьте

Удаление исходного реестра

Связанный контент

Обратная связь

Дополнительные ресурсы