Connetti il tuo progetto Atoms a GitHub per mantenere il suo codice in un repository privato e spostare le modifiche tra Atoms e GitHub senza usare comandi Git.

Questa guida spiega l'intero processo di configurazione: collegare il tuo account GitHub ad Atoms, creare il repository, confermare che la connessione funzioni e mantenere sincronizzate le versioni del tuo progetto su Atoms e GitHub.

Come funziona la connessione

Ci sono 2 fasi per collegare GitHub:

1. Collega il tuo account GitHub. Questo concede ad Atoms l'autorizzazione a lavorare con GitHub per tuo conto.
2. Crea un repository per il tuo progetto. Un repository è lo spazio privato in GitHub in cui vengono archiviati il codice del tuo progetto e la cronologia delle modifiche.

Atoms attualmente crea un nuovo repository privato nell'account GitHub personale dell'utente collegato. Non puoi collegarti a un repository esistente, creare il repository sotto un'organizzazione o renderlo pubblico tramite il connettore.

Prima di iniziare

Prima di collegare il tuo progetto a GitHub, assicurati che:

• Il tuo piano Atoms includa la connessione GitHub. Se utilizzi il piano Free, selezionando GitHub verrai reindirizzato alla pagina Plans.
• Solo il proprietario dello spazio di lavoro può collegare o scollegare GitHub. Se sei un editor, chiedi al proprietario dello spazio di lavoro di eseguire questo passaggio.
• Tu abbia un account GitHub o sia pronto a crearne uno durante la configurazione.
• Il tuo browser consenta le finestre pop-up da Atoms.
• Nessun Agente stia attualmente lavorando al tuo progetto.

Non hai bisogno di un personal access token GitHub per collegare il tuo account. Non incollare mai token GitHub, password o altre credenziali nella Chat.

Collega il tuo account GitHub

Apri il connettore GitHub

1. Apri il progetto che vuoi collegare.
2. Fai clic sul nome del progetto, in alto a destra nel pannello della chat.
3. Seleziona Connectors nel menu a discesa che appare.
4. Trova Github nell'elenco dei connettori disponibili e fai clic su connect.

Puoi anche aprire Settings → Connectors → GitHub e selezionare Connect.

Apri Settings → Connectors e seleziona Connect per GitHub.

Autorizza Atoms in GitHub

Se Connected Account mostra già l'account GitHub che vuoi usare, significa che è già stato autorizzato. Puoi continuare con Create a private repository.

1. Atoms apre una finestra di autorizzazione GitHub. Accedi all'account GitHub che vuoi collegare oppure crea un nuovo account, se necessario.
2. Controlla di aver effettuato l'accesso all'account GitHub corretto.
3. Esamina le autorizzazioni richieste da Atoms. Se sei d'accordo, seleziona Authorize Atoms-Agents.
4. Torna su Atoms e attendi il messaggio Connect success.
5. In Atoms, apri Connectors e conferma che il tuo account GitHub risulti collegato.

Atoms richiede le autorizzazioni OAuth repo, read:user e workflow. Queste consentono ad Atoms di leggere e scrivere repository pubblici e privati a cui l'account collegato può accedere, leggere le informazioni di profilo di base e aggiungere o aggiornare i file di workflow di GitHub Actions.

Questa autorizzazione si applica all'account GitHub collegato e non è limitata al repository creato per l'attuale progetto Atoms. Atoms non può accedere a repository a cui l'account collegato non può accedere, e le policy dell'organizzazione potrebbero imporre ulteriori restrizioni.

Esamina le autorizzazioni GitHub e seleziona Authorize Atoms-Agents.

Crea un repository privato

Dopo aver autorizzato il tuo account GitHub, crea il repository privato che archivierà il codice del tuo progetto.

1. Sotto Connected Account, controlla che il nome utente visualizzato corrisponda all'account GitHub che vuoi usare.
2. Sotto Create New Repository, inserisci un nome per il repository. Il nome deve:
   • contenere da 1 a 100 caratteri;
   • usare solo lettere, numeri, trattini (-), underscore (_) o punti (.).
3. Seleziona Create.
4. Attendi il messaggio GitHub repository connected successfully!.

Atoms crea un nuovo repository privato nell'account GitHub personale dell'utente collegato, lo collega al progetto Atoms corrente e poi tenta di caricare su GitHub i file attuali del progetto.

Inserisci un nome e crea un nuovo repository privato.

Controlla che la connessione abbia funzionato

Controlla la connessione sia in Atoms sia in GitHub prima di fare affidamento sul repository.

1. In Atoms, conferma che Repository Status mostri Connected.
2. Sotto Branches, controlla che un branch abbia un segno di spunta. Questo è il branch attualmente collegato al tuo progetto Atoms. Se sei nuovo su GitHub, mantieni selezionato questo branch.
3. Seleziona View on GitHub.
4. In GitHub, conferma che il repository:
   • appartenga all'account GitHub corretto;
   • sia contrassegnato come Private;
   • contenga i file di progetto previsti; e
   • abbia almeno un commit.

