Configurar a replicação de objetos para blobs de bloco

Quando configuras a replicação de objetos no Azure portal, só precisas de configurar a política na conta de origem. O Azure portal cria automaticamente a política na conta de destino depois de a configurar para a conta de origem.

Para criar uma política de replicação no Azure portal, siga estes passos:

1. Navegue até à conta de armazenamento de origem no Portal do Azure.

2. Em Data management, selecione Object replication.

3. Selecione Criar regras de replicação.

4. Selecione a subscrição de destino e a conta de storage.

5. Na seção Detalhes do par de contêineres , selecione um contêiner de origem da conta de origem e um contêiner de destino da conta de destino. Pode criar até 10 pares de contentores por política de replicação a partir do Azure portal. Para configurar mais de 10 pares de contêineres (até 1000), consulte Configurar a replicação de objetos usando um arquivo JSON.

   A imagem a seguir mostra um conjunto de regras de replicação.

   

6. Se desejar, especifique um ou mais filtros para copiar apenas blobs que correspondam a um padrão de prefixo. Por exemplo, se você especificar um prefixo b, somente os blobs cujo nome comece com essa letra serão replicados. Pode especificar um diretório virtual como parte do prefixo. Você pode adicionar um máximo de até cinco correspondências de prefixo. A cadeia de caracteres de prefixo não suporta caracteres curinga.

   A imagem a seguir mostra filtros que restringem quais blobs são copiados como parte de uma regra de replicação.

   

7. Por padrão, o escopo da cópia é definido para copiar apenas novos objetos. Para copiar todos os objetos no contêiner ou copiar objetos a partir de uma data e hora personalizadas, selecione o link de alteração e configure o escopo de cópia para o par de contêineres.

   A imagem a seguir mostra um escopo de cópia personalizado que copia objetos de uma data e hora especificadas em diante.

   

8. Selecione Salvar e aplicar para criar a política de replicação e começar a replicar dados.

Depois de configurar a replicação de objetos, o Azure portal mostra a política e as regras de replicação, como mostrado na imagem seguinte.

Para criar uma política de replicação com o PowerShell, instale primeiro a versão 2.5.0 ou posterior do módulo PowerShell do Az.Storage. Para mais informações sobre como instalar Azure PowerShell, consulte Install Azure PowerShell with PowerShellGet.

O exemplo a seguir mostra como criar uma política de replicação primeiro na conta de destino e, em seguida, na conta de origem. Lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores:

# 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

Para criar uma política de replicação com a Azure CLI, instale primeiro Azure CLI versão 2.11.1 ou posterior. Para mais informações, veja Get started com Azure CLI.

Em seguida, ative o versionamento do blob nas contas de armazenamento de origem e destino, e ative o feed de alterações na conta de origem, chamando o comando az storage account blob-service-properties update. Lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores:

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

Crie os contentores de origem e destino nas respetivas contas de storage.

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

Crie uma nova política de replicação e uma regra associada na conta de destino chamando o comando 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

O Azure Storage define o ID da política para a nova política quando esta é criada. Para adicionar mais regras à política, utilize o comando az storage account or-policy rule add e forneça o ID da política.

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

Em seguida, crie a política na conta de origem usando a ID da política.

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 "@-"

N/A

Para configurar a replicação de objetos na conta de destino com um ficheiro JSON no Azure portal, siga estes passos:

1. Crie um arquivo JSON local que defina a política de replicação na conta de destino. Defina o campo policyId para default para que Azure Storage defina o ID da política.

   Uma forma fácil de criar um ficheiro JSON que defina uma política de replicação é primeiro criar uma política de replicação de teste entre duas contas de storage no Azure portal. Em seguida, você pode baixar as regras de replicação e modificar o arquivo JSON conforme necessário.

2. Navegue até às definições Object replication para a conta de destino na Azure portal.

3. Selecione Carregar regras de replicação.

4. Carregue o arquivo JSON. O Azure portal mostra a política e as regras que serão criadas, conforme mostrado na imagem seguinte.

   

5. Selecione Carregar para criar a política de replicação na conta de destino.

Em seguida, você pode baixar um arquivo JSON contendo a definição de política que pode ser fornecida a outro usuário para configurar a conta de origem. Para transferir este ficheiro JSON, siga estes passos:

1. Navegue até as configurações de Object replication para a conta de destino no portal do Azure.

2. Selecione o botão Mais ao lado da política que você deseja baixar e, em seguida, selecione Regras de download, conforme mostrado na imagem a seguir.

   

3. Salve o arquivo JSON em seu computador local para compartilhar com outro usuário para configurar a política na conta de origem.

O ficheiro JSON descarregado inclui o ID da política que o Azure Storage criou para a política na conta de destino. Você deve usar a mesma ID de política para configurar a replicação de objetos na conta de origem.

Tenha em mente que carregar um ficheiro JSON para criar uma política de replicação para a conta de destino através do Azure portal não cria automaticamente a mesma política na conta de origem. Outro utilizador deve criar a política na conta de origem antes do Azure Storage começar a replicar objetos.

Para descarregar um ficheiro JSON que contenha a definição da política de replicação para a conta de destino a partir do PowerShell, chame o comando Get-AzStorageObjectReplicationPolicy para devolver a política. Em seguida, converta a política em JSON e salve-a como um arquivo local, conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores entre colchetes angulares e o caminho do arquivo por seus próprios valores:

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

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

