# Déployer GitHub Code Quality à grande échelle Déployez Code Quality auprès de chaque équipe en toute confiance en commençant par un projet pilote auprès d’un petit groupe, puis en élargissant son déploiement une fois vos seuils de qualité ajustés. Activer Code Quality partout en même temps signifie que chaque équipe se met à voir des signalements Code Quality sur ses pull requests le même jour, ce qui peut être surprenant et perturbant. Dans ce tutoriel, vous allez apprendre à la déployer en phases : présenter les résultats à un petit groupe d’abord, étalonner vos seuils, puis développer. Vous allez prouver la valeur avant qu’elle n’affecte toute votre organisation. ## Logiciels requis * Un propriétaire d’entreprise a autorisé Code Quality dans votre entreprise. Consultez « [Autoriser l’utilisation de GitHub Code Quality dans votre entreprise](/fr/code-security/code-quality/how-tos/allow-in-enterprise?utm_campaign=code-quality-ga-july-2026\&utm_medium=docs\&utm_source=docs-roll-out-at-scale-enable-cq) ». * Vous êtes propriétaire de l’organisation, ce qui vous permet d’activer Code Quality et de configurer des ensembles de règles au niveau de l’organisation. ## Planifiez votre pilote **Commencez par un petit groupe pilote** plutôt que par l’ensemble de votre organisation. Un bon groupe pilote est une équipe d’ingénierie unique, ou un ensemble d’applications connexe, qui est suffisamment actif pour générer des résultats significatifs et appartenant à des personnes qui peuvent vous donner des commentaires sur les résultats. Pour cibler ce groupe, utilisez le paramètre **d’accès référentiel** de votre organisation pour Code Quality. Vous avez deux bonnes options pour un pilote : * **Dépôts sélectionnés :** Choisissez manuellement une liste fixe de dépôts pilotes. Mieux quand votre groupe pilote est petit et stable. * **Correspondance avec un filtre :** Activez chaque référentiel correspondant aux critères que vous définissez, par exemple une propriété personnalisée telle que `code-quality-enabled: true`. Idéal lorsque vous souhaitez que le projet pilote s’étende automatiquement à mesure que les équipes étiquettent davantage de référentiels. Le ciblage par une propriété personnalisée, plutôt que d’en nommer un par un, signifie que vous pouvez élargir le pilote plus tard en définissant la propriété sur d’autres référentiels. Si vous souhaitez utiliser une propriété personnalisée : 1. Créez la propriété personnalisée. Consultez « [Gestion des propriétés personnalisées pour les référentiels de votre organisation](/fr/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization) ». 2. Activez Code Quality au niveau de l’organisation pour les référentiels correspondant à un filtre. Consultez « [Mise en place de la qualité du code à l’échelle des organisations et des entreprises](/fr/code-security/concepts/code-quality/enablement-at-scale#organization-level-repository-access) ». ## Activer les ensembles de règles de qualité en mode Évaluer **Activez d’abord vos seuils de qualité en mode d’évaluation.** Dans ce mode, Code Quality indique quelles pull requests *seraient* bloquées, sans les bloquer réellement, afin que vos équipes pilotes puissent en voir l’impact avant que ce mode ne devienne contraignant. Configurez vos seuils en tant qu’ensemble de règles d’organisation limité aux référentiels pilotes et laissez-le en mode d’évaluation jusqu’à ce que vous ayez collecté suffisamment d’activités de demande de tirage pour juger de l’impact, généralement **une semaine ou deux**. Consultez « [Définition des seuils de qualité du code pour les pull requests](/fr/code-security/how-tos/maintain-quality-code/set-pr-thresholds) ». ## Ajustez vos seuils **Utilisez les résultats en mode évaluation pour étalonner vos seuils.** Consultez les **informations sur l’ensemble de règles** (l’historique de l’ensemble de règles) pour voir précisément quelles pull requests auraient été bloquées et pourquoi. Si trop de pull requests risquent d’être bloquées, vos seuils sont peut-être plus stricts que ce que votre base de code est prête à supporter. Si presque aucun d’entre eux ne sera bloqué, vous devriez peut-être les rendre plus stricts. Ajustez jusqu’à ce que la porte reflète la barre de qualité que vous souhaitez appliquer. ## Passer au mode d’application **Lorsque les résultats en mode d’évaluation semblent corrects, faites passer votre ensemble de règles d’Évaluation à Actif.** Les seuils bloquent désormais les pull requests qui ne les respectent pas. Vos équipes pilotes passent par cette étape de validation obligatoire, ce qui vous permet d’effectuer une dernière vérification avant d’étendre le déploiement. ## Développer au sein de votre organisation **Développez le déploiement à l’aide de ce que vous avez appris du pilote.** Vous pouvez l’élargir de deux façons : * Ajoutez des référentiels à votre liste **de référentiels sélectionnés** ou définissez votre propriété personnalisée sur d’autres référentiels qui correspondent à votre filtre. * Une fois que vous êtes confiant dans vos seuils, basculez votre paramètre **d’accès référentiel** vers **tous les référentiels** à appliquer Code Quality dans l’ensemble de votre organisation en une seule modification. Voici quelques informations sur le comportement de l’activation au niveau de l’organisation. Vous pouvez donc choisir la bonne approche : * Votre choix **d’accès au référentiel** s’applique aux **référentiels existants et futurs**. Les dépôts créés ultérieurement héritent automatiquement de votre choix. Cela s’applique à **tous les dépôts**, **correspondant à un filtre** et **aucun dépôt**. * Activez **Appliquer l’accès** pour garantir un niveau de référence que les administrateurs du dépôt ne peuvent pas outrepasser. Laissez cette option désactivée, ou choisissez **Laisser les dépôts décider**, pour permettre aux équipes d’y adhérer selon leur propre calendrier. * L’activation Code Quality n’active **pas** automatiquement la **couverture du code**. La couverture est activée de façon facultative pour chaque dépôt. Il commence à signaler uniquement une fois qu’une personne ajoute un flux de travail qui charge les données de couverture, afin que les équipes puissent adopter Code Quality en premier et ajouter une couverture ultérieurement. Consultez « [Configuration de la couverture du code pour votre référentiel](/fr/code-security/how-tos/maintain-quality-code/set-up-code-coverage) ». Pour obtenir la liste complète des options d’accès et du fonctionnement de l’application, consultez [Mise en place de la qualité du code à l’échelle des organisations et des entreprises](/fr/code-security/concepts/code-quality/enablement-at-scale#organization-level-repository-access). ### Mettre à l’échelle par programmation Pour la plupart des déploiements, l’activation via l’interface utilisateur est le meilleur point de départ : il vous permet de filtrer et de cibler directement les référentiels, ce qui est plus difficile à reproduire dans un script. Si vous avez besoin d’une automatisation autour de votre déploiement, vous pouvez extraire Code Quality des résultats via l’API REST, ce qui est utile pour générer des rapports sur la progression à mesure que vous développez. Vous pouvez également activer Code Quality sur des dépôts via l’API REST, afin de pouvoir automatiser l’activation à l’échelle de votre organisation au lieu d’activer chaque dépôt via l’interface utilisateur. Consultez « [Points de terminaison d’API REST pour la qualité du code](/fr/rest/code-quality/code-quality) ». ## Étapes suivantes * **Évaluez l’état de santé au sein de votre organisation.** Consultez « [Exploration des résultats de la qualité du code GitHub dans votre organisation](/fr/code-security/how-tos/maintain-quality-code/explore-code-quality) ».