Merge pull request #286201 from tejaswikolli-web/main

v-shils · web-flow · commit 56493bd5e353 · 2024-09-05T11:28:54.000-07:00
Topic-change
diff --git a/articles/container-registry/allow-access-trusted-services.md b/articles/container-registry/allow-access-trusted-services.md
@@ -1,7 +1,7 @@
 ---
 title: Access network-restricted registry using trusted Azure service
 description: Enable a trusted Azure service instance to securely access a network-restricted container registry to pull or push images 
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.service: azure-container-registry
 ms.author: tejaswikolli
diff --git a/articles/container-registry/authenticate-aks-cross-tenant.md b/articles/container-registry/authenticate-aks-cross-tenant.md
@@ -1,7 +1,7 @@
 ---
 title: Authenticate from AKS cluster to Azure container registry in different AD tenant
 description: Configure an AKS cluster's service principal with permissions to access your Azure container registry in a different AD tenant
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/authenticate-kubernetes-options.md b/articles/container-registry/authenticate-kubernetes-options.md
@@ -1,7 +1,7 @@
 ---
 title: Scenarios to authenticate with Azure Container Registry from Kubernetes 
 description: Overview of options and scenarios to authenticate to an Azure container registry from a Kubernetes cluster to pull container images
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/buffer-gate-public-content.md b/articles/container-registry/buffer-gate-public-content.md
@@ -1,7 +1,7 @@
 ---
 title: Manage public content in private container registry
 description: Practices and workflows in Azure Container Registry to manage dependencies on public images from Docker Hub and other public content
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-access-selected-networks.md b/articles/container-registry/container-registry-access-selected-networks.md
@@ -1,7 +1,7 @@
 ---
 title: Configure public registry access
 description: Configure IP rules to enable access to an Azure container registry from selected public IP addresses or address ranges.
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-api-deprecation.md b/articles/container-registry/container-registry-api-deprecation.md
@@ -1,7 +1,7 @@
 ---
 title: Removed and deprecated features for Azure Container Registry 
 description: This article lists and notifies the features that are deprecated or removed from support for Azure Container Registry.
-ms.topic: article
+ms.topic: conceptual
 ms.date: 10/31/2023
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-auth-aci.md b/articles/container-registry/container-registry-auth-aci.md
@@ -1,7 +1,7 @@
 ---
 title: Access from Container Instances
 description: Learn how to provide access to images in your private container registry from Azure Container Instances by using a Microsoft Entra service principal.
-ms.topic: article
+ms.topic: conceptual
 ms.custom: devx-track-azurecli
 ms.service: azure-container-registry
 author: tejaswikolli-web
diff --git a/articles/container-registry/container-registry-auth-kubernetes.md b/articles/container-registry/container-registry-auth-kubernetes.md
@@ -1,7 +1,7 @@
 ---
 title: Authenticate with an Azure container registry using a Kubernetes pull secret
 description: Learn how to provide a Kubernetes cluster with access to images in your Azure container registry by creating a pull secret using a service principal
-ms.topic: article
+ms.topic: conceptual
 ms.custom: devx-track-azurecli
 ms.service: azure-container-registry
 author: karolz-ms
diff --git a/articles/container-registry/container-registry-auth-service-principal.md b/articles/container-registry/container-registry-auth-service-principal.md
@@ -1,7 +1,7 @@
 ---
 title: Authenticate with service principal
 description: Provide access to images in your private container registry by using a Microsoft Entra service principal.
-ms.topic: article
+ms.topic: conceptual
 ms.custom: devx-track-azurecli
 ms.service: azure-container-registry
 author: tejaswikolli-web
diff --git a/articles/container-registry/container-registry-authentication-managed-identity.md b/articles/container-registry/container-registry-authentication-managed-identity.md
@@ -1,7 +1,7 @@
 ---
 title: Authenticate with managed identity
 description: Provide access to images in your private container registry by using a user-assigned or system-assigned managed Azure identity.
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli, devx-track-azurepowershell, linux-related-content
 author: tejaswikolli-web
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-authentication.md b/articles/container-registry/container-registry-authentication.md
@@ -1,7 +1,7 @@
 ---
 title: Registry authentication options
 description: Authentication options for a private Azure container registry, including signing in with a Microsoft Entra identity, using service principals, and using optional admin credentials.
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-auto-purge.md b/articles/container-registry/container-registry-auto-purge.md
@@ -1,7 +1,7 @@
 ---
 title: Purge tags and manifests
 description: Use a purge command to delete multiple tags and manifests from an Azure container registry based on age and a tag filter, and optionally schedule purge operations.
