חבר את GitHub

מדריך זה מסביר את כל תהליך ההגדרה: חיבור חשבון ה-GitHub שלך ל-Atoms, יצירת המאגר, אישור שהחיבור פועל, ושמירה על סנכרון בין גרסאות הפרויקט שלך ב-Atoms וב-GitHub.

איך החיבור עובד

יש 2 שלבים לחיבור ל-GitHub:

1. חבר את חשבון ה-GitHub שלך. כך Atoms מקבל הרשאה לעבוד עם GitHub בשמך.
2. צור מאגר עבור הפרויקט שלך. מאגר הוא המרחב הפרטי ב-GitHub שבו מאוחסנים קוד הפרויקט שלך והיסטוריית השינויים.

Atoms יוצר כרגע מאגר פרטי חדש בחשבון ה-GitHub האישי של המשתמש המחובר. אי אפשר להתחבר למאגר קיים, ליצור את המאגר תחת ארגון, או להפוך אותו לציבורי דרך המחבר.

לפני שמתחילים

לפני חיבור הפרויקט שלך ל-GitHub, ודא ש:

• תוכנית Atoms שלך כוללת חיבור ל-GitHub. אם אתה בתוכנית Free בחירה ב-GitHub תעביר אותך לעמוד Plans .
• רק בעל סביבת העבודה יכול לחבר או לנתק את GitHub. אם אתה עורך, בקש מבעל סביבת העבודה לבצע שלב זה.
• יש לך חשבון GitHub או שאתה מוכן ליצור אחד במהלך ההגדרה.
• הדפדפן שלך מאפשר חלונות קופצים מ-Atoms.
• אף Agents לא עובדים כרגע על הפרויקט שלך.

אינך צריך אסימון גישה אישי של GitHub כדי לחבר את החשבון שלך. לעולם אל תדביק אסימוני GitHub, סיסמאות או פרטי גישה אחרים ב-Chat.

חבר את חשבון ה-GitHub שלך

פתח את מחבר GitHub

1. פתח את הפרויקט שברצונך לחבר.
2. לחץ על שם הפרויקט בפינה הימנית העליונה של חלונית הצ'אט.
3. בחר Connectors בתפריט הנפתח שמופיע.
4. מצא את Github ברשימת המחברים הזמינים, ולחץ על connect.

אפשר גם לפתוח את Settings → Connectors → GitHub ולבחור Connect.

פתח את Settings → Connectors ובחר Connect עבור GitHub.

אשר את Atoms ב-GitHub

אם Connected Account כבר מציג את חשבון ה-GitHub שבו ברצונך להשתמש, הוא כבר אושר. אפשר להמשיך אל Create a private repository.

1. Atoms פותח חלון הרשאה של GitHub. היכנס לחשבון ה-GitHub שברצונך לחבר, או צור חשבון חדש אם צריך.
2. בדוק שאתה מחובר לחשבון ה-GitHub הנכון.
3. עבור על ההרשאות ש-Atoms מבקש. אם אתה מסכים, בחר Authorize Atoms-Agents.
4. חזור אל Atoms והמתן להודעת Connect success .
5. ב-Atoms, פתח את Connectors ואשר שחשבון ה-GitHub שלך מופיע כמחובר.

Atoms מבקש את הרשאות repo, read:user, ו- workflow OAuth. אלה מאפשרות ל-Atoms לקרוא ולכתוב למאגרים ציבוריים ופרטיים שאליהם לחשבון המחובר יש גישה, לקרוא פרטי פרופיל בסיסיים, ולהוסיף או לעדכן קובצי workflow של GitHub Actions .

הרשאה זו חלה על חשבון ה-GitHub המחובר ואינה מוגבלת למאגר שנוצר עבור פרויקט Atoms הנוכחי. Atoms לא יכול לגשת למאגרים שלחשבון המחובר עצמו אין גישה אליהם, ומדיניות ארגונית עשויה להטיל מגבלות נוספות.

