Skip to content

Commit baa3460

Browse files
fix acronlinx score
1 parent 80b74d3 commit baa3460

File tree

1 file changed

+21
-21
lines changed

1 file changed

+21
-21
lines changed

articles/reliability/reliability-container-registry.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Azure Container Registry is a managed container registry service used to store a
2121

2222
[!INCLUDE [Shared responsibility](includes/reliability-shared-responsibility-include.md)]
2323

24-
Microsoft manages the underlying Azure Container Registry infrastructure, including the distributed service architecture, storage layer redundancy, automatic zone and geo-replication, and failover mechanisms. This includes maintaining the control plane for registry management and the data plane for container image operations across regions and availability zones.
24+
Microsoft manages the underlying Azure Container Registry infrastructure, including maintaining the control plane for registry management and the data plane for container image operations across regions and availability zones.
2525

2626
As a customer, you're responsible for:
2727

@@ -43,7 +43,7 @@ Azure Container Registry is built as a distributed service with distinct control
4343

4444
## Zone redundancy reliability
4545

46-
Azure Container Registry provides zone redundancy within regions to protect against zone-level failures. This section provides an overview of zone redundancy capabilities, with detailed configuration and operational information in the [Availability zone support](#availability-zone-support) section below.
46+
Azure Container Registry provides zone redundancy within regions to protect against zone-level failures. This section provides an overview of zone redundancy capabilities, with detailed configuration and operational information in the [Availability zone support](#availability-zone-support) section.
4747

4848
## Production deployment recommendations
4949

@@ -59,13 +59,13 @@ Azure Container Registry handles transient faults internally through several mec
5959

6060
For client applications using Azure Container Registry, implement appropriate retry policies with exponential backoff when performing registry operations. Use the official Docker client or Azure Container Registry SDKs which include built-in retry mechanisms for common transient failures.
6161

62-
When using geo-replicated registries, implement failover logic in your applications to automatically switch to alternative registry endpoints if the primary endpoint becomes temporarily unavailable. This provides additional resilience against transient faults that might affect a specific regional endpoint.
62+
When using geo-replicated registries, implement failover logic in your applications to automatically switch to alternative registry endpoints if the primary endpoint becomes temporarily unavailable. Geo-replication provides resilience against transient faults that might affect a specific regional endpoint.
6363

6464
## Availability zone support
6565

6666
[!INCLUDE [AZ support description](includes/reliability-availability-zone-description-include.md)]
6767

68-
Azure Container Registry only supports zone-redundant deployments using the Premium tier. When you create a Premium registry in a region that supports availability zones zone redundancy is enabled by default, which allows for the distributing of registry data and operations across multiple availability zones within the region.
68+
Azure Container Registry only supports zone-redundant deployments using the Premium tier. When you create a Premium registry in a region that supports availability zones the zone redundancy feature is enabled by default. Zone redundancy allows for the distributing of registry data and operations across multiple availability zones within the region.
6969

7070
Zone redundancy in Azure Container Registry protects your container images and artifacts against zone-level failures. The service automatically replicates data across multiple zones and can continue operating even if one availability zone becomes unavailable. Zone redundancy provides higher availability compared to single-zone deployments without requiring configuration changes to your container workloads.
7171

@@ -74,30 +74,30 @@ For the most current list of regions with availability zone support, see [Azure
7474

7575
### Requirements
7676

77-
You must use the Premium tier to enable zone redundancy. Zone redundancy is automatically enabled when you create a Premium registry in a region that supports availability zones - no additional configuration is required.
77+
You must use the Premium tier to enable zone redundancy. Zone redundancy is automatically enabled when you create a Premium registry in a region that supports availability zones - no configuration is required.
7878

7979
### Considerations
8080

8181
Zone redundancy in Azure Container Registry provides protection against single zone failures. Container image pulls and pushes continue to function during zone outages with automatic failover to healthy zones.
8282

83-
When using geo-replication with zone-redundant registries, each geo-replicated region can independently have zone redundancy enabled if the region supports availability zones, providing both zone-level and region-level protection.
83+
When you use geo-replication, each geo-replicated region can independently have zone redundancy enabled at the time of creation if the region supports availability zones, providing both zone-level and region-level protection.
8484

8585
### Cost
8686

87-
Zone redundancy is included with Premium tier registries at no additional cost. The Premium tier is priced higher than Basic and Standard tiers, but zone redundancy itself does not incur additional charges beyond the Premium tier pricing.
87+
Zone redundancy is included with Premium tier registries at no additional cost. The Premium tier is priced higher than Basic and Standard tiers, but zone redundancy itself doesn't incur additional charges beyond the Premium tier pricing.
8888

8989
### Configure availability zone support
9090

9191
Zone redundancy is automatically enabled when you create a Premium registry in a region that supports availability zones, as mentioned in the Requirements section above.
9292

9393
- **Create**. Use the Azure portal, Azure CLI, Azure PowerShell, or ARM templates to create Premium registries. For configuration details, see [Create a container registry using the Azure portal](/azure/container-registry/container-registry-get-started-portal).
94-
- **Disable**. Zone redundancy cannot be disabled once enabled for a registry. If you need a non-zone-redundant registry, you must create a new registry and migrate your container images.
95-
- **Migrate**. Existing Basic or Standard tier registries can be upgraded to Premium tier, however upgrading alone does not enable zone redundancy for existing registries. To get zone redundancy, you must create a new Premium registry in a supported region and migrate your container images. Migrating SKUs will require migrating registry artifacts, which you can do by following [creating a transfer pipeline](/azure/container-registry/container-registry-transfer-prerequisites) or via [importing](azure/container-registry/container-registry-import-images).
94+
- **Disable**. Zone redundancy can't be disabled once enabled for a registry. If you need a non-zone-redundant registry, you must create a new registry and migrate your container images.
95+
- **Migrate**. Existing Basic or Standard tier registries can be upgraded to Premium tier, however upgrading alone doesn't enable zone redundancy for existing registries. To get zone redundancy, you must create a new Premium registry in a supported region and migrate your container images. Migrating SKUs requires migrating registry artifacts, which you can do by following [creating a transfer pipeline](/azure/container-registry/container-registry-transfer-prerequisites) or via [importing](azure/container-registry/container-registry-import-images).
9696

9797
**Important limitations**:
98-
- Converting to zone redundancy is not currently supported
99-
- Zone redundancy cannot be disabled once enabled in a region
100-
- The availability zone property is per region and cannot be changed once replications are created, except by deleting and re-creating the replications
98+
- Converting to zone redundancy isn't currently supported
99+
- Zone redundancy can't be disabled once enabled in a region
100+
- The availability zone property is per region and can't be changed once replications are created, except by deleting and re-creating the replications
101101

102102
### Normal operations
103103

@@ -127,13 +127,13 @@ When the affected availability zone recovers, Azure Container Registry automatic
127127

128128
### Testing for zone failures
129129

130-
Zone failover is fully automated and managed by Microsoft. Customers cannot simulate zone failures, but the service is designed to automatically handle zone failures without impacting registry availability or data integrity for data plane operations.
130+
Zone failover is fully automated and managed by Microsoft. Customers can't simulate zone failures, but the service is designed to automatically handle zone failures without impacting registry availability or data integrity for data plane operations.
131131

132132
## Multi-region reliability
133133

134134
Azure Container Registry provides native multi-region support through geo-replication in the Premium tier. Geo-replication creates registry replicas in multiple regions of your choice, enabling local access to container images and reducing latency for globally distributed applications. For comprehensive details, see [Geo-replication in Azure Container Registry](/azure/container-registry/container-registry-geo-replication).
135135

136-
Unlike many Azure services, Container Registry geo-replication does not use Azure paired regions. You have complete flexibility to select any combination of Azure regions for replication based on your specific geographic, performance, and compliance requirements. Each geo-replicated registry functions as a complete registry endpoint, supporting all registry operations including image pushes, pulls, and management tasks.
136+
Unlike many Azure services, Container Registry geo-replication doesn't use Azure paired regions. You have complete flexibility to select any combination of Azure regions for replication based on your specific geographic, performance, and compliance requirements. Each geo-replicated registry functions as a complete registry endpoint, supporting all registry operations including image pushes, pulls, and management tasks.
137137

138138
Geo-replication automatically synchronizes container images and artifacts across all configured regions using asynchronous replication with eventual consistency. The service uses content-addressable storage to efficiently replicate only the unique image layers, minimizing bandwidth usage and replication time. Data plane operations (push and pull) are automatically routed using Traffic Manager with performance-based criteria to determine the optimal regional endpoint for performance.
139139

@@ -161,7 +161,7 @@ You must use the Premium tier to enable geo-replication. Geo-replication can be
161161

162162
Each geo-replicated region functions as an independent registry endpoint that supports read and write operations. Container clients can connect to any regional endpoint for registry operations.
163163

164-
Geo-replication provides eventual consistency across regions using asynchronous replication. There is no SLA on data replication timing, and replication typically completes within minutes of changes. Large container images or high-frequency updates may take longer to replicate across all regions.
164+
Geo-replication provides eventual consistency across regions using asynchronous replication. There's no SLA on data replication timing, and replication typically completes within minutes of changes. Large container images or high-frequency updates may take longer to replicate across all regions.
165165

166166
### Cost
167167

@@ -172,8 +172,8 @@ Each geo-replicated region is billed separately according to Premium tier pricin
172172
Geo-replication can be configured through the Azure portal, Azure CLI, Azure PowerShell, or ARM templates.
173173

174174
- **Enable**. Configure geo-replication after registry creation by specifying additional regions on container registries using the Premium SKU.
175-
- **Disable**. Remove individual regional replicas through the Azure portal or command-line tools. The home region registry cannot be removed.
176-
- **Migrate**. Upgrade existing Basic or Standard tier registries to Premium tier to enable geo-replication capabilities.
175+
- **Disable**. Remove individual regional replicas through the Azure portal or command-line tools. The home region registry can't be removed.
176+
- **Migrate**. To enanble geo-replication you need to upgrade existing Basic or Standard tier registries to Premium tier.
177177

178178
### Normal operations
179179

@@ -186,8 +186,8 @@ Container Registry operates in an active-active configuration where each regiona
186186
### Region-down experience
187187

188188
Data plane operations automatically route to available regions using Traffic Manager. Configure health checks and failover logic in your container orchestration platforms for application-level resilience.
189-
- **Active requests**. Active requests to an unavailable region will automatically reroute to alternative regional endpoints via automatic Traffic Manager routing.
190-
- **Expected data loss**. No data loss occurs as registry data is replicated across multiple regions. Recent changes that have not yet replicated may be temporarily unavailable due to eventual consistency.
189+
- **Active requests**. Active requests to an unavailable region are automatically rerouted to alternative regional endpoints via automatic Traffic Manager routing.
190+
- **Expected data loss**. No data loss occurs as registry data is replicated across multiple regions. Recent changes that haven't yet replicated may be temporarily unavailable due to eventual consistency.
191191
- **Expected downtime**. No downtime for data plane operations when using alternative regional endpoints. Applications benefit from automatic Traffic Manager routing to available regions.
192192
- **Traffic rerouting**. Traffic Manager automatically reroutes data plane traffic to available regional endpoints when a region becomes unavailable.
193193

@@ -197,7 +197,7 @@ When a region recovers, data plane operations automatically resume for that regi
197197

198198
### Testing for region failures
199199

200-
Regional failover for data plane operations is fully automated through Traffic Manager and cannot be simulated by customers. The service is designed to automatically handle regional failures without impacting registry availability or data integrity for data plane operations.
200+
Regional failover for data plane operations is fully automated through Traffic Manager and can't be simulated by customers. The service is designed to automatically handle regional failures without impacting registry availability or data integrity for data plane operations.
201201

202202
## Backups
203203

@@ -257,7 +257,7 @@ Key SLA considerations:
257257
- **Coverage**: The SLA applies to all Basic, Standard, and Premium tier registries
258258
- **Zone redundancy**: Premium tier with zone redundancy provides enhanced availability but follows the same SLA percentage
259259
- **Geo-replication**: Each regional replica is covered by the SLA independently for registry availability
260-
- **Data replication**: There is no SLA on data replication timing between regions or zones
260+
- **Data replication**: There's no SLA on data replication timing between regions or zones
261261
- **Service credits**: Available when uptime falls below 99.9% (10% credit) or 99% (25% credit)
262262

263263
The specific availability percentages, downtime calculations, and conditions that must be met to achieve the SLA guarantees are detailed in the official service-level agreement documentation. For complete SLA terms and conditions, see [SLA for Azure Container Registry](https://azure.microsoft.com/support/legal/sla/container-registry/).

0 commit comments

Comments
 (0)