Vue d'ensemble de l'Intégration Git - Archyl Docs

Connectez vos dépôts Git pour activer la découverte d'architecture propulsée par l'IA

Vue d'ensemble de l'Intégration Git

Connecter votre dépôt Git à Archyl active la découverte d'architecture propulsée par l'IA, gardant votre documentation synchronisée avec votre code réel.

Fournisseurs Supportés

Archyl supporte toutes les principales plateformes d'hébergement Git :

Fournisseurs Cloud

Fournisseur OAuth Fonctionnalités
GitHub Oui Support complet
GitLab Oui Support complet
Bitbucket Oui Support complet

Auto-hébergé

Fournisseur Méthode d'Auth Fonctionnalités
GitHub Enterprise Token Support complet
GitLab Auto-géré Token Support complet
Gitea Token Support complet
Azure DevOps Token Support complet

Connecter un Dépôt

Étape 1 : Naviguer vers les Paramètres du Projet

  1. Ouvrez votre projet
  2. Cliquez sur Paramètres
  3. Allez dans l'onglet "Dépôt"

Étape 2 : Choisir le Fournisseur

  1. Cliquez sur "Connecter un Dépôt"
  2. Sélectionnez votre fournisseur Git
  3. Autorisez Archyl (pour les fournisseurs OAuth)

Étape 3 : Sélectionner le Dépôt

  1. Parcourez vos dépôts disponibles
  2. Sélectionnez le dépôt à connecter
  3. Choisissez la branche par défaut
  4. Cliquez sur "Connecter"

Authentification

OAuth (Recommandé)

Pour GitHub, GitLab et Bitbucket cloud :

  1. Cliquez sur "Se connecter avec [Fournisseur]"
  2. Autorisez Archyl dans la popup
  3. Sélectionnez les dépôts auxquels accorder l'accès

Les tokens OAuth sont stockés de manière sécurisée et automatiquement rafraîchis.

Tokens d'Accès Personnel

Pour les fournisseurs auto-hébergés ou enterprise :

  1. Générez un token dans votre fournisseur Git
  2. Portées requises : repo (accès en lecture)
  3. Entrez le token dans Archyl

Accès au Dépôt

Ce qu'Archyl Lit

Pendant la Découverte IA, Archyl lit :

  • Structure et noms des fichiers
  • Contenu du code source
  • Fichiers de configuration (package.json, go.mod, etc.)
  • Fichiers README

Ce qu'Archyl N'Accède Jamais

  • Fichiers d'environnement (.env)
  • Credentials ou secrets
  • Historique Git
  • Autres branches (sauf si explicitement sélectionnées)

Dépôts Multiples

Connectez plusieurs dépôts à un seul projet :

Monorepo

Pour les monorepos, connectez une fois et spécifiez les chemins :

/services/api
/services/web
/packages/shared

Multi-Repo

Pour des dépôts séparés :

  1. Connectez chaque dépôt
  2. Mappez aux systèmes ou conteneurs
  3. La découverte s'exécute sur tous les repos

Webhooks (À Venir)

Synchronisation automatique au push :

  • Déclencher la découverte sur les changements de code
  • Mettre à jour l'architecture automatiquement
  • Garder la documentation à jour

Dépannage

Échec d'Autorisation

  • Vérifiez que votre token a les permissions requises
  • Assurez-vous que l'app OAuth est autorisée
  • Essayez de vous reconnecter

Dépôt Non Trouvé

  • Vérifiez que vous avez accès au dépôt
  • Vérifiez l'URL du dépôt
  • Assurez-vous que la branche existe

Erreurs de Découverte

  • Vérifiez les chemins exclus
  • Réduisez les paramètres de concurrence
  • Vérifiez les limites du fournisseur IA