Настройка репликации объектов для блочных BLOB-объектов

При настройке репликации объектов в Azure portal необходимо настроить политику только в исходной учетной записи. Azure portal автоматически создаёт политику на целевой учетной записи после настройки исходной учетной записи.

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

1. Перейдите к учетной записи хранилища в портале Azure.

2. В разделе Data management выберите репликация объектов.

3. Выберите "Создать правила репликации".

4. Выберите целевую подписку и учетную запись хранилища.

5. В разделе сведений о паре контейнеров выберите исходный контейнер из исходной учетной записи и целевой контейнер из целевой учетной записи. Можно создать до 10 пар контейнеров на политику репликации из Azure portal. Сведения о настройке более 10 пар контейнеров (до 1000) см. в статье Настройка репликации объектов с помощью JSON-файла.

   На следующем рисунке показан набор правил репликации.

   

6. При необходимости укажите один или несколько фильтров, чтобы скопировать только блобы, соответствующие шаблону префикса. Например, если указать префикс b, реплицируются только те объекты BLOB, имя которых начинается с заданной буквы. В качестве части префикса можно указать виртуальный каталог. Можно добавить не более пяти совпадений префикса. Строка префикса не поддерживает подстановочные знаки.

   На следующем изображении показаны фильтры, ограничивающие копирование объектов в рамках правила репликации.

   

7. По умолчанию область копирования устанавливается для копирования только новых объектов. Чтобы скопировать все объекты в контейнере или скопировать объекты, начиная с пользовательской даты и времени, выберите ссылку изменения и настройте область копирования для пары контейнеров.

   На следующем изображении показана настраиваемая область копирования, которая копирует объекты, начиная с указанной даты и времени.

   

8. Нажмите кнопку "Сохранить" и применить , чтобы создать политику репликации и начать репликацию данных.

После настройки репликации объектов Azure portal отображает политику и правила репликации, как показано на следующем рисунке.

Чтобы создать политику репликации с помощью PowerShell, сначала установите версию 2.5.0 или более поздней версии модуля Az.Storage PowerShell. Дополнительные сведения об установке Azure PowerShell см. в разделе Install Azure PowerShell с помощью PowerShellGet.

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

# Sign in to your Azure account.
Connect-AzAccount

# Set variables.
$rgName = "<resource-group>"
$srcAccountName = "<source-storage-account>"
$destAccountName = "<destination-storage-account>"
$srcContainerName1 = "source-container1"
$destContainerName1 = "dest-container1"
$srcContainerName2 = "source-container2"
$destContainerName2 = "dest-container2"

# Enable blob versioning and change feed on the source account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -EnableChangeFeed $true `
    -IsVersioningEnabled $true

# Enable blob versioning on the destination account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName `
    -IsVersioningEnabled $true

# List the service properties for both accounts.
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName

# Create containers in the source and destination accounts.
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $srcAccountName |
    New-AzStorageContainer $srcContainerName1
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $destAccountName |
    New-AzStorageContainer $destContainerName1
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $srcAccountName |
    New-AzStorageContainer $srcContainerName2
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $destAccountName |
    New-AzStorageContainer $destContainerName2

# Define replication rules for each container.
$rule1 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName1 `
    -DestinationContainer $destContainerName1 `
    -PrefixMatch b
$rule2 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName2 `
    -DestinationContainer $destContainerName2  `
    -MinCreationTime 2021-09-01T00:00:00Z

