Compétence GitHub
Utilisez la CLI gh pour interagir avec GitHub. Spécifiez toujours --repo propriétaire/dépôt lorsque vous n'êtes pas dans un répertoire git, ou utilisez directement des URL.
Pull Requests
Vérifier le statut CI d'une PR :
gh pr checks 55 --repo propriétaire/dépôt
Lister les exécutions de workflows récentes :
gh run list --repo propriétaire/dépôt --limit 10
Afficher une exécution et voir quelles étapes ont échoué :
gh run view <id-exécution> --repo propriétaire/dépôt
Afficher les logs uniquement des étapes en échec :
gh run view <id-exécution> --repo propriétaire/dépôt --log-failed
Débogage d'un échec CI
Suivez cette séquence pour enquêter sur un échec CI :
- Vérifier le statut de la PR — identifier quelles vérifications échouent :
gh pr checks 55 --repo propriétaire/dépôt - Lister les exécutions récentes — trouver l'ID d'exécution concerné :
gh run list --repo propriétaire/dépôt --limit 10 - Afficher l'exécution échouée — voir quels jobs et étapes ont échoué :
gh run view <id-exécution> --repo propriétaire/dépôt - Récupérer les logs d'échec — obtenir le détail des étapes en échec :
gh run view <id-exécution> --repo propriétaire/dépôt --log-failed
API pour requêtes avancées
La commande gh api est utile pour accéder à des données non disponibles via d'autres sous-commandes.
Obtenir une PR avec des champs spécifiques :
gh api repos/propriétaire/dépôt/pulls/55 --jq '.title, .state, .user.login'
Sortie JSON
La plupart des commandes supportent --json pour une sortie structurée. Vous pouvez utiliser --jq pour filtrer :
gh issue list --repo propriétaire/dépôt --json number,title --jq '.[] | "\(.number): \(.title)"'