Configurar a replicação de objetos para blobs de bloco
Artigo
A replicação de objetos copia de forma assíncrona blobs de bloco entre uma conta de armazenamento de origem e uma conta de destino. Ao configurar a replicação de objetos, você cria uma política de replicação que especifica a conta de armazenamento de origem e a conta de destino. Uma política de replicação inclui uma ou mais regras que especificam um contêiner de origem e um contêiner de destino e indicam quais blobs de bloco no contêiner de origem serão replicados. Para obter mais informações sobre replicação de objetos, consulte Replicação de objetos para blobs de bloco.
Este artigo descreve como configurar uma política de replicação de objeto usando o portal do Azure, o PowerShell ou a CLI do Azure. Você também pode usar uma das bibliotecas de cliente do provedor de recursos do Armazenamento do Azure para configurar a replicação de objetos.
Pré-requisitos
Antes de configurar a replicação de objetos, crie as contas de armazenamento de origem e de destino, caso ainda não existam. As contas de origem e de destino podem ser contas de armazenamento v2 de uso geral ou contas de blob de bloco premium. Para obter mais informações, consulte Criar uma conta de Armazenamento do Azure.
A replicação de objetos requer que o controle de versão de blob esteja habilitado para a conta de origem e de destino e que o feed de alteração de blob esteja habilitado para a conta de origem. Para saber mais sobre o controle de versão de blob, consulte Controle de versão de Blob. Para saber mais sobre o feed de alterações, consulte Suporte a feeds de alterações no Armazenamento de Blobs do Azure. Tenha em mente que habilitar esses recursos pode resultar em custos adicionais.
Para configurar uma política de replicação de objetos para uma conta de armazenamento, você deve receber a função de Colaborador do Azure Resource Manager, com escopo para o nível da conta de armazenamento ou superior. Para obter mais informações, consulte Funções internas do Azure na documentação do controle de acesso baseado em função do Azure (Azure RBAC).
A replicação de objetos ainda não é suportada em contas que têm um namespace hierárquico habilitado.
Configurar a replicação de objetos com acesso a ambas as contas de armazenamento
Se você tiver acesso às contas de armazenamento de origem e de destino, poderá configurar a política de replicação de objetos em ambas as contas. Os exemplos a seguir mostram como configurar a replicação de objetos com o portal do Azure, o PowerShell ou a CLI do Azure.
Ao configurar a replicação de objetos no portal do Azure, você só precisa configurar a política na conta de origem. O portal do Azure cria automaticamente a política na conta de destino depois de configurá-la para a conta de origem.
Para criar uma política de replicação no portal do Azure, siga estas etapas:
Navegue até a conta de armazenamento de origem no portal do Azure.
Em Gerenciamento de dados, selecione Replicação de objetos.
Selecione Criar regras de replicação.
Selecione a assinatura de destino e a conta de armazenamento.
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. Você pode criar até 10 pares de contêineres por política de replicação no portal do Azure. 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.
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.
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.
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 portal do Azure exibe a política e as regras de replicação, conforme mostrado na imagem a seguir.
Para criar uma política de replicação com o PowerShell, instale primeiro a versão 2.5.0 ou posterior do módulo Az.Storage PowerShell. Para obter mais informações sobre como instalar o Azure PowerShell, consulte Instalar o Azure PowerShell com 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 CLI do Azure, primeiro instale a CLI do Azure versão 2.11.1 ou posterior. Para obter mais informações, consulte Introdução à CLI do Azure.
Em seguida, habilite o controle de versão de blob nas contas de armazenamento de origem e destino e habilite 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 contêineres de origem e destino em suas respetivas contas de armazenamento.
O Armazenamento do Azure define a ID da política para a nova política quando ela é criada. Para adicionar regras adicionais à política, chame a conta de armazenamento az ou a regra de política add e forneça a ID da política.
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 "@-"
Configurar a replicação de objetos usando um arquivo JSON
Se você não tiver permissões para a conta de armazenamento de origem ou se quiser usar mais de 10 pares de contêineres, poderá configurar a replicação de objetos na conta de destino e fornecer um arquivo JSON que contenha a definição de política para outro usuário criar a mesma política na conta de origem. Por exemplo, se a conta de origem estiver em um locatário do Microsoft Entra diferente da conta de destino, você poderá usar essa abordagem para configurar a replicação de objetos.
Para obter informações sobre como criar um arquivo JSON que contém a definição de política, consulte Arquivo de definição de política.
Nota
A replicação de objetos entre locatários é permitida por padrão para uma conta de armazenamento. Para evitar a replicação entre locatários, você pode definir a propriedade AllowCrossTenantReplication para não permitir a replicação de objetos entre locatários para suas contas de armazenamento. Para obter mais informações, consulte Impedir a replicação de objetos entre locatários do Microsoft Entra.
Os exemplos nesta seção mostram como configurar a política de replicação de objeto na conta de destino e, em seguida, obter o arquivo JSON para essa política que outro usuário pode usar para configurar a política na conta de origem.
Para configurar a replicação de objetos na conta de destino com um arquivo JSON no portal do Azure, siga estas etapas:
Crie um arquivo JSON local que defina a política de replicação na conta de destino. Defina o campo policyId como padrão para que o Armazenamento do Azure defina a ID da política.
Uma maneira fácil de criar um arquivo JSON que define uma política de replicação é primeiro criar uma política de replicação de teste entre duas contas de armazenamento no portal do Azure. Em seguida, você pode baixar as regras de replicação e modificar o arquivo JSON conforme necessário.
Navegue até as configurações de replicação de objeto para a conta de destino no portal do Azure.
Selecione Carregar regras de replicação.
Carregue o arquivo JSON. O portal do Azure exibe a política e as regras que serão criadas, conforme mostrado na imagem a seguir.
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:
Navegue até as configurações de replicação de objeto para a conta de destino no portal do Azure.
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.
Salve o arquivo JSON em seu computador local para compartilhar com outro usuário para configurar a política na conta de origem.
O arquivo JSON baixado inclui a ID de política que o Armazenamento do Azure 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.
Lembre-se de que carregar um arquivo JSON para criar uma política de replicação para a conta de destino por meio do portal do Azure não cria automaticamente a mesma política na conta de origem. Outro usuário deve criar a política na conta de origem antes que o Armazenamento do Azure comece a replicar objetos.
Para baixar um arquivo JSON que contém a definição de política de replicação para a conta de destino do PowerShell, chame o comando Get-AzStorageObjectReplicationPolicy para retornar 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:
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. Em seguida, chame o comando Set-AzStorageObjectReplicationPolicy para configurar a política na conta de origem, conforme mostrado no exemplo a seguir.
Ao executar o exemplo, certifique-se de definir o parâmetro para o grupo de recursos para a conta de origem e o parâmetro para o -ResourceGroupName-StorageAccountName 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:
Para gravar a definição de política de replicação para a conta de destino em um arquivo JSON da CLI do Azure, chame o comando az storage account ou policy show e a saída para um arquivo.
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 arquivo JSON para configurar a política de replicação na conta de origem com a CLI do Azure, chame o comando az storage account ou policy create e faça referência ao arquivo policy.json . Lembre-se de substituir os valores entre colchetes angulares e o caminho do arquivo por seus próprios valores:
Você pode verificar o status de replicação de um blob na conta de origem usando o portal do Azure, o PowerShell ou a CLI do Azure. As propriedades de replicação de objetos não são preenchidas até que a replicação tenha sido concluída ou tenha falhado.
Para verificar o status de replicação de um blob na conta de origem no portal do Azure, siga estas etapas:
Navegue até a conta de origem no portal do Azure.
Localize o contêiner que inclui o blob de origem.
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:
Para verificar o status de replicação de um blob na conta de origem com a CLI do Azure, obtenha o valor da propriedade de status de replicação do objeto, conforme mostrado no exemplo a seguir:
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 obter mais informações sobre chaves fornecidas pelo cliente, consulte Fornecer uma chave de criptografia em uma solicitação para armazenamento de Blob.
Remover uma política de replicação
Para remover uma política de replicação e suas regras associadas, use o portal do Azure, o PowerShell ou a CLI.
Para remover uma política de replicação no portal do Azure, siga estas etapas:
Navegue até a conta de armazenamento de origem no portal do Azure.
Em Configurações, selecione Replicação de objetos.
Selecione o botão Mais ao lado do nome da política.
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.