# Create the replication policy on the destination account.
$destPolicy = Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName `
    -PolicyId default `
    -SourceAccount $srcAccountName `
    -Rule $rule1,$rule2

# Create the same policy on the source account.
Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -InputObject $destPolicy

Чтобы создать политику репликации с Azure CLI, сначала установите Azure CLI версии 2.11.1 или более поздней. Дополнительные сведения см. в разделе Начало работы с Azure CLI.

Затем активируйте управление версиями объектов BLOB в учетных записях хранения источника и назначения и активируйте ленту изменений в исходной учетной записи, вызвав команду az storage account blob-service-properties update. Не забудьте заменить значения в угловых скобках собственными значениями.

az login

az storage account blob-service-properties update \
    --resource-group <resource-group> \
    --account-name <source-storage-account> \
    --enable-versioning \
    --enable-change-feed

az storage account blob-service-properties update \
    --resource-group <resource-group> \
    --account-name <dest-storage-account> \
    --enable-versioning

Создайте исходные и целевые контейнеры в соответствующих учетных записях хранения.

az storage container create \
    --account-name <source-storage-account> \
    --name source-container-1 \
    --auth-mode login
az storage container create \
    --account-name <source-storage-account> \
    --name source-container-2 \
    --auth-mode login

az storage container create \
    --account-name <dest-storage-account> \
    --name dest-container-1 \
    --auth-mode login
az storage container create \
    --account-name <dest-storage-account> \
    --name dest-container-2 \
    --auth-mode login

Создайте новую политику репликации и связанное правило в целевой учетной записи, вызвав az storage account or-policy create.

az storage account or-policy create \
    --account-name <dest-storage-account> \
    --resource-group <resource-group> \
    --source-account <source-storage-account> \
    --destination-account <dest-storage-account> \
    --source-container source-container-1 \
    --destination-container dest-container-1 \
    --min-creation-time '2021-09-01T00:00:00Z' \
    --prefix-match a

Azure Storage задает идентификатор политики для новой политики при его создании. Чтобы добавить дополнительные правила в политику, вызовите az storage account or-policy rule add и укажите идентификатор политики.

az storage account or-policy rule add \
    --account-name <dest-storage-account> \
    --resource-group <resource-group> \
    --source-container source-container-2 \
    --destination-container dest-container-2 \
    --policy-id <policy-id> \
    --prefix-match b

Затем создайте политику в исходной учетной записи с помощью идентификатора политики.

az storage account or-policy show \
    --resource-group <resource-group> \
    --account-name <dest-storage-account> \
    --policy-id <policy-id> |
    az storage account or-policy create --resource-group <resource-group> \
    --account-name <source-storage-account> \
    --policy "@-"

Не применимо

Чтобы настроить репликацию объектов в целевой учетной записи с помощью JSON-файла в Azure portal, выполните следующие действия.

1. Создайте локальный JSON-файл, определяющий политику репликации в целевой учетной записи. Задайте для поля policyId значение default чтобы Azure Storage определить идентификатор политики.

   Простой способ создать JSON-файл, определяющий политику репликации, — сначала создать тестовую политику репликации между двумя учетными записями storage в Azure portal. Затем можно скачать правила репликации и изменить JSON-файл по мере необходимости.

2. Перейдите к параметрам репликации Object для целевой учетной записи в Azure portal.

3. Выберите "Отправить правила репликации".

4. Отправьте JSON-файл. В Azure portal отображаются политики и правила, которые будут созданы, как показано на следующем рисунке.

   

5. Выберите "Отправить ", чтобы создать политику репликации в целевой учетной записи.

Затем можно скачать JSON-файл, содержащий определение политики, которое можно предоставить другому пользователю для настройки исходной учетной записи. Чтобы скачать этот JSON-файл, выполните следующие действия.

1. Перейдите к параметрам репликации Object для целевой учетной записи в Azure portal.

2. Нажмите кнопку "Дополнительно " рядом с политикой, которую вы хотите скачать, а затем выберите "Скачать правила", как показано на следующем рисунке.

   

3. Сохраните JSON-файл на локальном компьютере, чтобы предоставить общий доступ другому пользователю, чтобы настроить политику в исходной учетной записи.

Скачанный JSON-файл содержит идентификатор политики, который Azure Storage создал для этой политики в целевой учетной записи. Для настройки репликации объектов в исходной учетной записи необходимо использовать тот же идентификатор политики.

Помните, что отправка JSON-файла для создания политики репликации для конечной учетной записи через Azure portal не автоматически создает ту же политику в исходной учетной записи. Другой пользователь должен создать политику в исходной учетной записи, прежде чем Azure Storage начнет репликацию объектов.

Чтобы скачать JSON-файл, содержащий определение политики репликации для конечной учетной записи из PowerShell, вызовите команду Get-AzStorageObjectReplicationPolicy, чтобы вернуть политику. Затем преобразуйте политику в JSON и сохраните ее в виде локального файла, как показано в следующем примере. Не забудьте заменить значения в угловых скобках и путь к файлу собственными значениями:

$rgName = "<resource-group>"
$destAccountName = "<destination-storage-account>"

$destPolicy = Get-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName
$destPolicy | ConvertTo-Json -Depth 5 > c:\temp\json.txt

Чтобы использовать JSON-файл для определения политики репликации в исходной учетной записи с помощью PowerShell, извлеките локальный файл и преобразуйте из JSON в объект. Затем вызовите команду Set-AzStorageObjectReplicationPolicy, чтобы настроить политику в исходной учетной записи, как показано в следующем примере.

При выполнении примера обязательно задайте параметр -ResourceGroupName для группы ресурсов исходной учетной записи и параметр -StorageAccountName для имени исходной учетной записи. Кроме того, не забудьте заменить значения в угловых скобках и путь к файлу собственными значениями:

$object = Get-Content -Path C:\temp\json.txt | ConvertFrom-Json
Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -PolicyId $object.PolicyId `
    -SourceAccount $object.SourceAccount `
    -DestinationAccount $object.DestinationAccount `
    -Rule $object.Rules

