Container Registry:Compilar imágenes en una instancia de Container Registry Enterprise Edition

Requisitos previos

Antes de empezar, asegúrese de lo siguiente:

• Creó una instancia de Container Registry Enterprise Edition. Para obtener más información, consulte la sección "Paso 1: Crear una instancia de Container Registry Enterprise Edition" del tema Push an image to a Container Registry Enterprise Edition instance and pull an image from the instance.

• Cuenta con un Dockerfile en su repositorio de origen para compilar las imágenes.

Contexto

Paso 1: Vincular la instancia a una plataforma de hosting de código

Paso 2: Crear un espacio de nombres

Cree un espacio de nombres para organizar sus repositorios de imágenes. Si habilita la creación automática de repositorios, podrá configurar ajustes predeterminados que se aplicarán a todos los repositorios dentro de este espacio de nombres.

1. Inicie sesión en la consola de Container Registry.

2. En la barra de navegación superior, seleccione una región.

3. En el panel de navegación izquierdo, haga clic en Instances.

4. En la página Instances, haga clic en la instancia de Enterprise Edition donde desea crear el espacio de nombres.

5. En el panel de navegación izquierdo, elija Repository > Namespace.

6. En la página Namespace, haga clic en Create Namespace.

7. En el cuadro de diálogo Create Namespace, configure Namespace y establezca Automatically Create Repository en On o Off. Luego, haga clic en Confirm.

   Si establece Automatically Create Repository en On, configure los siguientes parámetros:

   Parámetro	Descripción
   Repository Type	Seleccione Public o Private. Public: de forma predeterminada, las imágenes públicas requieren que los usuarios inicien sesión en la instancia antes de extraerlas. Para permitir extracciones anónimas, habilite el ajuste de extracción anónima pública de la instancia. Dado que cualquier usuario no autorizado puede extraer imágenes de repositorios públicos, configure los repositorios como Private para proteger sus datos. Private: los usuarios deben iniciar sesión en la instancia y contar con autorización de permiso Pull antes de extraer imágenes privadas.
   Immutable Image Tags	Seleccione Flexible o Immutable. Cuando se establece en Immutable, ninguna etiqueta de imagen se puede sobrescribir, excepto latest.
   Accelerated Image	Al habilitarse, se genera automáticamente una versión acelerada de cada imagen después de enviarla. La imagen acelerada incluye el sufijo _accelerated en su etiqueta.

Paso 3: Crear un repositorio de imágenes

Cree un repositorio de imágenes y vincúlelo a un repositorio de código fuente. Todas las imágenes compiladas desde ese repositorio de código fuente se enviarán a este repositorio de imágenes.

1. Inicie sesión en la consola de Container Registry.

2. En la barra de navegación superior, seleccione una región.

3. En el panel de navegación izquierdo, haga clic en Instances.

4. En la página Instances, haga clic en la instancia de Enterprise Edition que desea gestionar.

5. En el panel de navegación izquierdo, elija Repository > Repositories.

6. En la página Repositories, haga clic en Create Repository.

7. En el asistente Repository Info, configure Namespace, Repository Name, Repository Type, Image Version, Accelerated Image, Summary y Description. Después, haga clic en Next.

8. En el paso Code Source, configure Code Source, Build Settings y Build Rules. Luego, haga clic en Create Repository.

9. A continuación se describen los parámetros de Build Settings:

   Parámetro	Descripción
   Automatically Build Images When Code Changes	Al habilitarse, la regla de compilación se activa automáticamente cuando se confirma código en una rama.
   Build With Servers Deployed Outside Chinese Mainland	Habilítelo si su código fuente está en GitHub o Bitbucket. También actívelo si su Dockerfile descarga dependencias fuera de China y la conexión de red transfronteriza es inestable. ACR utiliza un enlace acelerado para extraer fuentes de datos externas durante la compilación. Esta opción solo está disponible en regiones específicas. Si no aparece al crear un repositorio de imágenes, significa que la región actual no es compatible con esta función.
   Build Without Cache	Al habilitarse, ACR extrae la imagen base desde el origen cada vez e ignora las capas almacenadas en la caché. Esto puede ralentizar las compilaciones. Deshabilite esta opción para usar las capas en caché y acelerar el proceso.

   En la página Repositories, haga clic en el repositorio de imágenes creado. Si Build aparece en el panel de navegación izquierdo de la página de gestión del repositorio, el repositorio de imágenes quedó vinculado al repositorio de código fuente.

Paso 4: Compilar una imagen

