GitHub + Archyl : Documentation d'architecture dans votre workflow | Webhooks & CI/CD

Integrez Archyl avec GitHub pour les checks de derive en CI/CD, les webhooks et l'Architecture as Code dans vos repositories.

Maintenez la documentation d'architecture synchronisée avec votre code

Connectez Archyl à GitHub avec des webhooks, l'intégration CI/CD et l'Architecture as Code stockée directement dans vos dépôts. Détectez la dérive architecturale dans les pull requests et assurez-vous que la documentation reste à jour au fil de l'évolution de votre codebase.

Intégrez Archyl avec GitHub pour les checks de dérive en CI/CD, les webhooks pour les changements d'architecture et l'Architecture as Code dans vos dépôts.

GitHub documentation architecture, webhooks architecture GitHub, CI/CD architecture GitHub, dérive architecture GitHub, Architecture as Code GitHub

Architecture as Code dans vos repos

Connectez vos dépôts GitHub

Liez votre organisation GitHub ou des dépôts spécifiques à Archyl. La plateforme indexe votre codebase pour comprendre votre implémentation réelle.

L'Architecture as Code vit dans votre repo

Définissez votre modèle C4 dans des fichiers YAML committés dans votre dépôt. Les changements de documentation d'architecture passent par le même processus de revue de PR que le code.

Les pipelines CI/CD valident l'architecture

Ajoutez les checks de dérive Archyl à votre pipeline CI/CD. Les pull requests sont automatiquement vérifiées pour la conformité architecturale et les scores de dérive sont rapportés directement sur la PR.

Webhooks pour les changements d'architecture

Recevez des notifications en temps réel quand des changements d'architecture surviennent. Transmettez les événements vers Slack, Teams, Discord ou vos propres systèmes via des webhooks configurables.

Checks de dérive en CI/CD

Ajoutez des vérifications de conformité architecturale à vos workflows GitHub Actions. Bloquez les merges quand les scores de dérive dépassent votre seuil, maintenant la documentation synchronisée avec le code.

Architecture as Code dans les repos

Stockez votre modèle C4 sous forme de fichiers YAML dans votre dépôt. Versionnez, révisez et collaborez sur la documentation d'architecture avec le même workflow Git que pour le code.

Découverte IA depuis le code

L'IA d'Archyl analyse vos dépôts GitHub pour découvrir automatiquement les éléments d'architecture, les relations et les stacks technologiques depuis votre codebase réel.

Checks d'architecture sur les Pull Requests

Validez automatiquement que les changements de code sont conformes à l'architecture documentée. Obtenez des commentaires sur les PR quand des changements introduisent de la dérive ou violent les règles de conformité.

Liez les releases Archyl aux tags et déploiements GitHub. Suivez l'évolution de votre architecture au fil des versions avec une traçabilité complète.

Connectez GitHub à Archyl

Rendez-vous sur la page Intégrations de votre équipe dans Archyl et connectez votre organisation GitHub. Autorisez l'application GitHub Archyl à accéder à vos dépôts.

Configurez les webhooks

Configurez les webhooks dans Archyl pour recevoir des notifications sur les changements d'architecture. Choisissez votre destination (Slack, Teams, Discord ou endpoint personnalisé) et sélectionnez les événements à écouter.

# Exemple de payload webhook pour un changement d'architecture { "event": "component.updated", "project": "payment-platform", "element": { "type": "component", "name": "Payment Processor", "container": "API Gateway" }, "changes": { "description": "Mis à jour pour supporter...", "technology": ["Go", "gRPC"] }, "author": "vincent@archyl.com", "timestamp": "2026-03-27T10:30:00Z" }

Ajoutez les checks de dérive au CI/CD

Ajoutez l'étape de vérification de dérive Archyl à votre workflow GitHub Actions. Configurez le seuil de score de dérive qui doit être atteint avant qu'une PR puisse être mergée.

# .github/workflows/architecture.yml name: Architecture Check on: [pull_request] jobs: drift-check: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Check architecture drift uses: archyl/drift-action@v1 with: api-key: ${{ secrets.ARCHYL_API_KEY }} project-id: "your-project-id" threshold: 85

Committez l'Architecture as Code

Exportez votre modèle C4 en YAML et committez-le dans votre dépôt. La documentation d'architecture suit maintenant le même processus de revue que votre code.

# archyl/architecture.yaml systems: - name: Payment Platform description: Gère tout le traitement des paiements containers: - name: API Gateway technology: [Go, chi] components: - name: Payment Processor description: Traite les paiements par carte technology: [Go, Stripe SDK] - name: Invoice Generator description: Crée les factures PDF technology: [Go, gopdf]

Exemple : Check de dérive architecturale dans GitHub Actions

# Sortie GitHub Actions Architecture Drift Check - Payment Platform ============================================ Score de dérive global : 92/100 (PASS) Composants vérifiés : 24 Règles de conformité : 12 Violations : 1 (sévérité faible) Avertissement : Le composant Invoice Generator a une dépendance non documentée vers le Notification Service. Envisagez d'ajouter cette relation à votre modèle C4. Résultat : PASS (seuil : 85)

Archyl a-t-il besoin d'accéder à mon code source ?

Pour la découverte IA, Archyl analyse la structure de votre dépôt et le code pour identifier les éléments d'architecture. Pour l'Architecture as Code et les checks de dérive, Archyl ne lit que les fichiers YAML d'architecture dans votre dépôt. Vous pouvez configurer l'accès aux dépôts de manière granulaire.

Puis-je utiliser Archyl avec GitHub Enterprise ?

Oui. Archyl supporte GitHub.com et GitHub Enterprise Server. Contactez notre équipe pour l'aide à la configuration d'Enterprise Server.