Este artigo descreve como configurar um registro de contêiner com redundância de zona.
A redundância de zona é habilitada por padrão para todos os Registros de Contêiner do Azure em regiões que dão suporte a zonas de disponibilidade, tornando seus recursos mais resilientes automaticamente e sem custo adicional. Esse aprimoramento se aplica a todos os SKUs, incluindo Basic e Standard, e foi distribuído para registros novos e existentes em regiões com suporte.
Importante
O portal do Azure e a CLI podem ainda não refletir com precisão a atualização da redundância de zona. A propriedade zoneRedundancy na configuração do registro ainda pode ser mostrada como falsa, mesmo que a redundância de zona esteja ativa para todos os registros em regiões com suporte. Estamos atualizando ativamente as superfícies do portal e da API para refletir esse comportamento padrão de forma mais transparente. Todos os recursos habilitados anteriormente continuarão funcionando conforme o esperado.
Para obter mais informações sobre os requisitos e recursos de suporte da zona de disponibilidade, bem como as opções de implantação de várias regiões, consulte Confiabilidade no Registro de Contêiner do Azure.
Prerequisites
Criar um registro com redundância de zona
Para criar um registro com redundância de zona na camada de serviço Premium, use o portal do Azure, a CLI do Azure ou um arquivo Bicep.
Entre no portal do Azure.
Selecione Criar um recurso>Contêineres>Registro de Contêiner.
Na guia Informações Básicas, selecione ou crie um grupo de recursos e insira um nome de registro único.
No Local, selecione uma região que dê suporte a zonas de disponibilidade, como Leste dos EUA.
Em SKU, selecione Premium.
Em Zonas de disponibilidade, selecione Habilitado.
Opcionalmente, defina mais configurações do registro e, em seguida, selecione Revisar + criar.
Escolha Criar para implantar a instância do Registro.
Verifique se você tem a CLI do Azure versão 2.17.0 ou posterior ou o Azure Cloud Shell. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.
Se você não tiver um grupo de recursos em uma região que dê suporte a zonas de disponibilidade, execute az group create para criar um grupo de recursos (substitua <resource-group-name> e <location> com seus valores):
az group create --name <resource-group-name> --location <location>
Selecione uma região que dê suporte a zonas de disponibilidade, como eastus.
Crie um registro habilitado para zona na camada de serviço Premium executando o comando az acr create (substitua <resource-group-name>, <container-registry-name>e <region-name> com seus valores):
az acr create \
--resource-group <resource-group-name> \
--name <container-registry-name> \
--location <region-name> \
--zone-redundancy enabled \
--sku Premium
Na saída do comando, observe a propriedade zoneRedundancy do registro. Quando zoneRedundancy definido como "Enabled", o registro é redundante por zona:
{
[...]
"zoneRedundancy": "Enabled"
}
Se você não tiver um grupo de recursos em uma região que dê suporte a zonas de disponibilidade, execute az group create para criar um grupo de recursos (substitua <resource-group-name> e <location> com seus valores):
az group create --name <resource-group-name> --location <location>
Para criar um registro com redundância de zona, copie o arquivo Bicep a seguir para um novo arquivo e salve-o usando um nome de arquivo como registryZone.bicep.
Por padrão, o arquivo Bicep habilita a redundância de zona no registro.
@description('Globally unique name of your Azure Container Registry')
@minLength(5)
@maxLength(50)
param containerRegistryName string = 'acr${uniqueString(resourceGroup().id)}'
@description('Location for registry home replica.')
param location string = resourceGroup().location
@description('Enable admin user for registry. This is not recommended for production use.')
param adminUserEnabled bool = false
@description('Enable zone redundancy of registry\'s home replica. Requires the registry\'s region supports availability zones.')
@allowed([
'Enabled'
'Disabled'
])
param containerRegistryZoneRedundancy string = 'Enabled'
// Tier of your Azure Container Registry. Geo-replication and zone redundancy require Premium SKU.
var acrSku = 'Premium'
resource containerRegistry 'Microsoft.ContainerRegistry/registries@2025-04-01' = {
name: containerRegistryName
location: location
sku: {
name: acrSku
}
properties: {
adminUserEnabled: adminUserEnabled
zoneRedundancy: containerRegistryZoneRedundancy
}
}
output containerRegistryLoginServer string = containerRegistry.properties.loginServer
Execute o comando az deployment group create a seguir para criar o registro usando o arquivo de modelo anterior (substitua <resource-group-name> e <registry-name> com seus valores).
Note
Se você implantar o modelo sem parâmetros, ele criará um nome exclusivo para você.
az deployment group create \
--resource-group <resource-group-name> \
--template-file registryZone.json \
--parameters containerRegistryName=<registry-name>