עבור על הרשאות GitHub ובחר Authorize Atoms-Agents.

Create a private repository

לאחר אישור חשבון ה-GitHub שלך, צור את המאגר הפרטי שיאחסן את קוד הפרויקט שלך.

1. תחת Connected Account, בדוק ששם המשתמש המוצג תואם לחשבון ה-GitHub שבו ברצונך להשתמש.
2. תחת Create New Repository, הזן שם למאגר. השם חייב:
   • להכיל 1–100 תווים;
   • להשתמש רק באותיות, מספרים, מקפים (-), קווים תחתונים (_), או נקודות (.).
3. בחר Create.
4. המתן להודעת GitHub repository connected successfully! .

Atoms יוצר מאגר פרטי חדש בחשבון ה-GitHub האישי של המשתמש המחובר, מקשר אותו לפרויקט Atoms הנוכחי, ולאחר מכן מנסה להעלות את הקבצים הנוכחיים של הפרויקט ל-GitHub.

הזן שם וצור מאגר פרטי חדש.

בדוק שהחיבור פעל

בדוק את החיבור גם ב-Atoms וגם ב-GitHub לפני שאתה מסתמך על המאגר.

1. ב-Atoms, אשר ש- Repository Status מציג Connected.
2. תחת Branches, בדוק שלענף אחד יש סימן ביקורת. זהו הענף שמחובר כרגע לפרויקט Atoms שלך. אם אתה חדש ב-GitHub, השאר את הענף הזה נבחר.
3. בחר View on GitHub.
4. ב-GitHub, אשר שהמאגר:
   • שייך לחשבון ה-GitHub הנכון;
   • מסומן כ- Private;
   • מכיל את קובצי הפרויקט הצפויים; ו-
   • כולל לפחות commit.

אם המאגר ריק ו- Push Changes זמין ב-Atoms, בחר בו והמתן לסיום הפעולה. לאחר מכן רענן את דף המאגר ב-GitHub ובדוק שקובצי הפרויקט מופיעים כעת.

בדוק את המאגר המחובר ואת הענף שנבחר ב-Atoms.

אמת את המאגר הפרטי ואת קובצי הפרויקט ב-GitHub.

שמור על סנכרון בין Atoms ל-GitHub

Atoms ו-GitHub אינם נשארים מסונכרנים אוטומטית. כאשר בוצעו שינויים בצד אחד, השתמש בפקדי הסנכרון כדי להעביר את השינויים לצד השני.

פעולה	השתמש בזה כאשר	מה קורה
Push Changes	ביצעת שינויים ב-Atoms ואתה רוצה לשלוח אותם ל-GitHub.	Atoms שולח את קובצי הפרויקט הנוכחיים לענף ה-GitHub שנבחר.
Pull Updates	בוצעו שינויים בענף שנבחר ב-GitHub ואתה רוצה להביא אותם אל Atoms.	Atoms מעדכן את הפרויקט עם השינויים האחרונים מ-GitHub.

לפני שאתה דוחף או מושך שינויים, המתן עד ש- Agent יסיים וודא שאתה צופה בגרסה העדכנית ביותר של הפרויקט ב-Chat. אם פתחת גרסה ישנה יותר מתוך History, חזור לכרטיס הגרסה העדכנית בתחתית ה-Chat, ואז פתח מחדש את GitHub.

אם אינך בגרסה העדכנית ביותר, Atoms מציג You must be on the latest version to pull updates or push changes.

לפני הסנכרון, בדוק גם שהענף שנבחר הוא זה שברצונך לעדכן.

אם גם Atoms וגם GitHub מכילים שינויים שעליך לשמור, אל תסנכרן אותם עדיין. שמור קודם עותק של העבודה החשובה, או בקש ממישהו שמכיר את GitHub לשמור את השינויים בענף נפרד.

אם Repository Status מציג Upstream Changes Available, GitHub מכיל שינויים שעדיין אינם קיימים ב-Atoms. עבור על המאגר לפני בחירת פעולה.