Configure reglas de compilación para definir cómo y cuándo ACR compila imágenes desde su repositorio. Después, active una compilación y compruebe el resultado.

1. Inicie sesión en la consola de Container Registry.

2. En la barra de navegación superior, seleccione una región.

3. En el panel de navegación izquierdo, haga clic en Instances.

4. En la página Instances, haga clic en la instancia de Enterprise Edition que desea gestionar.

5. En el panel de navegación izquierdo de la página de detalles de la instancia, elija Repository > Repositories.

6. En la página Repositories, busque el repositorio de imágenes que creó y haga clic en Manage en la columna Actions.

7. En el panel de navegación izquierdo, haga clic en Build. En la sección Build Rules, haga clic en Add Build Rule. En el paso Build Information, configure los siguientes parámetros y luego haga clic en Next.

   Parámetro	Descripción
   Type	El tipo de repositorio de código fuente. Valores válidos: Branch y Tag.
   Branch/Tag	Seleccione o introduzca una rama o etiqueta. Se admiten expresiones regulares. Por ejemplo, si introduce release-(?<imageTag>\w*), ACR compila automáticamente una imagen cuando se actualiza el código fuente de la rama release-v1. Para obtener más información sobre grupos de captura con nombre, consulte Uso de expresiones regulares en grupos de captura con nombre. Nota Cuando utiliza una expresión regular, solo ACR puede activar compilaciones. No se admiten compilaciones manuales.
   Build Context Directory	El directorio que contiene el Dockerfile, relativo a la raíz de la rama o etiqueta. Por ejemplo, si la rama es master y el Dockerfile se encuentra en la raíz de la rama, establézcalo en /.
   Dockerfile Filename	El nombre del Dockerfile. El nombre predeterminado es Dockerfile.

8. En el paso Tag, configure los siguientes parámetros, haga clic en Save y luego en Next.

   Nota

   Haga clic en Add Configuration para agregar etiquetas de imagen. Puede agregar hasta tres etiquetas de imagen.

   Parámetro	Descripción
   Image Tag	La etiqueta de la imagen compilada, por ejemplo, latest. Se admiten grupos de captura con nombre. Si definió un grupo de captura con nombre en Branch/Tag, haga referencia aquí al valor capturado.
   Build Time	(Opcional) La hora (UTC+8) en la que se envió el código fuente. Formatos aceptados: 20201015 o 202010151613. Nota Si configura este parámetro, solo ACR puede activar compilaciones. No se admiten compilaciones manuales.
   Commit ID	(Opcional) La cantidad de caracteres que se utilizarán del ID de confirmación del código enviado más recientemente. De forma predeterminada, se usan los primeros seis caracteres. Ajuste el control deslizante para cambiar esta cantidad. Nota Si configura este parámetro, solo ACR puede activar compilaciones. No se admiten compilaciones manuales.

9. En el paso Build Configurations, configure los siguientes parámetros y luego haga clic en Next.

   Parámetro	Descripción
   Build Architecture	Seleccione una o más arquitecturas de destino. Si selecciona varias arquitecturas, ACR genera una imagen independiente para cada una bajo la misma etiqueta.
   Build Parameters	Pares clave-valor que se pasan al proceso de compilación. Los nombres de los parámetros distinguen entre mayúsculas y minúsculas. Configure hasta 20 parámetros de compilación al hacer clic en Add Configuration.

10. Active una compilación mediante uno de los siguientes métodos:

    • En la sección Build Rules de la página Build, busque la regla de compilación y haga clic en Build en la columna Actions.

    • Envíe una confirmación de código a la rama configurada del repositorio de código fuente para activar la regla de compilación automáticamente.

11. Supervise la compilación: en la sección Build Log, busque la tarea de compilación de la imagen y haga clic en Log en la columna Actions para consultar el registro de compilación. Para detener una compilación en ejecución, haga clic en Cancel en la columna Actions.

12. Compruebe el resultado: en el panel de navegación izquierdo, haga clic en Image Tag. Si la imagen que compiló aparece en la lista, la compilación fue exitosa.

    En el panel de navegación izquierdo, haga clic en Image Tag. Si se muestra la imagen que creó, la imagen se compiló correctamente.

Ejemplos

Los dos ejemplos siguientes ilustran configuraciones comunes de reglas de compilación. El ejemplo 1 es una configuración sencilla que admite compilaciones manuales y automáticas. El ejemplo 2 utiliza una expresión regular para crear etiquetas de imagen versionadas a partir de los nombres de ramas de lanzamiento, y solo admite compilaciones automáticas.

Qué hacer a continuación