Connectez votre projet Atoms à GitHub pour conserver son code dans un dépôt privé et déplacer les modifications entre Atoms et GitHub sans utiliser de commandes Git.

Ce guide explique l’ensemble du processus de configuration : connecter votre compte GitHub à Atoms, créer le dépôt, confirmer que la connexion fonctionne et maintenir synchronisées les versions de votre projet dans Atoms et GitHub.

Comment fonctionne la connexion

La connexion à GitHub se déroule en 2 étapes :

1. Connectez votre compte GitHub. Cela donne à Atoms l’autorisation d’utiliser GitHub en votre nom.
2. Créez un dépôt pour votre projet. Un dépôt est l’espace privé dans GitHub où sont stockés le code de votre projet et son historique des modifications.

Atoms crée actuellement un nouveau dépôt privé dans le compte GitHub personnel de l’utilisateur connecté. Vous ne pouvez pas vous connecter à un dépôt existant, créer le dépôt sous une organisation, ni le rendre public via le connecteur.

Avant de commencer

Avant de connecter votre projet à GitHub, assurez-vous que :

• Votre forfait Atoms inclut la connexion GitHub. Si vous utilisez le forfait Free, sélectionner GitHub vous redirigera vers la page Plans.
• Seul le propriétaire de l’espace de travail peut connecter ou déconnecter GitHub. Si vous êtes éditeur, demandez au propriétaire de l’espace de travail d’effectuer cette étape.
• Vous avez un compte GitHub ou êtes prêt à en créer un pendant la configuration.
• Votre navigateur autorise les fenêtres pop-up provenant d’Atoms.
• Aucun Agent ne travaille actuellement sur votre projet.

Vous n’avez pas besoin d’un jeton d’accès personnel GitHub pour connecter votre compte. Ne collez jamais de jetons GitHub, mots de passe ou autres identifiants dans le Chat.

Connectez votre compte GitHub

Ouvrir le connecteur GitHub

1. Ouvrez le projet que vous souhaitez connecter.
2. Cliquez sur le nom du projet, en haut à droite du panneau de chat.
3. Sélectionnez Connectors dans le menu déroulant qui apparaît.
4. Trouvez Github dans la liste des connecteurs disponibles, puis cliquez sur connect.

Vous pouvez également ouvrir Settings → Connectors → GitHub et sélectionner Connect.

Ouvrez Settings → Connectors et sélectionnez Connect pour GitHub.

Autoriser Atoms dans GitHub

Si Connected Account affiche déjà le compte GitHub que vous souhaitez utiliser, cela signifie qu’il a déjà été autorisé. Vous pouvez passer à Create a private repository.

1. Atoms ouvre une fenêtre d’autorisation GitHub. Connectez-vous au compte GitHub que vous souhaitez relier, ou créez un nouveau compte si nécessaire.
2. Vérifiez que vous êtes connecté au bon compte GitHub.
3. Examinez les autorisations demandées par Atoms. Si vous êtes d’accord, sélectionnez Authorize Atoms-Agents.
4. Revenez à Atoms et attendez le message Connect success.
5. Dans Atoms, ouvrez Connectors et confirmez que votre compte GitHub apparaît comme connecté.

Atoms demande les autorisations OAuth repo, read:user et workflow. Elles permettent à Atoms de lire et d’écrire dans les dépôts publics et privés auxquels le compte connecté peut accéder, de lire les informations de profil de base et d’ajouter ou de mettre à jour les fichiers de workflow GitHub Actions.

Cette autorisation s’applique au compte GitHub connecté et n’est pas limitée au dépôt créé pour le projet Atoms actuel. Atoms ne peut pas accéder aux dépôts auxquels le compte connecté lui-même ne peut pas accéder, et les politiques d’organisation peuvent imposer des restrictions supplémentaires.

Examinez les autorisations GitHub et sélectionnez Authorize Atoms-Agents.

Créer un dépôt privé

Après avoir autorisé votre compte GitHub, créez le dépôt privé qui stockera le code de votre projet.

1. Sous Connected Account, vérifiez que le nom d’utilisateur affiché correspond au compte GitHub que vous souhaitez utiliser.
2. Sous Create New Repository, saisissez un nom pour le dépôt. Le nom doit :
   • contenir entre 1 et 100 caractères ;
   • utiliser uniquement des lettres, des chiffres, des tirets (-), des underscores (_) ou des points (.).
3. Sélectionnez Create.
4. Attendez le message GitHub repository connected successfully!.

Atoms crée un nouveau dépôt privé dans le compte GitHub personnel de l’utilisateur connecté, le relie au projet Atoms actuel, puis tente de téléverser les fichiers actuels du projet vers GitHub.

Saisissez un nom et créez un nouveau dépôt privé.

Vérifier que la connexion a fonctionné

Vérifiez la connexion à la fois dans Atoms et dans GitHub avant de vous fier au dépôt.

1. Dans Atoms, confirmez que Repository Status affiche Connected.
2. Sous Branches, vérifiez qu’une branche comporte une coche. Il s’agit de la branche actuellement connectée à votre projet Atoms. Si vous débutez avec GitHub, gardez cette branche sélectionnée.
3. Sélectionnez View on GitHub.
4. Dans GitHub, confirmez que le dépôt :
   • appartient au bon compte GitHub ;
   • est marqué Private ;
   • contient les fichiers de projet attendus ; et
   • contient au moins un commit.

Si le dépôt est vide et que Push Changes est disponible dans Atoms, sélectionnez-le et attendez la fin de l’opération. Ensuite, actualisez la page du dépôt dans GitHub et vérifiez que les fichiers du projet apparaissent maintenant.

