🇬🇧 English version

Atelier d’analyse de la qualité du code

Bienvenue dans l’Atelier d’analyse de la qualité du code — un atelier pratique et progressif qui vous apprend à intégrer l’analyse de la qualité du code dans vos pipelines CI/CD à l’aide d’outils open source de référence.

[!NOTE] Cet atelier fait partie du Agentic Accelerator Framework.

Vous analyserez cinq applications de démonstration écrites en TypeScript, Python, C#, Java et Go en utilisant une architecture d’analyse à 4 outils : linters par langage, détection de duplication de code, analyse de complexité cyclomatique et mesure de la couverture de tests. Tous les résultats sont normalisés au format SARIF v2.1.0 pour un reporting unifié dans GitHub Advanced Security ou Azure DevOps Advanced Security.

Aperçu de l’architecture

graph TB
    subgraph "Demo Apps"
        A1["cq-demo-app-001<br/>TypeScript / Express"]
        A2["cq-demo-app-002<br/>Python / Flask"]
        A3["cq-demo-app-003<br/>C# / ASP.NET Core"]
        A4["cq-demo-app-004<br/>Java / Spring Boot"]
        A5["cq-demo-app-005<br/>Go / net/http"]
    end

    subgraph "4-Tool Scanner Architecture"
        L["Per-Language Linters<br/>ESLint · Ruff · .NET Analyzers<br/>Checkstyle · golangci-lint"]
        D["Duplication Detection<br/>jscpd"]
        C["Complexity Analysis<br/>Lizard"]
        T["Coverage Tools<br/>Jest · pytest-cov · Coverlet<br/>JaCoCo · go test -cover"]
    end

    subgraph "SARIF Pipeline"
        S1["Native SARIF"]
        S2["lizard-to-sarif.py"]
        S3["coverage-to-sarif.py"]
        U["Unified SARIF Results"]
    end

    subgraph "Reporting"
        GH["GitHub Security Tab"]
        ADO["ADO Advanced Security"]
        PBI["Power BI Dashboard"]
    end

    A1 & A2 & A3 & A4 & A5 --> L & D & C & T
    L --> S1
    D --> S1
    C --> S2
    T --> S3
    S1 & S2 & S3 --> U
    U --> GH & ADO & PBI

Prérequis

Avant de commencer l’atelier, assurez-vous d’avoir installé les éléments suivants :

• Node.js 20+ et npm
• Python 3.12+ et pip
• .NET SDK 8.0+
• Java 21+ (JDK) et Maven
• Go 1.22+
• Docker Desktop (ou Docker-in-Docker dans Codespaces)
• Visual Studio Code avec les extensions recommandées
• GitHub CLI (gh) authentifié avec votre compte GitHub
• Un compte GitHub avec accès à l’organisation devopsabcs-engineering (ou votre propre fork)

Consultez le Lab 00 : Prérequis pour les instructions d’installation détaillées.

Labs

#	Lab	Durée	Niveau
00	Prérequis	30 min	Débutant
01	Explorer les applications de démonstration	30 min	Débutant
02	Analyse de lint	45 min	Intermédiaire
03	Analyse de complexité	30 min	Intermédiaire
04	Détection de duplication	30 min	Intermédiaire
05	Analyse de couverture	45 min	Intermédiaire
06	CI/CD avec GitHub Actions	30 min	Intermédiaire
06-ADO	CI/CD avec les pipelines ADO	30 min	Intermédiaire
07	Remédiation (GitHub)	45 min	Avancé
07-ADO	Remédiation (ADO)	45 min	Avancé
08	Tableau de bord Power BI	45 min	Avancé

Programme de l’atelier

Demi-journée (3,5 heures)

Horaire	Activité
0:00 – 0:30	Lab 00 : Prérequis
0:30 – 1:00	Lab 01 : Explorer les applications de démonstration
1:00 – 1:45	Lab 02 : Analyse de lint
1:45 – 2:15	Lab 03 : Analyse de complexité
2:15 – 2:45	Lab 04 : Détection de duplication
2:45 – 3:00	Pause
3:00 – 3:30	Lab 06 : GitHub Actions (ou Lab 06-ADO)

Journée complète (7 heures)

Horaire	Activité
0:00 – 0:30	Lab 00 : Prérequis
0:30 – 1:00	Lab 01 : Explorer les applications de démonstration
1:00 – 1:45	Lab 02 : Analyse de lint
1:45 – 2:15	Lab 03 : Analyse de complexité
2:15 – 2:45	Lab 04 : Détection de duplication
2:45 – 3:00	Pause
3:00 – 3:45	Lab 05 : Analyse de couverture
3:45 – 4:15	Lab 06 : GitHub Actions
4:15 – 4:45	Lab 06-ADO : Pipelines ADO
4:45 – 5:00	Pause
5:00 – 5:45	Lab 07 : Remédiation (GitHub)
5:45 – 6:30	Lab 07-ADO : Remédiation (ADO)
6:30 – 6:45	Pause
6:45 – 7:00	Lab 08 : Tableau de bord Power BI

Pour commencer

1. Forkez ou utilisez ce modèle pour créer votre propre instance de l’atelier.
2. Complétez le Lab 00 : Prérequis pour configurer votre environnement.
3. Parcourez les labs dans l’ordre — chaque lab s’appuie sur le précédent.

Astuce : Cet atelier est conçu pour GitHub Codespaces. Cliquez sur Code → Codespaces → New codespace pour obtenir un environnement préconfiguré avec tous les outils installés.

Dépôts associés

Dépôt	Description
Agentic Accelerator Framework	Définitions d’agents, instructions, compétences et workflows CI/CD
Agentic Accelerator Workshop	Atelier pratique pour les agents Accelerator propulsés par l’IA
Accessibility Scan Workshop	Atelier d’analyse d’accessibilité WCAG 2.2
FinOps Scan Workshop	Atelier d’analyse de la gouvernance des coûts Azure
APM Security Scan Workshop	Atelier d’analyse de sécurité des fichiers de configuration d’agents