Resumen de compilación de GitHub Actions

Las GitHub Actions de Docker para compilar y enviar imágenes generan un resumen del trabajo (job summary) para tu compilación que detalla la ejecución y los materiales utilizados:

• Un resumen que muestra el Dockerfile utilizado, la duración de la compilación y la utilización de la caché
• Las entradas de la compilación, como los argumentos de compilación (build arguments), etiquetas (tags), etiquetas descriptivas (labels) y contextos de compilación
• Para compilaciones con Bake, la definición completa de bake para la compilación

Los resúmenes de trabajo para las compilaciones de Docker aparecen automáticamente si utilizas las siguientes versiones de las GitHub Actions Build and push Docker images o Docker Buildx Bake:

• docker/build-push-action@v7
• docker/bake-action@v7

Para ver el resumen del trabajo, abre la página de detalles del trabajo en GitHub después de que este haya finalizado. El resumen está disponible tanto para compilaciones fallidas como exitosas. En caso de una compilación fallida, el resumen también muestra el mensaje de error que causó el fallo:

Importar registros de compilación a Docker Desktop

El resumen del trabajo incluye un enlace para descargar un archivo de registro de compilación (build record archive) de la ejecución. El archivo de registro de compilación es un archivo ZIP que contiene los detalles sobre una compilación (o compilaciones, si utilizas docker/bake-action para compilar múltiples objetivos). Puedes importar este archivo de registro de compilación en Docker Desktop, lo que te proporciona una potente interfaz gráfica para analizar detalladamente el rendimiento de la compilación a través de la vista de Builds de Docker Desktop.

Para importar el archivo de registro de compilación a Docker Desktop:

1. Descarga e instala Docker Desktop.

2. Descarga el archivo de registro de compilación desde el resumen del trabajo en GitHub Actions.

3. Abre la vista de Builds en Docker Desktop.

4. Selecciona el botón Import build y busca el archivo .zip del resumen del trabajo que descargaste. Alternativamente, puedes arrastrar y soltar el archivo ZIP de registro de compilación en la ventana de Docker Desktop después de abrir el diálogo de importación de compilación.

5. Selecciona Import para añadir los registros de compilación.

Después de unos segundos, las compilaciones de la ejecución de GitHub Actions aparecerán en la pestaña Completed builds en la vista de Builds. Para inspeccionar una compilación y ver una vista detallada de todas las entradas, resultados, pasos de compilación y utilización de la caché, selecciona el elemento en la lista.

Desactivar el resumen de trabajo

Para desactivar los resúmenes de trabajo, establece la variable de entorno DOCKER_BUILD_SUMMARY en la configuración YAML de tu paso de compilación:

- name: Build
  uses: docker/build-push-action@v7
  env:
    DOCKER_BUILD_SUMMARY: false
  with:
    tags: ${{ steps.meta.outputs.tags }}
    labels: ${{ steps.meta.outputs.labels }}

Desactivar la subida del registro de compilación

Para desactivar la subida del archivo de registro de compilación a GitHub, establece la variable de entorno DOCKER_BUILD_RECORD_UPLOAD en la configuración YAML de tu paso de compilación:

- name: Build
  uses: docker/build-push-action@v7
  env:
    DOCKER_BUILD_RECORD_UPLOAD: false
  with:
    tags: ${{ steps.meta.outputs.tags }}
    labels: ${{ steps.meta.outputs.labels }}

Con esta configuración, el resumen de la compilación se seguirá generando, pero no contendrá un enlace para descargar el archivo de registro de compilación.

Limitaciones

Los resúmenes de compilación no son compatibles actualmente para:

• Repositorios alojados en GitHub Enterprise Servers. Los resúmenes solo se pueden ver para repositorios alojados en GitHub.com.