שמירת notebook ב-GitHub

בדף הזה מוסבר איך אפשר לשמור את קובצי ה-notebook של מופע Vertex AI Workbench ב-GitHub באמצעות התוסף jupyterlab-git. אפשר לעשות את זה כדי ליצור גיבוי של המחברת או כדי להפוך את המחברת לזמינה לאנשים אחרים.

במכונות של Vertex AI Workbench, אפשר להשתמש בתוסף jupyterlab-git כדי לנהל את הגרסאות. מידע נוסף זמין ב-jupyterlab-git ב-GitHub.

יצירת מאגר ב-GitHub

אם עדיין אין לכם מאגר GitHub, אתם צריכים ליצור אחד.

כשיוצרים מאגר ב-GitHub, חשוב לוודא שאפשר לשכפל אותו. לשם כך, מסמנים את התיבה Initialize this repository with a README.

מאתחלים מאגר ב-GitHub עם קובץ README.

שכפול מאגר GitHub במכונה של Vertex AI Workbench

כדי לשכפל את מאגר GitHub במכונה של Vertex AI Workbench, פועלים לפי השלבים הבאים:

  1. במאגר GitHub, לוחצים על הלחצן Code ואז על הכרטיסייה Local.

  2. מעתיקים את כתובת ה-URL של HTTPS.

  3. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

  4. לוחצים על Open JupyterLab כדי לפתוח את מכונת Vertex AI Workbench.

  5. ב-JupyterLab, בFile Browser (סייר הקבצים) , בוחרים את התיקייה שבה רוצים לשכפל את המאגר ב-GitHub. לדוגמה, תיקיית הבית.

    מנהל הקבצים והתיקיות של JupyterLab ב-Vertex AI Workbench, עם הדגשה של תיקיית הבית שאפשר לשכפל בה מאגר GitHub.

  6. ב-JupyterLab, בוחרים באפשרות Git > Clone a Repository (שכפול מאגר).

  7. בתיבת הדו-שיח Clone a repo (שיבוט מאגר), מדביקים את כתובת ה-URL של ה-HTTPS של מאגר GitHub.

    תיבת דו-שיח שבה מוצג השדה לכתובת ה-URL של המאגר ואפשרויות לתת-מודולים ולהורדת המאגר.

  8. אם מתבקשים, מזינים את פרטי הכניסה.

    • אם משתמשים בשם משתמש ובסיסמה ב-GitHub, מזינים את שם המשתמש והסיסמה ב-GitHub.

    • אם אתם משתמשים באימות דו-שלבי ב-GitHub, אתם צריכים ליצור אסימון גישה אישי ולהשתמש בו.

  9. לוחצים על Clone (שיבוט).

  10. המאגר מוצג כמו תיקייה חדשה במכונת Vertex AI Workbench. אם המאגר המשוכפל של GitHub לא מופיע כתיקייה, לוחצים על הלחצן רענון רשימת הקבצים.

    מנהל הקבצים והתיקיות של JupyterLab ב-Vertex AI Workbench, עם לחצן הרענון של רשימת הקבצים שמודגש.

הגדרת המופע עם פרטי המשתמש שלכם ב-GitHub

  1. ב-JupyterLab, פותחים את התיקייה שבה נמצא המאגר.

  2. בוחרים באפשרות Git > Open Git Repository in Terminal כדי לפתוח חלון טרמינל של Git.

  3. בחלון הטרמינל של Git, מזינים את הפקודות הבאות כדי להגדיר את שם המשתמש וכתובת האימייל שלכם ב-Git:

    git config --global user.name "USERNAME"
git config --global user.email "EMAIL_ADDRESS"

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫USERNAME: שם המשתמש שלכם ב-GitHub
    • EMAIL_ADDRESS: כתובת האימייל שלכם בחשבון GitHub

  4. אם בחשבון GitHub שלכם נדרש אימות SSH, צריך לבצע את השלבים הבאים כדי לחבר את החשבון:

    1. במסוף Git במופע Vertex AI Workbench, פועלים לפי ההוראות של GitHub ליצירת מפתח SSH חדש.

    2. פועלים לפי ההוראות להוספת מפתח ה-SSH לחשבון GitHub.

  5. סוגרים את חלון הטרמינל של Git.

הוספת הקבצים שבוצעו בהם שינויים למאגר ב-GitHub

  1. ב-JupyterLab, פותחים את התיקייה שבה נמצא המאגר.

  2. הוספת מחברת חדשה

  3. בוחרים בכרטיסייה Git. המחברת החדשה מופיעה בקבוצה Untracked.

  4. כדי להוסיף את ה-Notebook החדש כקובץ למאגר GitHub, לוחצים לחיצה ימנית על ה-Notebook החדש ובוחרים באפשרות Track (מעקב). בכרטיסייה Git, מחברת ה-Notebook נוספה עכשיו לקבוצה Staged.

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

  6. בוחרים באפשרות Git > Push to Remote (שליחה למאגר מרוחק).

    • אם משתמשים בשם משתמש ובסיסמה ב-GitHub, מזינים את שם המשתמש והסיסמה ב-GitHub כשמתבקשים.

    • אם אתם משתמשים באימות דו-שלבי ב-GitHub, צריך להזין את שם המשתמש שלכם ב-GitHub ואת אסימון הגישה האישי.

    אחרי שהפקודה git push מסתיימת, הקבצים שביצעתם לגביהם פעולת Commit נמצאים במאגר GitHub.

המאמרים הבאים