Panoramica dell'Integrazione Git - Archyl Docs

Collega i tuoi repository Git per abilitare la scoperta dell'architettura basata sull'IA

Panoramica dell'Integrazione Git

Collegare il tuo repository Git ad Archyl abilita la scoperta dell'architettura basata sull'IA, mantenendo la documentazione sincronizzata con il codice reale.

Provider Supportati

Archyl supporta tutte le principali piattaforme di hosting Git:

Provider Cloud

Provider OAuth Funzionalità
GitHub Sì Supporto completo
GitLab Sì Supporto completo
Bitbucket Sì Supporto completo

Self-Hosted

Provider Metodo di Autenticazione Funzionalità
GitHub Enterprise Token Supporto completo
GitLab Self-Managed Token Supporto completo
Gitea Token Supporto completo
Azure DevOps Token Supporto completo

Collegare un Repository

Passo 1: Navigare alle Impostazioni del Progetto

  1. Apri il tuo progetto
  2. Clicca su Impostazioni
  3. Vai alla scheda "Repository"

Passo 2: Scegliere il Provider

  1. Clicca "Collega Repository"
  2. Seleziona il tuo provider Git
  3. Autorizza Archyl (per i provider OAuth)

Passo 3: Selezionare il Repository

  1. Sfoglia i repository disponibili
  2. Seleziona il repository da collegare
  3. Scegli il branch predefinito
  4. Clicca "Collega"

Autenticazione

OAuth (Consigliato)

Per GitHub, GitLab e Bitbucket cloud:

  1. Clicca "Connetti con [Provider]"
  2. Autorizza Archyl nel popup
  3. Seleziona i repository a cui concedere l'accesso

I token OAuth sono archiviati in modo sicuro e aggiornati automaticamente.

Token di Accesso Personale

Per provider self-hosted o enterprise:

  1. Genera un token nel tuo provider Git
  2. Scope richiesti: repo (accesso in lettura)
  3. Inserisci il token in Archyl

Accesso al Repository

Cosa Legge Archyl

Durante la Scoperta IA, Archyl legge:

  • Struttura e nomi dei file
  • Contenuto del codice sorgente
  • File di configurazione (package.json, go.mod, ecc.)
  • File README

Cosa Archyl Non Accede Mai

  • File di ambiente (.env)
  • Credenziali o segreti
  • Cronologia Git
  • Altri branch (salvo selezione esplicita)

Repository Multipli

Collega più repository a un singolo progetto:

Monorepo

Per i monorepo, collega una volta e specifica i percorsi:

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

Multi-Repo

Per repository separati:

  1. Collega ogni repository
  2. Mappa ai sistemi o contenitori
  3. La scoperta viene eseguita su tutti i repo

Webhook (Prossimamente)

Sincronizzazione automatica al push:

  • Attiva la scoperta alle modifiche del codice
  • Aggiorna l'architettura automaticamente
  • Mantieni la documentazione aggiornata

Risoluzione dei Problemi

Autorizzazione Fallita

  • Verifica che il token abbia le autorizzazioni necessarie
  • Assicurati che l'app OAuth sia autorizzata
  • Prova a ricollegare

Repository Non Trovato

  • Verifica di avere accesso al repository
  • Controlla l'URL del repository
  • Assicurati che il branch esista

Errori di Scoperta

  • Controlla i percorsi esclusi
  • Riduci le impostazioni di concorrenza
  • Verifica i limiti del provider IA