Vai al contenuto
iCrewPlay.com Un progetto editoriale indipendente
Continua con App e software

Forgejo: come migrare da GitHub senza perdere repository e issue

Come trasferire codice e cronologia, controllare issue e pull request e adattare GitHub Actions senza confondere migrazione e mirroring.

Repository
repository
Tempo di lettura4 minuti
Commenta

Puoi passare da GitHub a Forgejo conservando la cronologia Git, ma non devi presumere che issue, pull request e workflow CI vengano trasferiti senza differenze. La migrazione integrata di Forgejo permette di importare un repository esistente; la verifica finale deve riguardare separatamente codice, dati collaborativi e automazioni. Per ridurre il rischio conviene iniziare con un repository non critico, confrontare origine e destinazione e spostare solo dopo il progetto di produzione.

Che cosa si trasferisce davvero da GitHub a Forgejo

La guida ufficiale Forgejo al primo repository conferma che la funzione di migrazione preserva la storia Git, inclusi tag e altri elementi. I dati gestiti dalla piattaforma non sono tutti parte di Git: issue, pull request, commenti, allegati, release, webhook e secret devono essere controllati in modo distinto, in base alle opzioni offerte dalla versione dell’istanza.

Elemento Controllo dopo l’importazione Rischio se ignorato
Commit, branch e tag Confrontare branch predefinito, commit più recente, rami e tag Codice o release non allineati
Issue e pull request Verificare elementi aperti e chiusi, commenti e riferimenti Discussioni o collegamenti mancanti
File Git LFS Scaricare un oggetto reale dalla nuova destinazione File binari non disponibili
Webhook e integrazioni Riconfigurare endpoint e autorizzazioni Servizi esterni interrotti
GitHub Actions Eseguire pipeline di prova con Forgejo Runner Build e deploy non funzionanti

Questa è una checklist di verifica, non l’esito di un test compiuto da iCrewPlay Tech su una specifica istanza.

Pubblicità

Prima di migrare: backup, token e inventario

  1. Conserva una copia indipendente del codice e dei dati di progetto non archiviati in Git, senza considerare un clone come backup completo delle issue.
  2. Annota branch predefinito, tag, numero di issue e pull request, release e workflow attivi.
  3. Individua eventuali repository privati e prepara un token con i soli permessi di lettura necessari, quando richiesto.
  4. Verifica spazio, permessi e disponibilità della destinazione Forgejo.
  5. Non eliminare subito il repository originale e non revocare le credenziali fino alla fine dei controlli.

I token non devono finire nel repository, negli screenshot o nei log pubblici. Un’istanza self-hosted comporta inoltre manutenzione, aggiornamenti, copie di sicurezza e gestione degli accessi.

Come importare un repository da GitHub

La procedura base riportata nella documentazione ufficiale è semplice, ma le scelte disponibili variano in base a versione e configurazione.

  1. Apri l’interfaccia web della tua istanza Forgejo e accedi.
  2. Premi + in alto a destra e scegli New migration.
  3. Seleziona GitHub come servizio di origine, se disponibile nell’istanza.
  4. Inserisci l’URL del repository e configura l’autenticazione richiesta per un repository privato.
  5. Seleziona solo le opzioni di importazione che sono effettivamente mostrate e compatibili.
  6. Avvia l’importazione e controlla il risultato prima di modificare gli accessi al repository GitHub.

Se l’importazione si interrompe, verifica anzitutto se Forgejo ha già creato una destinazione parziale: ricominciare subito con un nuovo repository può generare duplicati e confondere i controlli.

Come verificare che non manchi nulla

Clona il nuovo repository in una cartella separata, senza sovrascrivere il clone usato prima della migrazione. Controlla il commit di punta del branch principale, i branch secondari e i tag; poi esegui i normali test del progetto, se disponibili. Confronta inoltre un campione di issue e pull request comprendente discussioni aperte e chiuse. Se usi Git LFS, verifica il download di uno o più oggetti realmente necessari al progetto.

Non basta che la homepage del repository sia visibile. Una migrazione corretta del codice non dimostra che notifiche, deploy, permessi del team e indirizzi utilizzati da integrazioni esterne siano già pronti.

GitHub Actions è compatibile con Forgejo Actions?

Non al cento per cento. La documentazione ufficiale sulle differenze con GitHub Actions specifica che Forgejo Actions punta a un’esperienza familiare, non alla piena compatibilità. Molte pipeline possono essere adattate con modifiche limitate, ma non esiste garanzia universale.

I workflow sono normalmente letti da .forgejo/workflows; quando tale directory manca, Forgejo può cercarli in .github/workflows. Servono comunque un Forgejo Runner disponibile e un ambiente di esecuzione con le dipendenze necessarie. Rispetto ai runner GitHub, immagini, strumenti preinstallati e alcune chiavi del contesto possono essere differenti.

Prima di dismettere GitHub, verifica che almeno una pipeline reale possa eseguire build, test e deploy nell’istanza di destinazione. Controlla immagini container, azioni esterne, secret e autorizzazioni. Evita di incollare credenziali nei file YAML per superare velocemente un errore.

Quando usare il mirroring invece della migrazione immediata

Il mirroring documentato da Forgejo sincronizza commit, branch e tag, e può essere utile per una transizione graduale o per mantenere una copia del codice. Non sostituisce però la migrazione completa dei dati collaborativi né la configurazione di CI, webhook e autorizzazioni.

Durante una fase di coesistenza, stabilisci quale repository riceve le modifiche principali. Evita push forzati e scritture concorrenti non coordinate: il mirroring non risolve automaticamente i conflitti tra due sorgenti attive.

Quando conviene davvero passare a Forgejo

Forgejo può essere una scelta sensata per chi desidera controllo sull’infrastruttura, gestione autonoma dei dati e un servizio Git basato su software libero. Il vantaggio deve essere valutato insieme ai costi di server, aggiornamenti, backup e sicurezza dei runner CI, che eseguono codice e richiedono particolare attenzione.

La regola operativa è semplice: considera conclusa la migrazione solo quando hai verificato tre livelli distinti: cronologia Git, informazioni collaborative e automazioni. Se uno di questi manca, conserva temporaneamente GitHub come riferimento e correggi il problema sulla destinazione prima del passaggio definitivo.

La tua opinione in un clic

Cosa ne pensi?

La sala è aperta

Entra nella conversazione

Condividi il tuo punto di vista: non serve creare un account. I contributi restano soggetti alla moderazione editoriale.

Traguardo della community0 / 5
Mancano 5 interventi al prossimo traguardo.

Aggiungi la tua voce

Partecipazione libera: inserisci i dati richiesti e pubblica senza registrarti.