⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

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
Un résumé de construction GitHub Actions

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 :

Message d'erreur du résumé de constructions

Importer les enregistrements de construction dans Docker Desktop

Availability: Beta
Requires: Docker Desktop 4.31 and later

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 :

  1. Téléchargez et installez Docker Desktop.

  2. Téléchargez l'archive d'enregistrement de construction depuis le résumé de tâche dans GitHub Actions.

  3. Ouvrez la vue Constructions dans Docker Desktop.

  4. 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.

  5. 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.