פיתוח קוד באמצעות עורך VS Code מקומי

במאמר הזה מוסבר איך לפתוח מנהרת SSH מהמחשב המקומי לתחנת עבודה, ואז להשתמש בתמיכה של VS Code Remote Development כדי להתחבר ל-Cloud Workstations מעורך VS Code המקומי.

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

לפני שמתחילים, חשוב לבצע את השלבים של המשימות האלה:

  1. חשוב לוודא שמישהו בצוות יצר הגדרת תחנת עבודה.
  2. יצירה והפעלה של תחנת עבודה
  3. בזמן שאתם במסוף Google Cloud , מעתיקים את הפרטים הבאים:

    1. שם הפרויקט ומזהה הפרויקט: לוחצים על שם הפרויקט בסרגל התפריטים Google Cloudומעתיקים את המזהה בתיבת הדו-שיח שם הפרויקט ומזהה הפרויקט שנפתחת.
    2. אזור
    3. שם האשכול
    4. שם ההגדרה
  4. במחשב המקומי, מתקינים את gcloud CLI.

    אם אתם מריצים את gcloud CLI בפעם הראשונה, יכול להיות שתצטרכו גם להריץ את gcloud auth login כדי לקבל פרטי כניסה, ואת gcloud config set project PROJECT_ID כדי להגדיר את הפרויקט הנוכחי למזהה הפרויקט שהעתקתם בשלב הקודם.

  5. כשמשתמשים ב-ssh בפעם הראשונה, צריך להתקין תוסף SSH מרחוק כדי להתחבר לתחנת עבודה מעורך VS Code דרך Extension Marketplace או דרך לוח הפקודות.

    Extension Marketplace

    1. פותחים את אפליקציית העורך המקומי VS Code ואז פותחים את Extension Marketplace (חנות התוספים) על ידי בחירה באפשרות Extensions (תוספים)
      בסרגל הפעילות.

    2. לוחצים על Install (התקנה) כדי להתקין את התוסף Remote - SSH.

    3. מזינים remote ssh בשדה החיפוש, וכך נפתח דף התוסף Remote - SSH.

      התקנת התוסף Remote-SSH

    לוח הפקודות

    1. כדי לפתוח את לוח הפקודות, מקישים על Control+Shift+P (או על Command+Shift+P ב-macOS) או לוחצים על View > Command Palette.

    2. מזינים ext install ms-vscode-remote.remote-ssh כדי להתקין את התוסף.

פתיחת מנהרת SSH

פותחים מנהרת SSH מהמכונה המקומית לתחנת עבודה באמצעות הפקודה gcloud workstations start-tcp-tunnel:

  1. במסוף Google Cloud , נכנסים לדף Workstations > Cloud Workstations.

    אל Workstations

  2. לוחצים על שם תחנת העבודה כדי לפתוח את הדף פרטי תחנת העבודה.

  3. בדוגמה הבאה, מחליפים את ה-placeholders בשם תחנת העבודה, באזור (מיקום), בשם האשכול של תחנת העבודה ובשם ההגדרה של תחנת העבודה. מעתיקים את הערכים מהחלונית Workstation details (פרטי תחנת העבודה) אל מצייני המיקום שמסומנים בסמל העריכה.

    gcloud workstations start-tcp-tunnel \
      --project=PROJECT_ID \
      --region=REGION \
      --cluster=CLUSTER_NAME \
      --config=CONFIG_NAME \
      --local-host-port=:LOCAL_PORT \
      WORKSTATION_NAME 22
    

    בקטע לפני שמתחילים מוסבר איך למצוא את מזהה הפרויקט.

    הדגל --local-host-port=:LOCAL_PORT הוא אופציונלי. אם רוצים לציין יציאה מקומית, מחליפים את LOCAL_PORT במספר היציאה המקומית שרוצים להשתמש בה. אם לא מציינים יציאה מקומית, המערכת בוחרת יציאה מקומית שרירותית שלא נמצאת בשימוש, ומציגה הודעה עם מספר היציאה כדי שתדעו באיזו יציאה מקומית היא משתמשת.

  4. אחרי שממלאים את ה-placeholders, לוחצים על content_copy Copy code sample כדי להעתיק את דוגמת הקוד של gcloud CLI.

  5. מדביקים את הפקודה בחלון המסוף המקומי ומקישים על Enter כדי ליצור את המנהרה.

    אם הפקודה מצליחה, מופיעה ההודעה Listening on port ואחריה מספר היציאה המקומית.

מידע נוסף על כל דגל הגדרה זמין במאמרים בנושא מנהרת SSH או start-tcp-tunnel.

חיבור למארח של Cloud Workstations

כדי להתחבר למארח של Cloud Workstations:

  1. פותחים את אפליקציית VS Code או חוזרים אליה.
  2. כדי להפעיל את Remote - SSH, לוחצים על Open a Remote Window (פתיחת חלון מרוחק) בסרגל הסטטוס.

  3. כשלוח הפקודות נפתח, בוחרים באפשרות התחברות למארח.

    התחברות למארח

  4. מזינים user@localhost:LOCAL_PORT ומחליפים את LOCAL_PORT במספר היציאה המקומי.

    בדוגמה הבאה מתחברים ליציאה מקומית 1025 על ידי ציון user@localhost:1025.

    הוספת מארח SSH

  5. אם מוצגת בקשה להתחבר אחרי שמופיעה הודעת האישור המארח נוסף, לוחצים על התחברות.

    יכול להיות שהמערכת תבקש מכם לאשר את הגיבוב. אם מוצגת בקשה לעשות זאת, לוחצים על המשך.

  6. ייפתח עורך חדש של VS Code ובשורת הסטטוס של VS Code יוצג SSH: localhost:‎ ואחריו מספר היציאה.

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

    בדוגמה הבאה מוצג חלון של עורך VS Code שמחובר ל-Cloud Workstations דרך SSH: localhost: 1025.

    מחובר לתחנת עבודה

    אפשר גם לחזור אל Extensions Marketplace כדי להתקין את Cloud Code ותוספים מקומיים אחרים של VS Code שיעזרו לכם ליצור, להריץ ולבדוק את הקוד.