Se il repository è vuoto e Push Changes è disponibile in Atoms, selezionalo e attendi il completamento dell'operazione. Poi aggiorna la pagina del repository in GitHub e controlla che i file del progetto ora siano visibili.

Controlla il repository collegato e il branch selezionato in Atoms.

Verifica il repository privato e i file del progetto in GitHub.

Mantieni Atoms e GitHub sincronizzati

Atoms e GitHub non restano sincronizzati automaticamente. Quando vengono apportate modifiche da un lato, usa i controlli di sincronizzazione per trasferire tali modifiche all'altro.

Azione	Usalo quando	Cosa succede
Push Changes	Hai apportato modifiche in Atoms e vuoi inviarle a GitHub.	Atoms invia i file correnti del progetto al branch GitHub selezionato.
Pull Updates	Sono state apportate modifiche al branch selezionato in GitHub e vuoi importarle in Atoms.	Atoms aggiorna il progetto con le modifiche più recenti da GitHub.

Prima di inviare o importare modifiche, attendi che l'Agente finisca e assicurati di visualizzare la versione più recente del progetto nella Chat. Se hai aperto una versione precedente da History, torna alla scheda della versione più recente in fondo alla Chat, quindi riapri GitHub.

Se non sei sulla versione più recente, Atoms mostra You must be on the latest version to pull updates or push changes.

Prima di sincronizzare, controlla anche che il branch selezionato sia quello che vuoi aggiornare.

Se sia Atoms sia GitHub contengono modifiche che devi conservare, non sincronizzarli ancora. Salva prima una copia del lavoro importante oppure chiedi a qualcuno che conosca GitHub di preservare le modifiche su un branch separato.

Se Repository Status mostra Upstream Changes Available, GitHub contiene modifiche che Atoms non ha ancora. Esamina il repository prima di scegliere un'azione.

Usa Pull Updates e Push Changes per il branch selezionato.

Invia le modifiche da Atoms a GitHub

1. Termina le modifiche in Atoms e attendi che l'Agente smetta di lavorare.
2. Assicurati di visualizzare la versione più recente del progetto.
3. Apri Settings → Connectors → GitHub e controlla che sia selezionato il branch corretto.
4. Seleziona Push Changes.
5. Tieni aperta la pagina mentre le modifiche vengono inviate.
6. Quando appare Changes pushed successfully, seleziona View on GitHub e controlla che i file più recenti del progetto siano presenti.

Push Changes è disponibile solo quando Atoms ha modifiche che non sono ancora state inviate a GitHub. Non è disponibile mentre l'Agente sta lavorando o quando stai visualizzando una versione precedente del progetto.

Una volta selezionato Push Changes, le modifiche vengono inviate immediatamente a GitHub senza chiedere conferma. Se lo stesso file è stato modificato sia in Atoms sia in GitHub, la versione in Atoms ha la priorità e sovrascriverà la versione attualmente archiviata in GitHub.

Importa aggiornamenti da GitHub in Atoms

A differenza dell'invio, importare modifiche richiede prima una conferma. Se lo stesso file è stato modificato sia in GitHub sia in Atoms, la versione GitHub ha la priorità e sovrascriverà la versione corrente in Atoms.

1. Apri Settings → Connectors → GitHub.
2. Controlla che Repository Status mostri nuove modifiche da GitHub e che sia selezionato il branch corretto.
3. Seleziona Pull Updates.
4. Leggi l'avviso Pull May Affect Project. Se vuoi importare nel tuo progetto Atoms corrente le modifiche di GitHub, seleziona Confirm.
5. Tieni aperta la pagina mentre le modifiche vengono importate.
6. Quando appare Changes pulled successfully, apri il Visualizzatore App e testa le parti del tuo progetto interessate dalle modifiche per assicurarti che tutto continui a funzionare come previsto.

Pull Updates è disponibile solo quando il branch GitHub selezionato contiene modifiche che non sono ancora state importate in Atoms.

Disconnetti GitHub

Disconnetti GitHub quando non vuoi più che Atoms acceda all'account collegato. Il repository GitHub e i suoi file rimarranno in GitHub, ma Atoms non sarà più in grado di inviare o importare modifiche.

L'autorizzazione GitHub si applica all'account collegato. Revocare l'accesso disconnette ogni progetto Atoms che usa quell'account GitHub, quindi controlla gli altri tuoi progetti prima di continuare.

1. Apri Settings → Connectors → GitHub.
2. Seleziona Disconnect.
3. Nella conferma Disconnect GitHub, seleziona di nuovo Disconnect.
4. GitHub dovrebbe aprire automaticamente la pagina di autorizzazione pertinente. Se non lo fa, in GitHub vai su Settings → Applications → Authorized OAuth Apps.
5. Trova Atoms, seleziona ... a destra della sua riga, quindi seleziona Revoke. Non selezionare Revoke all; questa azione rimuove l'accesso per ogni app OAuth autorizzata elencata nella pagina.
6. Segui gli eventuali passaggi di conferma richiesti da Github.
7. Torna su Atoms e riapri il connettore GitHub per confermare che l'account non sia più collegato.

Seleziona Disconnect nel connettore GitHub.

Revoca solo l'applicazione OAuth di Atoms in GitHub.