Inicio rápido: Creación de un registro conectado mediante la CLI de Azure o Azure Portal

• Azure Container Registry: si aún no tiene un registro de contenedor, cree uno (nivel Premium necesario) en una región que admita registros conectados.

Para importar imágenes en el registro de contenedor, use la CLI de Azure.

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.

  

• Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.

  • Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.

  • Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.

• Azure Container Registry: si aún no tiene un registro de contenedor, cree uno (nivel Premium necesario) en una región que admita registros conectados.

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.

  

• Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.

  • Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.

  • Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.

Habilite el punto de conexión de datos dedicado para el registro de contenedor de Azure en la nube. Este paso es necesario para que un registro conectado se comunique con el registro en la nube.

1. En el Azure portal, dirígete a tu registro de contenedor.
2. Seleccione Acceso público a redes>. Seleccione la casilla Habilitar extremo de datos dedicado.
3. Haga clic en Guardar.

Habilite el punto de conexión de datos dedicado para el registro de contenedor de Azure en la nube mediante el comando az acr update . Este paso es necesario para que un registro conectado se comunique con el registro en la nube.

# Set the REGISTRY_NAME environment variable to identify the existing cloud registry
REGISTRY_NAME=<container-registry-name>

az acr update --name $REGISTRY_NAME \
  --data-endpoint-enabled

En los pasos siguientes se crea un registro conectado en modo ReadWrite que está vinculado al registro en la nube.

1. En el Azure portal, dirígete a tu registro de contenedor.
2. Seleccione Registros conectados (versión preliminar) > + Crear.
3. Escriba o seleccione los valores de la tabla siguiente y seleccione Guardar.

También puede usar el comando az acr connected-registry create para crear un registro conectado con la funcionalidad de solo lectura.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connnected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadOnly

Este comando crea un recurso del Registro conectado cuyo nombre es el valor de $CONNECTED_REGISTRY_RO y lo vincula al registro en la nube denominado con el valor de $REGISTRY_NAME.

• Los repositorios especificados se sincronizan entre el registro primario denominado con el valor de $CONNECTED_REGISTRY_RW y el registro conectado una vez implementado.
• El recurso se crea en el modo ReadOnly, que habilita la funcionalidad de solo lectura (extracción de artefactos) una vez implementada.
• Los repositorios se sincronizan entre el registro primario y el registro conectado sin interrupciones porque no hay ninguna programación de sincronización definida para este registro conectado.

Los pasos siguientes crean un registro conectado en modo ReadOnly cuyo elemento primario es el registro conectado que creó en la sección anterior. Este registro conectado habilita la funcionalidad de solo lectura (extracción de artefactos) una vez implementada.

1. En el Azure portal, dirígete a tu registro de contenedor.
2. Seleccione Registros conectados (versión preliminar) > + Crear.
3. Escriba o seleccione los valores de la tabla siguiente y seleccione Guardar.

También puede usar el comando az acr connected-registry create para crear un registro conectado con la funcionalidad de solo lectura.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connnected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadOnly

Este comando crea un recurso del Registro conectado cuyo nombre es el valor de $CONNECTED_REGISTRY_RO y lo vincula al registro en la nube denominado con el valor de $REGISTRY_NAME.

• Los repositorios especificados se sincronizan entre el registro primario denominado con el valor de $CONNECTED_REGISTRY_RW y el registro conectado una vez implementado.
• El recurso se crea en el modo ReadOnly, que habilita la funcionalidad de solo lectura (extracción de artefactos) una vez implementada.
• Los repositorios se sincronizan entre el registro primario y el registro conectado sin interrupciones porque no hay ninguna programación de sincronización definida para este registro conectado.

Seleccione un registro conectado en el portal para ver sus propiedades, como su estado de conexión (Sin conexión, En línea o No saludable) y si está activado (implementado localmente). En el ejemplo siguiente, no se implementa el registro conectado. El estado de conexión de "Sin conexión" indica que se desconecta de la nube.

Desde esta vista, también puede generar una cadena de conexión y, opcionalmente, generar contraseñas para el token de sincronización. Una cadena de conexión contiene opciones de configuración usadas para implementar un registro conectado y sincronizar contenido con un registro primario.

Puede usar el comando az acr connected-registry list para comprobar que se han creado los recursos.

az acr connected-registry list \
  --registry $REGISTRY_NAME \
  --output table

Debería ver una respuesta como se indica a continuación. Dado que los registros conectados aún no están implementados, el estado de conexión de "Sin conexión" indica que actualmente están desconectados de la nube.

NAME                 MODE        CONNECTION STATE    PARENT               LOGIN SERVER    LAST SYNC (UTC)
-------------------  --------    ------------------  -------------------  --------------  -----------------
myconnectedregrw    ReadWrite    Offline
myconnectedregro    ReadOnly     Offline             myconnectedregrw