Tutorial: Implementación y uso de Azure Container Registry

Para realizar este tutorial es necesario ejecutar la versión 2.0.53, o superior, de la CLI de Azure. Ejecute az --version para encontrar la versión. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.

Para realizar este tutorial es preciso ejecutar la versión 5.9.0 de Azure PowerShell, o cualquier versión posterior. Ejecute Get-InstalledModule -Name Az para encontrar la versión. Si necesita instalarla o actualizarla, consulte el artículo sobre la instalación de Azure PowerShell.

Para crear un grupo de recursos, use el comando az group create. En el siguiente ejemplo, se crea un grupo de recursos denominado myResourceGroup en la región eastus:

az group create --name myResourceGroup --location eastus

Cree una instancia de Azure Container Registry con el comando crear az acr y especifique su propio nombre de registro. El nombre del registro debe ser único dentro de Azure y contener entre 5 y 50 caracteres alfanuméricos. En el resto del tutorial, se usa <acrName> como marcador de posición del nombre del registro de contenedor. Proporcione su propio nombre único de registro. La SKU básica es un punto de entrada optimizado para costo con fines de desarrollo que proporciona un equilibrio entre almacenamiento y rendimiento.

az acr create --resource-group myResourceGroup --name <acrName> --sku Basic

Cree un grupo de recursos con el cmdlet New-AzResourceGroup. En el siguiente ejemplo, se crea un grupo de recursos denominado myResourceGroup en la región eastus:

New-AzResourceGroup -Name myResourceGroup -Location eastus

Cree una instancia de Azure Container Registry con el cmdlet New-AzContainerRegistry y especifique su propio nombre de registro. El nombre del registro debe ser único dentro de Azure y contener entre 5 y 50 caracteres alfanuméricos. En el resto del tutorial, se usa <acrName> como marcador de posición del nombre del registro de contenedor. Proporcione su propio nombre único de registro. La SKU básica es un punto de entrada optimizado para costo con fines de desarrollo que proporciona un equilibrio entre almacenamiento y rendimiento.

New-AzContainerRegistry -ResourceGroupName myResourceGroup -Name <acrname> -Sku Basic

Para usar la instancia de ACR, primero debe iniciar sesión. Use el comando az acr login y especifique el nombre único que dio al registro de contenedor en el paso anterior.

az acr login --name <acrName>

Para usar la instancia de ACR, primero debe iniciar sesión. Use el cmdlet Connect-AzContainerRegistry y especifique el nombre único otorgado al registro de contenedor en el paso anterior.

Connect-AzContainerRegistry -Name <acrName>

Para obtener la dirección del servidor de inicio de sesión, use el comando az acr list y consulte loginServer como se indica a continuación:

az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table

Para obtener la dirección del servidor de inicio de sesión, use el cmdlet Get-AzContainerRegistry y consulte el elemento loginServer como se indica a continuación:

(Get-AzContainerRegistry -ResourceGroupName myResourceGroup -Name <acrName>).LoginServer

Para que se devuelva una lista de las imágenes que se han insertado en la instancia de ACR, el usuario debe utilizar el comando az acr repository list. Escriba su propio <acrName> como se indica a continuación:

az acr repository list --name <acrName> --output table

En la siguiente salida de ejemplo se muestra la imagen azure-vote-front como disponible en el registro:

Result
----------------
azure-vote-front

Para ver las etiquetas de una imagen concreta, use el comando az acr repository show-tags como se indica a continuación:

az acr repository show-tags --name <acrName> --repository azure-vote-front --output table

La salida de ejemplo siguiente muestra la imagen de v1 etiquetada en un paso anterior:

Result
--------
v1

Para que se devuelva una lista de las imágenes que se han insertado en la instancia de ACR, use el cmdlet Get-AzContainerRegistryManifest. Escriba su propio <acrName> como se indica a continuación:

Get-AzContainerRegistryManifest -RegistryName <acrName> -RepositoryName azure-vote-front

En la siguiente salida de ejemplo se muestra la imagen azure-vote-front como disponible en el registro:

Registry  ImageName        ManifestsAttributes
--------  ---------        -------------------
<acrName> azure-vote-front {Microsoft.Azure.Commands.ContainerRegistry.Models.PSManifestAttributeBase}

Para ver las etiquetas de una imagen concreta, use el cmdlet Get-AzContainerRegistryTag como se indica a continuación:

Get-AzContainerRegistryTag -RegistryName <acrName> -RepositoryName azure-vote-front

La salida de ejemplo siguiente muestra la imagen de v1 etiquetada en un paso anterior:

Registry  ImageName        Tags
--------  ---------        ----
<acrName> azure-vote-front {v1}