Este artigo descreve como configurar um registo 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 implementado para registros novos e existentes em regiões suportadas.
Importante
O portal do Azure e a CLI podem ainda não refletir a atualização de redundância de zona com precisão. A zoneRedundancy propriedade na configuração do seu registro ainda pode aparecer como falsa, mesmo que a redundância de zona esteja ativa para todos os registros em regiões suportadas. 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 a funcionar conforme o esperado.
Para obter mais informações sobre os requisitos e recursos de suporte da zona de disponibilidade, bem como opções de implantação de várias regiões, consulte Confiabilidade no Registro de Contêiner do Azure.
Prerequisites
Criar um registo 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.
Inicie sessão no portal do Azure.
Selecione Criar um recurso>Contentores>Container Registry.
Na guia Noções básicas, selecione ou crie um grupo de recursos e insira um nome de registro exclusivo.
Em Local, selecione uma região que ofereça 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 selecione Revisar + criar.
Selecione 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 precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).
Se você não tiver um grupo de recursos em uma região que ofereça 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 ofereça 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, anote a zoneRedundancy propriedade para o registro. Quando zoneRedundancy é definido como "Enabled", o registro é zona redundante:
{
[...]
"zoneRedundancy": "Enabled"
}
Se você não tiver um grupo de recursos em uma região que ofereça 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 seguinte arquivo Bicep para um novo arquivo e salve-o usando um nome de arquivo como registryZone.bicep.
Por padrão, o arquivo Bicep permite 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 seguinte comando az deployment group create para criar o registro usando o arquivo de modelo anterior (substitua <resource-group-name> e <registry-name> por 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>