Чтобы записать определение политики репликации для целевой учетной записи в JSON-файл из Azure CLI, вызовите команду az storage account or-policy show и перенаправьте вывод в файл.

В следующем примере выполняется запись определения политики в JSON-файл с именемpolicy.json. Не забудьте заменить значения в угловых скобках и путь к файлу собственными значениями:

az storage account or-policy show \
    --account-name <dest-account-name> \
    --policy-id  <policy-id> > policy.json

Чтобы использовать JSON-файл для настройки политики репликации в исходной учетной записи с Azure CLI, вызовите команду az storage account or-policy create и наведите ссылку на файл policy.json. Не забудьте заменить значения в угловых скобках и путь к файлу собственными значениями:

az storage account or-policy create \
    -resource-group <resource-group> \
    --source-account <source-account-name> \
    --policy @policy.json

Не применимо

Включите репликацию тегов из раздела репликации объектов при создании правила или обновлении существующих правил, используя столбец репликации тегов.

Чтобы настроить репликацию тегов индекса BLOB-объектов при создании нового правила, выполните следующие действия.

1. Перейдите к учетной записи хранилища в портале Azure.
2. В разделе Data management выберите репликация объектов.
3. Выберите "Создать правила репликации".
4. Выберите "Включить репликацию тегов " и нажмите кнопку "Сохранить" и применить для настройки реплицируемых тегов индекса BLOB-объектов.

Чтобы настроить репликацию тегов индекса BLOB для существующих правил, выполните следующие действия.

1. Перейдите на вкладку "Учетные записи" на странице репликации объектов
2. Выберите параметр "Включить" в столбце репликации тегов в объектах, скопированных из этой таблицы учетной записи , и нажмите кнопку "ОК".
3. Состояние столбца репликации тегов для правила теперь отображается как включено.

Чтобы отключить репликацию тегов индекса BLOB для существующих правил, выполните следующие действия.

1. Перейдите на вкладку "Учетные записи" на странице репликации объектов
2. Выберите существующее правило и выберите "Изменить правила" в меню "…"
3. Отмените выбор параметра разрешить репликацию тегов, а затем выберите Сохранить и применить, чтобы отключить репликацию тегов индекса BLOB-объектов.

N/A.

N/A.

Пользователи могут использовать существующие REST API: Object Replication Policies - Create Or Update - REST API для настройки политик репликации тегов, заданных для Blob-объектов.

Добавьте следующую строку “tagsReplication”: { “enabled”: true } при создании или обновлении правил репликации в исходной учетной записи.

Репликация тегов поддерживается в API версии 2022-05-01 и выше. В политику репликации можно добавить новое поле tagsReplication.

Образец:

