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

Статья
07/30/2024

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

Примечание.

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

Необходимые компоненты

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

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

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

В начале экспортируйте шаблон диспетчера ресурсов Resource Manager. Этот шаблон содержит параметры, описывающие реестр контейнеров. Дополнительные сведения об использовании экспортированных шаблонов см. в статье [Использование экспортированного шаблона из портал Azure](.). /azure-resource-manager/templates/template-tutorial-портал Azure e.md) и справочник по шаблонам.

Найдите исходный реестр на портале 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 --resource-group myResourceGroup \
   --template-file template.json --name mydeployment

Примечание.

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

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

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

Используйте команду 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.

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

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

Необходимые компоненты

Рекомендации по конечным точкам службы

Рекомендации по частной конечной точке

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

Простой

Подготовить

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

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

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

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

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

Проверка

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

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

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

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

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

Необходимые компоненты

Рекомендации по конечным точкам службы

Рекомендации по частной конечной точке

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

Простой

Подготовить

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

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

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

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

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

Проверка

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

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

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

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