Vérifiez le dépôt connecté et la branche sélectionnée dans Atoms.

Vérifiez le dépôt privé et les fichiers du projet dans GitHub.

Maintenir Atoms et GitHub synchronisés

Atoms et GitHub ne restent pas synchronisés automatiquement. Lorsque des modifications ont été effectuées d’un côté, utilisez les contrôles de synchronisation pour transférer ces modifications de l’autre côté.

Action	Utilisez-la quand	Ce qui se passe
Push Changes	Vous avez effectué des modifications dans Atoms et souhaitez les envoyer vers GitHub.	Atoms envoie les fichiers actuels du projet vers la branche GitHub sélectionnée.
Pull Updates	Des modifications ont été apportées à la branche sélectionnée dans GitHub et vous souhaitez les récupérer dans Atoms.	Atoms met à jour le projet avec les dernières modifications provenant de GitHub.

Avant d’envoyer ou de récupérer des modifications, attendez que l’Agent ait terminé et assurez-vous d’afficher la dernière version du projet dans le Chat. Si vous avez ouvert une ancienne version depuis History, revenez à la carte de la dernière version en bas du Chat, puis rouvrez GitHub.

Si vous n’êtes pas sur la dernière version, Atoms affiche You must be on the latest version to pull updates or push changes.

Avant de synchroniser, vérifiez également que la branche sélectionnée est bien celle que vous souhaitez mettre à jour.

Si Atoms et GitHub contiennent tous deux des modifications que vous devez conserver, ne les synchronisez pas encore. Enregistrez d’abord une copie du travail important, ou demandez à quelqu’un de familier avec GitHub de préserver les modifications sur une branche séparée.

Si Repository Status affiche Upstream Changes Available, cela signifie que GitHub contient des modifications qu’Atoms n’a pas encore. Examinez le dépôt avant de choisir une action.

Utilisez Pull Updates et Push Changes pour la branche sélectionnée.

Envoyer les modifications d’Atoms vers GitHub

1. Terminez vos modifications dans Atoms et attendez que l’Agent cesse de travailler.
2. Assurez-vous d’afficher la dernière version du projet.
3. Ouvrez Settings → Connectors → GitHub et vérifiez que la bonne branche est sélectionnée.
4. Sélectionnez Push Changes.
5. Laissez la page ouverte pendant l’envoi des modifications.
6. Lorsque Changes pushed successfully apparaît, sélectionnez View on GitHub et vérifiez que les derniers fichiers du projet s’y trouvent.

Push Changes est disponible uniquement lorsqu’Atoms contient des modifications qui n’ont pas encore été envoyées à GitHub. Il n’est pas disponible pendant que l’Agent travaille ou lorsque vous affichez une ancienne version du projet.

Une fois que vous sélectionnez Push Changes, les modifications sont envoyées immédiatement vers GitHub sans demander de confirmation. Si le même fichier a été modifié à la fois dans Atoms et dans GitHub, la version d’Atoms est prioritaire et remplacera la version actuellement stockée dans GitHub.

Récupérer les mises à jour de GitHub dans Atoms

Contrairement à l’envoi, la récupération des modifications nécessite d’abord une confirmation. Si le même fichier a été modifié à la fois dans GitHub et dans Atoms, la version GitHub est prioritaire et remplacera la version actuelle dans Atoms.

1. Ouvrez Settings → Connectors → GitHub.
2. Vérifiez que Repository Status indique de nouvelles modifications provenant de GitHub et que la bonne branche est sélectionnée.
3. Sélectionnez Pull Updates.
4. Lisez l’avertissement Pull May Affect Project. Si vous souhaitez intégrer les modifications GitHub dans votre projet Atoms actuel, sélectionnez Confirm.
5. Laissez la page ouverte pendant la récupération des modifications.
6. Lorsque Changes pulled successfully apparaît, ouvrez la Visionneuse d'App et testez les parties de votre projet affectées par les modifications pour vous assurer que tout fonctionne toujours comme prévu.

Pull Updates est disponible uniquement lorsque la branche GitHub sélectionnée contient des modifications qui n’ont pas encore été récupérées dans Atoms.

Déconnecter GitHub

Déconnectez GitHub lorsque vous ne souhaitez plus qu’Atoms accède au compte connecté. Le dépôt GitHub et ses fichiers resteront dans GitHub, mais Atoms ne pourra plus envoyer ni récupérer de modifications.

L’autorisation GitHub s’applique au compte connecté. Révoquer l’accès déconnecte chaque projet Atoms qui utilise ce compte GitHub, alors vérifiez vos autres projets avant de continuer.

1. Ouvrez Settings → Connectors → GitHub.
2. Sélectionnez Disconnect.
3. Dans la confirmation Disconnect GitHub, sélectionnez à nouveau Disconnect.
4. GitHub devrait ouvrir automatiquement la page d’autorisation correspondante. Si ce n’est pas le cas, dans GitHub allez dans Settings → Applications → Authorized OAuth Apps.
5. Trouvez Atoms, sélectionnez ... à droite de sa ligne, puis sélectionnez Revoke. Ne sélectionnez pas Revoke all ; cette action supprime l’accès pour chaque application OAuth autorisée listée sur la page.
6. Suivez les étapes de confirmation éventuellement demandées par Github.
7. Revenez à Atoms et rouvrez le connecteur GitHub pour confirmer que le compte n’est plus connecté.

Sélectionnez Disconnect dans le connecteur GitHub.

Révoquez uniquement l’application OAuth Atoms dans GitHub.