GitHub Actions build summary
Les Actions GitHub de Docker pour construire et pousser des images génèrent un résumé de tâche pour votre construction qui décrit l'exécution et les matériaux utilisés :
- Un résumé montrant le Dockerfile utilisé, la durée de construction et l'utilisation du cache
- Les entrées pour la construction, telles que les arguments de construction, tags, labels et contextes de construction
- Pour les constructions avec Bake, la définition bake complète pour la construction


Les résumés de tâche pour les constructions Docker apparaissent automatiquement si vous utilisez les versions suivantes des Actions GitHub Build and push Docker images ou Docker Buildx Bake :
docker/build-push-action@v6
docker/bake-action@v6
Pour voir le résumé de tâche, ouvrez la page de détails pour la tâche dans GitHub après que la tâche soit terminée. Le résumé est disponible pour les constructions échouées et réussies. Dans le cas d'une construction échouée, le résumé affiche également le message d'erreur qui a causé l'échec de la construction :


Importer les enregistrements de construction dans Docker Desktop
Le résumé de tâche inclut un lien pour télécharger une archive d'enregistrement
de construction pour l'exécution. L'archive d'enregistrement de construction
est un fichier ZIP contenant les détails sur une construction (ou des
constructions, si vous utilisez docker/bake-action
pour construire plusieurs
cibles). Vous pouvez importer cette archive d'enregistrement de construction
dans Docker Desktop, ce qui vous donne une interface graphique puissante pour
analyser davantage les performances de la construction via la
vue Constructions de Docker Desktop.
Pour importer l'archive d'enregistrement de construction dans Docker Desktop :
-
Téléchargez et installez Docker Desktop.
-
Téléchargez l'archive d'enregistrement de construction depuis le résumé de tâche dans GitHub Actions.
-
Ouvrez la vue Constructions dans Docker Desktop.
-
Sélectionnez le bouton Importer la construction, puis naviguez vers l'archive
.zip
du résumé de tâche que vous avez téléchargée. Alternativement, vous pouvez faire glisser-déposer le fichier ZIP de l'archive d'enregistrement de construction sur la fenêtre Docker Desktop après avoir ouvert la boîte de dialogue d'importation de construction. -
Sélectionnez Importer pour ajouter les enregistrements de construction.
Après quelques secondes, les constructions de l'exécution GitHub Actions apparaissent sous l'onglet Constructions terminées dans la vue Constructions. Pour inspecter une construction et voir une vue détaillée de toutes les entrées, résultats, étapes de construction et utilisation du cache, sélectionnez l'élément dans la liste.
Désactiver le résumé de tâche
Pour désactiver les résumés de tâche, définissez la variable d'environnement
DOCKER_BUILD_SUMMARY
dans la configuration YAML pour votre étape de
construction :
- name: Build
uses: docker/build-push-action@v6
env:
DOCKER_BUILD_SUMMARY: false
with:
tags: ${{ steps.meta.outputs.tags }}
labels: ${{ steps.meta.outputs.labels }}
Désactiver le téléchargement de l'enregistrement de construction
Pour désactiver le téléchargement de l'archive d'enregistrement de construction
vers GitHub, définissez la variable d'environnement
DOCKER_BUILD_RECORD_UPLOAD
dans la configuration YAML pour votre étape de
construction :
- name: Build
uses: docker/build-push-action@v6
env:
DOCKER_BUILD_RECORD_UPLOAD: false
with:
tags: ${{ steps.meta.outputs.tags }}
labels: ${{ steps.meta.outputs.labels }}
Avec cette configuration, le résumé de construction est toujours généré, mais ne contient pas de lien pour télécharger l'archive d'enregistrement de construction.
Limitations
Les résumés de construction ne sont actuellement pas supportés pour :
- Les constructions utilisant Docker Build Cloud. Le support pour Docker Build Cloud est prévu pour une version future.
- Les dépôts hébergés sur GitHub Enterprise Servers. Les résumés ne peuvent être vus que pour les dépôts hébergés sur GitHub.com.