Para usar o arquivo JSON para definir a política de replicação na conta de origem com o PowerShell, recupere o arquivo local e converta de JSON em um objeto. Depois, chame o comando Set-AzStorageObjectReplicationPolicy para configurar a política na conta de origem, como mostrado no exemplo seguinte.

Ao executar o exemplo, certifique-se de definir o -ResourceGroupName parâmetro para o grupo de recursos para a conta de origem e o -StorageAccountName parâmetro para o nome da conta de origem. Além disso, lembre-se de substituir valores entre colchetes angulares e o caminho do arquivo por seus próprios valores:

$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

Para escrever a definição da política de replicação para a conta de destino num ficheiro JSON a partir do Azure CLI, execute o comando az storage account or-policy show e direcione a saída para um ficheiro.

O exemplo a seguir grava a definição de política em um arquivo JSON chamado policy.json. Lembre-se de substituir os valores entre colchetes angulares e o caminho do arquivo por seus próprios valores:

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

Para usar o ficheiro JSON para configurar a política de replicação na conta de origem com a Azure CLI, chame o comando az storage account or-policy create e faça referência ao ficheiro policy.json. Lembre-se de substituir os valores entre colchetes angulares e o caminho do arquivo por seus próprios valores:

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

N/A

Ative a replicação de etiquetas a partir da lâmina Object Replication ao criar uma regra ou atualize regras existentes usando a coluna de replicação Tags.

Para configurar etiquetas replicantes de blob index ao criar uma nova regra, siga estes passos:

1. Navegue até à conta de armazenamento de origem no Portal do Azure.
2. Em Data management, selecione Object replication.
3. Selecione Criar regras de replicação.
4. Selecione Ativar replicação de etiquetas e, finalmente, selecione Guardar e aplicar para configurar etiquetas de índice blob replicantes.

Para configurar tags de indexação de blobs replicadas para regras existentes, siga os seguintes passos:

1. Navegue até ao separador As Suas Contas na página de Replicação de Objetos
2. Selecione a opção Ativar na coluna de replicação de etiquetas em Objetos copiados desta tabela de contas e selecione OK.
3. Agora, o estado da coluna de replicação de Tags em relação a uma regra mostra Ativado.

Para desativar a replicação de etiquetas de blob index para regras existentes, siga estes passos:

1. Navegue até ao separador das Suas Contas na página de replicação de objetos
2. Selecione uma regra existente e selecione Editar regras a partir do '...' Menu
3. Desmarcar a opção Ativar a replicação das etiquetas e, finalmente, selecionar Guardar e aplicar para desativar a replicação das etiquetas de índice de blobs.

N/A.

N/A.

Os utilizadores podem usar APIs REST existentes: Políticas de Replicação de Objetos - Criar ou Atualizar - API REST para configurar políticas de replicação de etiquetas definidas nos Blobs.

Adicione a seguinte linha “tagsReplication”: { “enabled”: true } ao criar ou atualizar as regras de replicação na conta de origem.

A replicação de etiquetas é suportada na versão API 2022-05-01 e superior. Pode adicionar o novo campo tagsReplication à política de replicação.

Exemplo:

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

Você pode habilitar métricas usando a folha Replicação de objetos na nova coluna Métricas ou editando a seção Editar regras de uma política em "..." na linha da política OR.

Ainda não suportado.

Ainda não suportado.

A habilitação de métricas é suportada na versão da API 2021-08-01 e superior. Você pode adicionar o novo campo de métricas à política de replicação. Exemplo:

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

Para verificar o estado de replicação de um blob na conta de origem no Azure portal, siga estes passos:

1. Navegue até à conta de origem no Azure portal.
2. Localize o contêiner que inclui o blob de origem.
3. Selecione o blob para exibir suas propriedades. Se o blob tiver sido replicado com êxito, você verá na seção Replicação de objeto que o status está definido como Concluído. A ID da política de replicação e a ID da regra que rege a replicação de objetos para esse contêiner também são listadas.

Para verificar o status de replicação de um blob na conta de origem com o PowerShell, obtenha o valor da propriedade ReplicationStatus de replicação de objeto, conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores:

$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

Para verificar o estado de replicação de um blob na conta de origem com Azure CLI, obtenha o valor da propriedade de replicação do objeto status, como mostrado no seguinte exemplo:

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

Se o status de replicação de um blob na conta de origem indicar falha, investigue as seguintes causas possíveis:

• Verifique se a política de replicação de objetos está configurada na conta de destino.
• Verifique se o contêiner de destino ainda existe.
• Se o blob de origem tiver sido criptografado com uma chave fornecida pelo cliente como parte de uma operação de gravação, a replicação de objeto falhará. Para mais informações sobre chaves fornecidas pelo cliente, consulte Fornecer uma chave de encriptação num pedido a Blob storage.

N/A

Para remover uma política de replicação no Azure portal, siga estes passos:

1. Navegue até à conta de armazenamento de origem no Portal do Azure.
2. Em Configurações, selecione Replicação de objetos.
3. Selecione o botão Mais ao lado do nome da política.
4. Selecione Excluir regras.

Para remover uma política de replicação, exclua-a da conta de origem e da conta de destino. A exclusão da política também exclui todas as regras associadas a ela.

# 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

Para remover uma política de replicação, exclua-a da conta de origem e da conta de destino. A exclusão da política também exclui todas as regras associadas a ela.

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>

N/A