התקנת הפלאגין Cloud Code for IntelliJ

הפלאגין Cloud Code ל-IntelliJ מוסיף תמיכה בפיתוח Google Cloud לכל סביבות הפיתוח המשולבות (IDE) של JetBrains, כולל IntelliJ (מהדורות Community ו-Ultimate), ‏ GoLand, ‏ PyCharm, ‏ WebStorm (ואחרות).

דרישות מוקדמות

הכלים הבאים צריכים להיות מותקנים ומוגדרים במערכת שלכם וזמינים ב-PATH של המחשב:

  • JetBrains IDE גרסה 2022.3 ואילך

    ה-IDE צריך להיות IDE של JetBrains, כמו אחד מהבאים:

    • ‫IntelliJ Ultimate או Community
    • PyCharm Professional או Community
    • WebStorm
    • GoLand
  • Git כדי ש-Cloud Code יוכל לבצע פעולות Git, כמו שיבוט של דוגמה.

  • Docker ליצירה ולדחיפה של קובצי אימג' של קונטיינרים.

  • אשכול Kubernetes מוגדר שיכול להיות אשכול לפיתוח מקומי, כמו minikube או אשכול Docker Kubernetes, או אשכול מרוחק, כמו אשכול Google Kubernetes Engine. מומלץ להשתמש באשכול minikube לפיתוח מקומי. Cloud Code יכול לנהל את minikube באופן אוטומטי.

  • Google Cloud project with billing enabled if you're using Google Cloud. פרויקטים מאפשרים לכם לאסוף את כל המשאבים שקשורים לאפליקציה אחת במקום אחד, וגם לנהל ממשקי API, להפעיל שירותי Google Cloud, להוסיף שותפי עריכה ולהסיר אותם, ולנהל הרשאות למשאביGoogle Cloud .

התקנת הפלאגין של Cloud Code

מתקינים את הפלאגין של Cloud Code מ-JetBrains Marketplace.

אפשרות אחרת היא להתקין את הפלאגין ישירות מ-IDE:

  1. מפעילים את סביבת הפיתוח המשולבת (IDE).

  2. פותחים את חנות הפלאגינים של סביבת הפיתוח המשולבת:

    • ב-Windows, עוברים אל קובץ > הגדרות > תוספים.
    • ב-macOS, עוברים אל IntelliJ IDEA > Preferences > Plugins.
  3. מזינים Google Cloud Code בשדה החיפוש ומתקינים את הפלאגין Cloud Code.

    פלאגין Cloud Code ב-IntelliJ Marketplace

  4. אם מופיעה בקשה, מפעילים מחדש את סביבת הפיתוח המשולבת כדי להפעיל את הפלאגין.

  5. כדי למנוע התנגשויות אם אתם משתמשים ב-Android Studio כסביבת פיתוח משולבת (IDE), צריך להשבית את הפלאגין Google Cloud Tools for Android Studio אחרי שמתקינים את Cloud Code. הפלאגין Google Cloud Tools for Android Studio יוצא משימוש בקרוב ויוסר באופן מלא בגרסה עתידית של Android Studio.

גרסאות מותאמות אישית של יחסי תלות

כברירת מחדל, Cloud Code מתקין באופן אוטומטי חלק מהתלויות הנדרשות בשורת הפקודה. כדי להשתמש בגרסאות מותאמות אישית של יחסי תלות, צריך להשבית את ניהול יחסי התלות באופן הבא:

  1. מוודאים שהתקנתם גרסאות מותאמות אישית של יחסי התלות:

  2. מציינים את ההגדרות הרלוונטיות של Cloud Code ב-IDE. לשם כך, פותחים את File (קובץ) > Settings (הגדרות) > Tools (כלים) > Cloud Code > Dependencies (תלויות), או ב-Mac OS X, את IntelliJ IDEA > Preferences (העדפות) > Tools (כלים) > Cloud Code > Dependencies (תלויות).

  3. כדי לנהל את ה-CLI של gcloud, בקטע Cloud SDK, בוחרים באפשרות Use a custom local installation (שימוש בהתקנה מקומית בהתאמה אישית), לוחצים על סמל התיקייה Browse (עיון) שליד השדה, עוברים להתקנה של ה-CLI של gcloud שרוצים להשתמש בה ולוחצים על OK (אישור).

  4. כדי לנהל תלות אחרת, בקטע Deployment Tools (כלי פריסה), בוחרים באפשרות Use custom specified dependencies (שימוש בתלות שצוינה בהתאמה אישית), לוחצים על סמל התיקייה Browse (עיון) עבור כל תלות, מציינים נתיב לגרסה המותאמת אישית שרוצים להשתמש בה עבור כל תלות ולוחצים על OK.

אופציונלי: הורדה ואימות של הקובץ הבינארי של Cloud Code

אימות הקובץ הבינארי של Cloud Code עוזר לוודא שלא נעשה שינוי בתוסף Cloud Code במהלך תהליך הפרסום וההפצה.

כדי להוריד את הקובץ הבינארי של Cloud Code Stable או Insiders למחשב:

  1. בדף Plugin versions (גרסאות הפלאגין) של Cloud Code, בוחרים בערוץ Stable (יציב) או Insiders (משתמשי אינסיידר).

    מידע נוסף על גרסת ה-build של Insiders זמין במאמר שימוש בתכונות לפני ההשקה.

  2. מורידים את הגרסה האחרונה של Cloud Code או גרסה שרוצים לאמת ושנכללת בגרסאות הנוכחיות שתומכות באימות:

    • יציבה: כל גרסה אחרי 23.1.1-221/23.1.1-222 (לא כולל 23.1.1-221/23.1.1-222)

    • משתתפי תוכנית Insiders: כל מהדורה אחרי 23.1.1-221-IB.1/23.1.1-222-IB.1 (לא כולל 23.1.1-221-IB.1/23.1.1-222-IB.1)

  3. חשוב לשים לב לנתיב של קובץ הבינארי של Cloud Code (הקובץ google-cloud-code.zip).

כדי לאמת את הקובץ הבינארי של Cloud Code, פועלים לפי השלבים הבאים:

  1. מורידים את הגרסה האחרונה של קובץ marketplace-zip-signer-cli.jar למחשב. רושמים את הנתיב לקובץ jar.

  2. מורידים את DigiCert Trusted Root G4. רושמים את הנתיב לקובץ האישור.

  3. מוודאים ש-JDK מותקן. ההרשאה הזו נדרשת כדי להריץ פקודות Java.

  4. כדי לאמת את הקובץ zip (הקובץ הבינארי של Cloud Code), מריצים את הפקודה הבאה בשורת הפקודה:

    java -jar PATH_TO_ZIP_SIGNER_JAR verify -in PATH_TO_ZIP_FILE -cert PATH_TO_CERTIFICATE_FILE
    

    אם האימות נכשל, אחת מההודעות הבאות מופיעה בפלט של שורת הפקודה:

    • Zip archive is not signed by provided certificate authority.
    • Provided zip archive is not signed.
    • Signature of zip archive is invalid.

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

פנייה לתמיכה

כדי לשלוח משוב או לדווח על בעיה ב-IntelliJ IDE, עוברים אל Tools (כלים) > Cloud Code > Help / About (עזרה / מידע) > Submit feedback or report an issue (שליחת משוב או דיווח על בעיה) כדי לדווח על בעיה ב-GitHub.