Merge pull request #56650 from dlepow/acr2

ACR: Add image formats article

Author: Ja-Dunn

articles/container-registry/TOC.yml

@@ -39,6 +39,8 @@
     href: container-registry-skus.md
   - name: Image storage
     href: container-registry-storage.md
+  - name: Content formats
+    href: container-registry-image-formats.md
   - name: Geo-replication
     href: container-registry-geo-replication.md
   - name: Registry best practices

articles/container-registry/container-registry-image-formats.md

@@ -0,0 +1,41 @@
+---
+title: Azure Container Registry content formats
+description: Learn about supported content formats in Azure Container Registry.
+services: container-registry
+author: dlepow
+manager: jeconnoc
+
+ms.service: container-registry
+ms.topic: article
+ms.date: 10/31/2018
+ms.author: danlep
+---
+
+# Content formats supported in Azure Container Registry
+
+Use a private repository in Azure Container Registry to manage one of the following content formats. 
+
+## Docker-compatible container images
+
+* [Docker Image Manifest V2, Schema 1](https://docs.docker.com/registry/spec/manifest-v2-1/)
+
+* [Docker Image Manifest V2, Schema 2](https://docs.docker.com/registry/spec/manifest-v2-2/) - includes Manifest Lists which allow registries to store multiplatform images under a single "image:tag" reference
+
+* [Open Container Initiative (OCI) Image Format Specification](https://github.com/opencontainers/image-spec/blob/master/spec.md) 
+
+
+## Helm charts
+
+Azure Container Registry can also host repositories for [Helm charts](https://helm.sh/), a packaging format used to quickly manage and deploy applications for Kubernetes. [Helm client](https://docs.helm.sh/using_helm/#installing-helm) version 2.11.0 or later is supported.
+
+## Next steps
+
+* See how to [push and pull](container-registry-get-started-docker-cli.md) images with Azure Container Registry.
+
+* Use [ACR tasks](container-registry-tasks-overview.md) to build and test container images. 
+
+* Use the [Moby BuildKit](https://github.com/moby/buildkit) to build and package containers in OCI format.
+
+* Set up a [Helm repository](container-registry-helm-repos.md) hosted in Azure Container Registry. 
+
+

articles/container-registry/container-registry-intro.md

@@ -25,7 +25,7 @@ Pull images from an Azure container registry to various deployment targets:
 * **Scalable orchestration systems** that manage containerized applications across clusters of hosts, including [Kubernetes](http://kubernetes.io/docs/), [DC/OS](https://docs.mesosphere.com/), and [Docker Swarm](https://docs.docker.com/swarm/).
 * **Azure services** that support building and running applications at scale, including [Azure Kubernetes Service (AKS)](../aks/index.yml), [App Service](../app-service/index.yml), [Batch](../batch/index.yml), [Service Fabric](/azure/service-fabric/), and others.
 
-Developers can also push to a container registry as part of a container development workflow. For example, target a container registry from a continuous integration and deployment tool such as [Azure DevOps Services](https://www.visualstudio.com/docs/overview) or [Jenkins](https://jenkins.io/).
+Developers can also push to a container registry as part of a container development workflow. For example, target a container registry from a continuous integration and deployment tool such as [Azure DevOps Services](https://docs.microsoft.com/azure/devops/) or [Jenkins](https://jenkins.io/).
 
 Configure [ACR Tasks](#azure-container-registry-build) to automatically rebuild application images when their base images are updated. Use ACR Tasks to automate image builds when your team commits code to a Git repository.
 
@@ -35,13 +35,13 @@ Configure [ACR Tasks](#azure-container-registry-build) to automatically rebuild
 
   You [control access](container-registry-authentication.md) to a container registry using an Azure Active Directory-backed [service principal](../active-directory/develop/app-objects-and-service-principals.md) or a provided admin account. Run the standard `docker login` command to authenticate with a registry.
 
-* **Repository** - A registry contains one or more repositories, which are groups of container images. Azure Container Registry supports multilevel repository namespaces. With multilevel namespaces, you can group collections of images related to a specific app, or a collection of apps to specific development or operational teams. For example:
+* **Repository** - A registry contains one or more repositories, which store groups of container images. Azure Container Registry supports multilevel repository namespaces. With multilevel namespaces, you can group collections of images related to a specific app, or a collection of apps to specific development or operational teams. For example:
 
   * `myregistry.azurecr.io/aspnetcore:1.0.1` represents a corporate-wide image
   * `myregistry.azurecr.io/warrantydept/dotnet-build` represents an image used to build .NET apps, shared across the warranty department
   * `myregistry.azurecr.io/warrantydept/customersubmissions/web` represents a web image, grouped in the customer submissions app, owned by the warranty department
 
-* **Image** - Stored in a repository, each image is a read-only snapshot of a Docker container. Azure container registries can include both Windows and Linux images. You control image names for all your container deployments. Use standard [Docker commands](https://docs.docker.com/engine/reference/commandline/) to push images into a repository, or pull an image from a repository.
+* **Image** - Stored in a repository, each image is a read-only snapshot of a Docker-compatible container. Azure container registries can include both Windows and Linux images. You control image names for all your container deployments. Use standard [Docker commands](https://docs.docker.com/engine/reference/commandline/) to push images into a repository, or pull an image from a repository. In addition to container images, Azure Container Registry stores [related content formats](container-registry-image-formats.md) such as [Helm charts](container-registry-helm-repos.md), used to deploy applications to Kubernetes.
 
 * **Container** - A container defines a software application and its dependencies wrapped in a complete filesystem including code, runtime, system tools, and libraries. Run Docker containers based on Windows or Linux images that you pull from a container registry. Containers running on a single machine share the operating system kernel. Docker containers are fully portable to all major Linux distros, macOS, and Windows.