Tutorial: Creación de una instancia de Azure Container Registry para AKS habilitada por Arc
Se aplica a: AKS en Azure Stack HCI 22H2, AKS en Windows Server
Azure Container Registry es un registro privado para imágenes de contenedor. Un registro de contenedor privado permite compilar e implementar aplicaciones y código personalizado de forma segura.
En este tutorial, la segunda parte de siete, implementará una instancia de Azure Container Registry e insertará una imagen de contenedor en ella para su uso en AKS. Aprenderá a:
- Crear una instancia de Azure Container Registry
- Etiquetado de una imagen de contenedor para Azure Container Registry
- Carga de la imagen en Azure Container Registry
- Ver las imágenes del registro
En tutoriales posteriores, esta instancia de Azure Container Registry se integra con un clúster de Kubernetes y se implementa una aplicación desde la imagen.
Antes de empezar
En el tutorial anterior se describe cómo crear una imagen de contenedor para una sencilla aplicación de votación de Azure. Si no ha creado la imagen de la aplicación de Azure Voting, vuelva al Tutorial 1: Creación de imágenes de contenedor.
Para realizar este tutorial es necesario que ejecute la versión 2.0.53 de la CLI de Azure, o cualquier versión posterior. Ejecute az --version para encontrar la versión. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.
Creación de una instancia de Azure Container Registry
Para crear una instancia de Azure Container Registry, primero necesita un grupo de recursos. Un grupo de recursos de Azure es un contenedor lógico en el que se implementan y se administran los recursos de Azure.
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
Inicio de sesión en el registro de contenedor
Para usar la instancia de ACR, primero debe iniciar sesión. Use el comando az acr login y proporcione el nombre único proporcionado al registro de contenedor en el paso anterior:
az acr login --name <acrName>
El comando devuelve un mensaje Login Succeeded cuando se completa.
Etiquetado de una imagen de contenedor
Para ver una lista de las imágenes locales actuales, use el comando docker images:
docker images
La salida de este comando muestra una lista de las imágenes locales actuales:
REPOSITORY TAG IMAGE ID CREATED SIZE
mcr.microsoft.com/azuredocs/azure-vote-front v1 84b41c268ad9 7 minutes ago 944MB
mcr.microsoft.com/oss/bitnami/redis 6.0.8 3a54a920bb6c 2 days ago 103MB
tiangolo/uwsgi-nginx-flask python3.6 a16ce562e863 6 weeks ago 944MB
Para usar la imagen de contenedor azure-vote-front con Azure Container Registry, asegúrese de etiquetar la imagen con la dirección del servidor de inicio de sesión del registro. Esta etiqueta se usa para el enrutamiento al insertar imágenes de contenedor en un registro de imágenes.
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
Ahora, etiquete la imagen azure-vote-front local con la dirección acrLoginServer del registro de contenedor. Para indicar la versión de la imagen, agregue :v1 al final de su nombre:
docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1
Para comprobar que se aplican las etiquetas, vuelva a ejecutar imágenes de Docker:
docker images
Una imagen se etiqueta con la dirección de la instancia de Azure Container Registry y un número de versión:
REPOSITORY TAG IMAGE ID CREATED SIZE
mcr.microsoft.com/azuredocs/azure-vote-front v1 84b41c268ad9 16 minutes ago 944MB
mycontainerregistry.azurecr.io/azure-vote-front v1 84b41c268ad9 16 minutes ago 944MB
mcr.microsoft.com/oss/bitnami/redis 6.0.8 3a54a920bb6c 2 days ago 103MB
tiangolo/uwsgi-nginx-flask python3.6 a16ce562e863 6 weeks ago 944MB
Inserción de imágenes en el registro
Con la imagen compilada y etiquetada, inserte la imagen azure-vote-front en la instancia de Azure Container Registry. Use docker push y proporcione su propia acrLoginServer dirección para el nombre de la imagen de la siguiente manera:
docker push <acrLoginServer>/azure-vote-front:v1
La inserción de imágenes en Azure Container Registry puede tardar unos minutos en completarse.
Lista de imágenes en el registro
Para devolver una lista de imágenes que se insertaron en la instancia de Azure Container Registry, use 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 específica, use el comando az acr repository show-tags :
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
Ya hay una imagen de contenedor almacenada en una instancia de Azure Container Registry privada. Esta imagen se implementa desde Azure Container Registry en un clúster de Kubernetes en el siguiente tutorial.
Pasos siguientes
En este tutorial, ha creado una instancia de Azure Container Registry e insertó una imagen para su uso en un clúster de Kubernetes. Ha aprendido a:
- Crear una instancia de Azure Container Registry (ACR)
- Etiquetar una imagen de contenedor para ACR
- Cargar la imagen a ACR
- Ver las imágenes del registro
Vaya al siguiente tutorial para aprender a implementar un clúster de Kubernetes en Azure.