{
    "sourceAccount": "<source-account-name>",
    "destinationAccount": "<destination-account-name>",
    "tagsReplication":
    {
     "enabled": true
    },
    "rules":
    [
        {
            "ruleId": "<rule-id>",
            "sourceContainer": "<source-container-name>",
            "destinationContainer": "<destination-container-name>"
        }
    ]
}

Вы можете включить метрики с помощью колонки репликации объектов из нового столбца метрик или изменения раздела "Правила редактирования" политики с "..." в строке политики OR.

Пока не поддерживается.

Пока не поддерживается.

Включение метрик поддерживается в API версии 2021-08-01 и выше. В политику репликации можно добавить новое поле метрик. Образец:

{
    "sourceAccount": "<source-account-name>",
    "destinationAccount": "<destination-account-name>",
    "metrics":
    {
     "enabled": true
    },
    "rules":
    [
        {
            "ruleId": "<rule-id>",
            "sourceContainer": "<source-container-name>",
            "destinationContainer": "<destination-container-name>"
        }
    ]
}

Чтобы проверить состояние репликации для объекта BLOB в исходной учетной записи в портале Azure, выполните следующие шаги.

1. Перейдите к исходной учетной записи в Azure portal.
2. Найдите контейнер, содержащий исходный объект BLOB.
3. Выберите блоб, чтобы отобразить его свойства. Если blob успешно реплицирован, в разделе репликации объектов будет указано состояние Завершено. Идентификатор политики репликации и идентификатор правила, управляющего репликацией объектов для этого контейнера, также перечислены.

Чтобы проверить состояние репликации для объекта BLOB в исходном аккаунте с помощью PowerShell, получите значение свойства ReplicationStatus объектной репликации, как показано в следующем примере. Не забудьте заменить значения в угловых скобках собственными значениями.

$ctxSrc = (Get-AzStorageAccount -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName).Context
$blobSrc = Get-AzStorageBlob -Container $srcContainerName1 `
    -Context $ctxSrc `
    -Blob <blob-name>
$blobSrc.BlobProperties.ObjectReplicationSourceProperties[0].Rules[0].ReplicationStatus

Чтобы проверить состояние репликации для объекта BLOB в исходной учётной записи с Azure CLI, получите значение свойства объекта репликации status, как показано в следующем примере:

az storage blob show \
    --account-name <source-account-name> \
    --container-name <source-container-name> \
    --name <source-blob-name> \
    --query 'objectReplicationSourceProperties[].rules[].status' \
    --output tsv \
    --auth-mode login

Если в учетной записи-источнике состояние репликации BLOB указывает на сбой, исследуйте следующие возможные причины.

• Убедитесь, что в конечной учетной записи настроена политика репликации объектов.
• Убедитесь, что целевой контейнер по-прежнему существует.
• Если исходный блоб был зашифрован с использованием предоставленного клиентом ключа в ходе операции записи, репликация объекта завершится ошибкой. Дополнительные сведения о предоставленных клиентом ключах см. в разделе Предоставление ключа шифрования при запросе в хранилище BLOB.

Не применимо

Чтобы удалить политику репликации в Azure portal, выполните следующие действия.

1. Перейдите к учетной записи хранилища в портале Azure.
2. В разделе "Параметры" выберите репликацию объектов.
3. Нажмите кнопку "Дополнительно" рядом с именем политики.
4. Выберите "Удалить правила".

Чтобы удалить политику репликации, удалите политику как из исходной учетной записи, так и из целевой учетной записи. При удалении политики также удаляются все связанные с ней правила.

# Remove the policy from the destination account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName `
    -PolicyId $destPolicy.PolicyId

# Remove the policy from the source account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -PolicyId $destPolicy.PolicyId

Чтобы удалить политику репликации, удалите политику как из исходной учетной записи, так и из целевой учетной записи. При удалении политики также удаляются все связанные с ней правила.

az storage account or-policy delete \
    --policy-id <policy-id> \
    --account-name <source-storage-account> \
    --resource-group <resource-group>

az storage account or-policy delete \
    --policy-id <policy-id> \
    --account-name <dest-storage-account> \
    --resource-group <resource-group>

Не применимо