השתמש ב-Pull Updates וב-Push Changes עבור הענף שנבחר.

דחוף שינויים מ-Atoms ל-GitHub

1. סיים לבצע את השינויים שלך ב-Atoms והמתן עד ש- Agent יפסיק לעבוד.
2. ודא שאתה צופה בגרסה העדכנית ביותר של הפרויקט.
3. פתח את Settings → Connectors → GitHub ובדוק שהענף הנכון נבחר.
4. בחר Push Changes.
5. השאר את הדף פתוח בזמן שהשינויים נדחפים.
6. כאשר Changes pushed successfully מופיע, בחר View on GitHub ובדוק שקובצי הפרויקט העדכניים נמצאים שם.

Push Changes זמין רק כאשר ל-Atoms יש שינויים שעדיין לא נשלחו ל-GitHub. הוא אינו זמין בזמן ש- Agent עובד או כאשר אתה צופה בגרסה ישנה יותר של הפרויקט.

ברגע שתבחר Push Changes, השינויים יישלחו ל-GitHub מיד בלי לבקש אישור. אם אותו קובץ שונה גם ב-Atoms וגם ב-GitHub, הגרסה שב-Atoms תקבל עדיפות ותדרוס את הגרסה שמאוחסנת כרגע ב-GitHub.

משוך עדכונים מ-GitHub אל Atoms

בשונה מדחיפה, משיכת שינויים דורשת קודם אישור. אם אותו קובץ שונה גם ב-GitHub וגם ב-Atoms, הגרסה של GitHub תקבל עדיפות ותדרוס את הגרסה הנוכחית ב-Atoms.

1. פתח את Settings → Connectors → GitHub.
2. בדוק ש- Repository Status מציג שינויים חדשים מ-GitHub ושהענף הנכון נבחר.
3. בחר Pull Updates.
4. קרא את אזהרת Pull May Affect Project אם ברצונך להביא את השינויים מ-GitHub אל פרויקט Atoms הנוכחי שלך, בחר Confirm.
5. השאר את הדף פתוח בזמן שהשינויים נמשכים.
6. כאשר Changes pulled successfully מופיע, פתח את App Viewer ובדוק את החלקים בפרויקט שלך שהושפעו מהשינויים כדי לוודא שהכול עדיין עובד כמצופה.

Pull Updates זמין רק כאשר ענף ה-GitHub שנבחר מכיל שינויים שעדיין לא הובאו אל Atoms.

נתק את GitHub

נתק את GitHub כאשר אינך רוצה עוד ש-Atoms ייגש לחשבון המחובר. מאגר ה-GitHub והקבצים שלו יישארו ב-GitHub, אבל Atoms לא יוכל עוד לדחוף או למשוך שינויים.

הרשאת GitHub חלה על החשבון המחובר. ביטול הגישה מנתק כל פרויקט Atoms שמשתמש באותו חשבון GitHub, לכן בדוק את הפרויקטים האחרים שלך לפני שתמשיך.

1. פתח את Settings → Connectors → GitHub.
2. בחר Disconnect.
3. בחלון נתק את GitHub האישור, בחר Disconnect שוב.
4. GitHub אמור לפתוח אוטומטית את דף ההרשאה הרלוונטי. אם לא, ב-GitHub עבור אל Settings → Applications → Authorized OAuth Apps.
5. מצא את Atoms, בחר ... מימין לשורה שלו, ואז בחר Revoke. אל תבחר Revoke all; פעולה זו מסירה גישה לכל אפליקציית OAuth מורשית שמופיעה בדף.
6. בצע את כל שלבי האישור הנדרשים מצד Github.
7. חזור אל Atoms ופתח מחדש את GitHub המחבר כדי לאשר שהחשבון כבר לא מחובר.

בחר Disconnect במחבר GitHub.

בטל ב-GitHub רק את אפליקציית ה-OAuth של Atoms.