-ms.topic: article
+ms.topic: how-to
 ms.service: azure-container-registry
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
diff --git a/articles/container-registry/container-registry-azure-policy.md b/articles/container-registry/container-registry-azure-policy.md
@@ -1,7 +1,7 @@
 ---
 title: Compliance using Azure Policy
 description: Assign built-in policy definitions in Azure Policy to audit compliance of your Azure container registries
-ms.topic: article
+ms.topic: conceptual
 ms.service: azure-container-registry
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-best-practices.md b/articles/container-registry/container-registry-best-practices.md
@@ -1,7 +1,7 @@
 ---
 title: Registry best practices
 description: Learn how to use your Azure container registry effectively by following these best practices.
-ms.topic: article
+ms.topic: best-practice
 ms.service: azure-container-registry
 author: tejaswikolli-web
 ms.author: tejaswikolli
@@ -18,7 +18,7 @@ For background on registry concepts, see [About registries, repositories, and im
 
 Create your container registry in the same Azure region in which you deploy containers. Placing your registry in a region that is network-close to your container hosts can help lower both latency and cost.
 
-Network-close deployment is one of the primary reasons for using a private container registry. Docker images have an efficient [layering construct](https://docs.docker.com/engine/userguide/storagedriver/imagesandcontainers/) that allows for incremental deployments. However, new nodes need to pull all layers required for a given image. This initial `docker pull` can quickly add up to multiple gigabytes. Having a private registry close to your deployment minimizes the network latency.
+Network-close deployment is one of the primary reasons for using a private container registry. Docker images have an efficient [layering construct](https://docs.docker.com/get-started/docker-concepts/building-images/understanding-image-layers/) that allows for incremental deployments. However, new nodes need to pull all layers required for a given image. This initial `docker pull` can quickly add up to multiple gigabytes. Having a private registry close to your deployment minimizes the network latency.
 Additionally, all public clouds, Azure included, implement network egress fees. Pulling images from one datacenter to another adds network egress fees, in addition to the latency.
 
 ## Geo-replicate multi-region deployments
diff --git a/articles/container-registry/container-registry-check-health.md b/articles/container-registry/container-registry-check-health.md
@@ -1,7 +1,7 @@
 ---
 title: Check registry health
 description: Learn how to run a quick diagnostic command to identify common problems when using an Azure container registry, including local Docker configuration and connectivity to the registry
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli
 ms.service: azure-container-registry
 author: tejaswikolli-web
diff --git a/articles/container-registry/container-registry-concepts.md b/articles/container-registry/container-registry-concepts.md
@@ -1,7 +1,7 @@
 ---
 title: About registries, repositories, images, and artifacts
 description: Introduction to key concepts of Azure container registries, repositories, container images, and other artifacts.
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-dedicated-data-endpoints.md b/articles/container-registry/container-registry-dedicated-data-endpoints.md
@@ -1,7 +1,7 @@
 ---
 title: Mitigate data exfiltration with dedicated data endpoints
 description: Azure Container Registry is introducing dedicated data endpoints available to mitigate data-exfiltration concerns.
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-delete.md b/articles/container-registry/container-registry-delete.md
@@ -1,7 +1,7 @@
 ---
 title: Delete image resources
 description: Details on how to effectively manage registry size by deleting container image data using Azure CLI commands.
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-event-grid-quickstart.md b/articles/container-registry/container-registry-event-grid-quickstart.md
@@ -1,7 +1,7 @@
 ---
 title: Quickstart - Send events to Event Grid
 description: In this quickstart, you enable Event Grid events for your container registry, then send container image push and delete events to a sample application.
-ms.topic: article
+ms.topic: quickstart
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-firewall-access-rules.md b/articles/container-registry/container-registry-firewall-access-rules.md
@@ -1,7 +1,7 @@
 ---
 title: Firewall access rules
 description: Configure rules to access an Azure container registry from behind a firewall, by allowing access to REST API and data endpoint domain names or service-specific IP address ranges.
-ms.topic: article
+ms.topic:  reference
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-geo-replication.md b/articles/container-registry/container-registry-geo-replication.md
@@ -2,7 +2,7 @@
 title: Geo-replicate a registry
 description: Get started creating and managing a geo-replicated Azure container registry, which enables the registry to serve multiple regions with multi-primary regional replicas. Geo-replication is a feature of the Premium service tier.
 author: tejaswikolli-web
-ms.topic: article
+ms.topic: how-to
 ms.author: tejaswikolli
 ms.service: azure-container-registry
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-get-started-docker-cli.md b/articles/container-registry/container-registry-get-started-docker-cli.md
@@ -1,7 +1,7 @@
 ---
 title: Push & pull container image
 description: Push and pull Docker images to your private container registry in Azure using the Docker CLI
-ms.topic: article
+ms.topic: how-to
 ms.date: 10/31/2023
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-health-error-reference.md b/articles/container-registry/container-registry-health-error-reference.md
@@ -1,7 +1,7 @@
 ---
 title: Error reference for registry health checks
 description: Error codes and possible solutions to problems found by running the az acr check-health diagnostic command in Azure Container Registry
-ms.topic: article
+ms.topic: reference
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-helm-repos.md b/articles/container-registry/container-registry-helm-repos.md
@@ -1,7 +1,7 @@
 ---
 title:  Store Helm charts
 description: Learn how to store Helm charts for your Kubernetes applications using repositories in Azure Container Registry
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-image-formats.md b/articles/container-registry/container-registry-image-formats.md
@@ -1,7 +1,7 @@
 ---
 title: Supported content formats
 description: Learn about content formats supported by Azure Container Registry, including Docker-compatible container images, Helm charts, OCI images, and OCI artifacts.
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-image-lock.md b/articles/container-registry/container-registry-image-lock.md
@@ -1,7 +1,7 @@
 ---
 title: Lock images
 description: Set attributes for a container image or repository so it can't be deleted or overwritten in an Azure container registry.
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-image-tag-version.md b/articles/container-registry/container-registry-image-tag-version.md
@@ -2,7 +2,7 @@
 title: Image tag best practices
 description: Best practices for tagging and versioning Docker container images when pushing images to and pulling images from an Azure container registry
 author: tejaswikolli-web
-ms.topic: article
+ms.topic: best-practice
 ms.date: 10/31/2023
 ms.author: tejaswikolli
 ms.service: azure-container-registry
diff --git a/articles/container-registry/container-registry-import-images.md b/articles/container-registry/container-registry-import-images.md
@@ -1,7 +1,7 @@
 ---
 title: Import container images
 description: Import container images to an Azure container registry by using Azure APIs, without needing to run Docker commands.
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-private-link.md b/articles/container-registry/container-registry-private-link.md
@@ -1,7 +1,7 @@
 ---
 title: Set up private endpoint with private link
 description: Set up a private endpoint on a container registry and enable access over a private link in a local virtual network. Private link access is a feature of the Premium service tier.
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-repositories.md b/articles/container-registry/container-registry-repositories.md
@@ -1,7 +1,7 @@
 ---
 title: View repositories in portal
 description: Use the Azure portal to view Azure Container Registry repositories, which host Docker container images and other supported artifacts.
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-repository-scoped-permissions.md b/articles/container-registry/container-registry-repository-scoped-permissions.md
@@ -1,7 +1,7 @@
 ---
 title: Permissions to repositories in Azure Container Registry
 description: Create a token to grant and manage repository scoped permissions within a container registry. The token helps to perform actions, such as pull images, push images, delete images, read metadata, and write metadata.
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-retention-policy.md b/articles/container-registry/container-registry-retention-policy.md
@@ -1,7 +1,7 @@
 ---
 title: Policy to retain untagged manifests
 description: Learn how to enable a retention policy in your Premium Azure container registry, for automatic deletion of untagged manifests after a defined period.
-ms.topic: article
+ms.topic: conceptual
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-roles.md b/articles/container-registry/container-registry-roles.md
@@ -1,7 +1,7 @@
 ---
 title: Registry roles and permissions
 description: Use Azure role-based access control (Azure RBAC) and identity and access management (IAM) to provide fine-grained permissions to resources in an Azure container registry.
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-skus.md b/articles/container-registry/container-registry-skus.md
@@ -1,7 +1,7 @@
 ---
 title: Registry service tiers and features
 description: Learn about the features and limits (quotas) in the Basic, Standard, and Premium service tiers (SKUs) of Azure Container Registry.
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-support-policies.md b/articles/container-registry/container-registry-support-policies.md
@@ -1,7 +1,7 @@
 ---
 title: Azure Container Registry technical support policies
 description: Learn about Azure Container Registry (ACR) technical support policies
-ms.topic: article
+ms.topic: conceptual
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-task-run-template.md b/articles/container-registry/container-registry-task-run-template.md
@@ -1,7 +1,7 @@
 ---
 title: Quick task run with template
 description: Queue an ACR task run to build an image using an Azure Resource Manager template
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli, devx-track-arm-template
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-tasks-authentication-key-vault.md b/articles/container-registry/container-registry-tasks-authentication-key-vault.md
@@ -1,7 +1,7 @@
 ---
 title: External authentication from ACR task
 description: Configure an Azure Container Registry Task (ACR Task) to read Docker Hub credentials stored in an Azure key vault, by using a managed identity for Azure resources.
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-tasks-authentication-managed-identity.md b/articles/container-registry/container-registry-tasks-authentication-managed-identity.md
@@ -4,7 +4,7 @@ description: Enable a managed identity for Azure Resources in an Azure Container
 services: container-registry
 ms.service: azure-container-registry
 ms.custom: devx-track-azurecli
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-tasks-base-images.md b/articles/container-registry/container-registry-tasks-base-images.md
@@ -1,7 +1,7 @@
 ---
 title: Base image updates - Tasks
 description: Learn about base images for application container images, and about how a base image update can trigger an Azure Container Registry task.
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-tasks-cross-registry-authentication.md b/articles/container-registry/container-registry-tasks-cross-registry-authentication.md
@@ -1,7 +1,7 @@
 ---
 title: Cross-registry authentication from ACR task
 description: Configure an Azure Container Registry Task (ACR Task) to access another private Azure container registry by using a managed identity for Azure resources
-ms.topic: article
+ms.topic: how-to
 ms.custom: devx-track-azurecli
 author: tejaswikolli-web
 ms.author: tejaswikolli
diff --git a/articles/container-registry/container-registry-tasks-logs.md b/articles/container-registry/container-registry-tasks-logs.md
@@ -1,7 +1,7 @@
 ---
 title: View task run logs - Tasks
 description: How to view and manage run logs generated by ACR Tasks.
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-tasks-multi-step.md b/articles/container-registry/container-registry-tasks-multi-step.md
@@ -1,7 +1,7 @@
 ---
 title: Multi-step task to build, test & patch image
 description: Introduction to multi-step tasks, a feature of ACR Tasks in Azure Container Registry that provides task-based workflows for building, testing, and patching container images in the cloud.
-ms.topic: article
+ms.topic: how-to
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 10/31/2023
diff --git a/articles/container-registry/container-registry-tasks-overview.md b/articles/container-registry/container-registry-tasks-overview.md
@@ -1,7 +1,7 @@
 ---
 title: Overview of Azure Container Registry tasks
 description: Learn about Azure Container Registry tasks, a suite of features that provide automated building, management, and patching of container images in the cloud.
-ms.topic: article
+ms.topic: overview
 author: tejaswikolli-web
 ms.author: tejaswikolli
 ms.date: 01/24/2024
diff --git a/articles/container-registry/container-registry-tasks-pack-build.md b/articles/container-registry/container-registry-tasks-pack-build.md
diff --git a/articles/container-registry/container-registry-tasks-samples.md b/articles/container-registry/container-registry-tasks-samples.md
diff --git a/articles/container-registry/container-registry-tasks-scheduled.md b/articles/container-registry/container-registry-tasks-scheduled.md
diff --git a/articles/container-registry/container-registry-transfer-cli.md b/articles/container-registry/container-registry-transfer-cli.md
diff --git a/articles/container-registry/container-registry-transfer-images.md b/articles/container-registry/container-registry-transfer-images.md
diff --git a/articles/container-registry/container-registry-transfer-prerequisites.md b/articles/container-registry/container-registry-transfer-prerequisites.md
diff --git a/articles/container-registry/container-registry-transfer-troubleshooting.md b/articles/container-registry/container-registry-transfer-troubleshooting.md
diff --git a/articles/container-registry/container-registry-troubleshoot-access.md b/articles/container-registry/container-registry-troubleshoot-access.md
diff --git a/articles/container-registry/container-registry-troubleshoot-login.md b/articles/container-registry/container-registry-troubleshoot-login.md
diff --git a/articles/container-registry/container-registry-troubleshoot-performance.md b/articles/container-registry/container-registry-troubleshoot-performance.md
diff --git a/articles/container-registry/container-registry-vnet.md b/articles/container-registry/container-registry-vnet.md
diff --git a/articles/container-registry/container-registry-webhook-reference.md b/articles/container-registry/container-registry-webhook-reference.md
diff --git a/articles/container-registry/container-registry-webhook.md b/articles/container-registry/container-registry-webhook.md
diff --git a/articles/container-registry/push-multi-architecture-images.md b/articles/container-registry/push-multi-architecture-images.md
diff --git a/articles/container-registry/scan-images-defender.md b/articles/container-registry/scan-images-defender.md
diff --git a/articles/container-registry/tasks-agent-pools.md b/articles/container-registry/tasks-agent-pools.md
diff --git a/articles/container-registry/tasks-consume-public-content.md b/articles/container-registry/tasks-consume-public-content.md
diff --git a/articles/container-registry/troubleshoot-artifact-cache.md b/articles/container-registry/troubleshoot-artifact-cache.md
diff --git a/articles/container-registry/zone-redundancy.md b/articles/container-registry/zone-redundancy.md
