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

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

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

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

2. В разделе "Управление данными" выберите репликацию объектов.

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

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

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

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

   

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

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

   

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

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

   

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

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

Чтобы создать политику репликации с помощью PowerShell, сначала установите версию 2.5.0 или более позднюю версию модуля Az.Storage PowerShell. Дополнительные сведения об установке Azure PowerShell см. в статье Установка 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 задает идентификатор политики для новой политики при его создании. Чтобы добавить дополнительные правила в политику, используйте команду 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, выполните следующие действия.

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

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

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

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

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

   

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

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

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

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

   

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

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

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

Чтобы скачать 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

Не применимо

Вы можете включить метрики с помощью панели репликации объектов из нового столбца метрик или изменения раздела Правила редактирования политики из "..." в строке политики 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>"
        }
    ]
}

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

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

Чтобы проверить состояние репликации для объекта 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, получите значение свойства статуса репликации объекта, как показано в следующем примере:

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, выполните следующие действия.

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>

Не применимо