Si vos journaux d’activité ne sont pas suffisamment détaillés pour résoudre un problème, vous pouvez effectuer plusieurs étapes pour obtenir des informations supplémentaires et rendre les journaux plus utiles.
Activation de la journalisation du débogage par étape
La journalisation du débogage par étape augmente la verbosité des journaux d’un travail pendant et après l’exécution.
Pour activer la journalisation du débogage par étapes :
- Dans le référentiel qui contient le flux de travail, définissez le secret ou la variable suivante : à . Si le secret et la variable sont tous les deux définis, la valeur du secret prévaut sur celle de la variable.
- Réexécutez le flux de travail ou déclenchez une nouvelle exécution.
Après avoir défini le secret ou la variable, d’autres événements de débogage sont affichés dans les journaux d’étapes. Consultez AUTOTITLE.
Vous pouvez également utiliser le contexte pour exécuter des étapes de manière conditionnelle uniquement lorsque la journalisation du débogage est activée. Consultez AUTOTITLE.
Création d’artefacts de débogage CodeQL
Avertissement
Les artefacts de débogage CodeQL contiennent une copie du code source analysé par CodeQL. Nous vous suggérons donc de partager ces packs uniquement avec des personnes autorisées à accéder à ce code source.
Vous pouvez obtenir des artefacts pour vous aider à déboguer CodeQL. Les artefacts de débogage seront chargés dans l'exécution du flux de travail en tant qu’artefacts avec des noms commençant par . Si CodeQL analyse simultanément plusieurs langues dans le cadre de l’exécution du flux de travail, il y aura un artefact de ce type pour chaque langue. Les données contiennent les journaux CodeQL, les bases de données CodeQL, les fichiers extraits de code source et tous les fichiers SARIF générés par le flux de travail. Pour plus d’informations sur le téléchargement des artefacts CodeQL, consultez AUTOTITLE.
Ces artefacts vous aident à déboguer les problèmes avec CodeQL code scanning. Si vous contactez Support GitHub, ils peuvent demander ces données.
Création d’artefacts de débogage CodeQL pour la configuration par défaut CodeQL
Vous pouvez créer des artefacts de débogage CodeQL en activant la journalisation de débogage d'étape (voir Activation de la journalisation du débogage par étape) et en déclenchant une nouvelle analyse CodeQL en envoyant un nouveau commit à une branche de demande de tirage.
Si vous avez donné à CodeQL l'accès aux registres privés, des artefacts supplémentaires dont les noms commencent par seront disponibles. Ils contiennent des journaux d’activité du proxy d’authentification utilisés par CodeQL configuration par défaut pour authentifier les demandes auprès des registres privés et peuvent être utilisés pour résoudre les problèmes de configurations de Registre privé. Pour en savoir plus, consultez AUTOTITLE.
Création d’artefacts de débogage CodeQL pour la configuration avancée CodeQL
Le débogage des artefacts pour la configuration avancée CodeQL peut être réalisé de plusieurs façons différentes.
Réexécuter les travaux avec la journalisation de débogage activée
L’option la plus simple pour créer des artefacts de débogage pour CodeQL dans une configuration avancée consiste à réexécuter des tâches avec la journalisation du débogage activée. Pour plus d’informations sur la réexécution des workflows et travaux GitHub Actions, consultez AUTOTITLE.
Vous devez veiller à sélectionner Activer la journalisation du débogage. Cette option permet d’activer la journalisation des diagnostics de l’exécuteur et la journalisation du débogage par étape pour l’exécution. Vous pourrez ensuite télécharger les artefacts de débogage CodeQL pour une analyse plus approfondie. Vous n’avez pas besoin de modifier le fichier de workflow lors de la création d’artefacts de débogage CodeQL en réexécutant les travaux.
Utilisation d’un indicateur de flux de travail
Vous pouvez créer des artefacts de débogage CodeQL en utilisant un indicateur dans votre workflow. Pour ce faire, vous devez modifier l’étape de votre fichier Workflow d’analyse CodeQL et définir .
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
debug: true
Utiliser la journalisation de débogage pas à pas GitHub Actions
Si vous activez la journalisation de débogage pas à pas pour GitHub Actions, CodeQL générera également des artefacts de débogage et les chargera dans le cadre de l'exécution du workflow. Pour obtenir des instructions, consultez Activation de la journalisation du débogage par étape.