פריסה בסביבה הגמישה של App Engine ב-Cloud Code ל-IntelliJ

במאמר הזה מוסבר איך לפרוס אפליקציית App Engine בסביבה הגמישה של App Engine מתוך IntelliJ IDEA.

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

  • פועלים לפי המדריך יצירת אפליקציה כדי להתקין ולהגדיר את Cloud Code וגם כדי ליצור אפליקציית App Engine לסביבה הגמישה. חשוב להוסיף תמיכה במסגרת הגמישה של App Engine.

    אם אין לכם אפליקציה אבל אתם עדיין רוצים לנסות את תהליכי הפריסה האלה, אתם יכולים להוריד את האפליקציה לדוגמה:

    1. משכפלים את אפליקציית הדוגמה של Spring Boot למחשב המקומי:

       git clone https://github.com/spring-guides/gs-spring-boot
      
    2. ב-IntelliJ, בוחרים באפשרות File (קובץ) > Open (פתיחה) כדי לפתוח את בורר הקבצים.

    3. נווט אל /gs-spring-boot/.

    4. בוחרים את הספרייה /complete/.

    5. לוחצים על OK.

    6. הוספת תמיכה ב-framework גמיש של App Engine.

יצירת הגדרת הפריסה

  1. בוחרים באפשרות Tools > Cloud Code > App Engine > Deploy to App Engine.

    תיבת הדו-שיח ליצירת הגדרות פריסה. כולל שדות לציון שם, שרת, פריסה, פרויקט, גרסה ו-app.yaml.

  2. מאשרים את הגדרת השרת:

    1. לוחצים על סמל האליפסה (…‎) לצד השדה Server.

    2. בתיבת הדו-שיח, מוודאים שבשדה שם מופיע Google App Engine.

    3. לוחצים על OK.

  3. בוחרים את המקור פריסה.

    ‫Cloud Code ל-IntelliJ תומך בפריסה מארטיפקט של Maven, מארטיפקט ספציפי ל-IntelliJ או מקובץ JAR או WAR של מערכת קבצים.

    1. אם בוחרים קובץ JAR או WAR של מערכת קבצים כמקור הפריסה, לוחצים על סמל האליפסה (…) שליד השדה ארכיון הפריסה כדי לנווט לארכיון הפריסה.
  4. בוחרים פרויקט בשדה Project (פרויקט).

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

  5. בקטע App Engine Flexible Configuration (הגדרה גמישה של App Engine), בוחרים קובץ app.yaml תקין.

    1. אם בתפריט הנפתח לא מופיע קובץ app.yaml תקין, לוחצים על עריכה כדי לבחור קובץ. מידע נוסף זמין בקטע עדכון ההגדרות הגמישות של App Engine.
  6. ממלאים שדות אחרים לפי הצורך כדי להגדיר את הפריסה.

  7. לוחצים על Run כדי ליצור ולפרוס את האפליקציה.

  8. בחלון Application Servers (שרתי אפליקציות), לוחצים על שם הפרויקט כדי לעקוב אחר התקדמות הפריסה שלו. אם החלון לא מוצג, לוחצים על תצוגה > חלונות כלים > שרתי אפליקציות.

    אחרי שהפריסה מסתיימת, אפשר לראות את כתובת ה-URL של האפליקציה בפלט של המסוף.

פריסה לסביבת זמן ריצה בהתאמה אישית

אתם יכולים לשנות את קובץ app.yaml כדי לפרוס את האפליקציה בסביבת ריצה מותאמת אישית באמצעות קובץ Docker.

  1. בקובץ app.yaml, מגדירים את זמן הריצה לערך custom.

  2. במהלך השלמת השלבים של יצירת הגדרת הפריסה, הקטע App Engine Flexible Configuration מציג את הנתיב לקובץ app.yaml ולקובץ Docker.

    תיבת דו-שיח שבה מוצג הקטע של הגדרות גמישות של App Engine במסך של יצירת הגדרות פריסה. שדה שבו מוצגת הנתיב לקובץ app.yaml. יש כפתור עריכה שאפשר ללחוץ עליו כדי לבחור קובץ אחר. תווית שמציגה את זמן הריצה כהתאמה אישית. תווית שמציגה את הנתיב של קובץ Docker. בשדה 'שם ארטיפקט בהמתנה' מוצגת הנתיב לקובץ Docker.

  3. לוחצים על עריכה כדי לבחור קובצי app.yaml ו-Docker תקינים.

    תיבת דו-שיח שבה מוצג הקטע של הגדרות גמישות של App Engine במסך של יצירת הגדרות פריסה. שדה שבו מוצגת הנתיב לקובץ app.yaml. יש כפתור עריכה שאפשר ללחוץ עליו כדי לבחור קובץ אחר. תווית שמציגה את זמן הריצה כהתאמה אישית. תווית שמציגה את הנתיב של קובץ Docker. בשדה 'שם ארטיפקט בהמתנה' מוצגת הנתיב לקובץ Docker.

  4. לוחצים על סמל האליפסה (…‎) לצד השדות app.yaml ו-Dockerfile Directory כדי לעבור לקבצים המתאימים.

  5. לוחצים על OK.

עדכון ההגדרות של הסביבה הגמישה של App Engine

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

  1. בוחרים באפשרות File > Project Structure (קובץ > מבנה הפרויקט).

    מופיעה תיבת הדו-שיח Project Structure.

  2. בקטע Project Settings (הגדרות הפרויקט), בוחרים באפשרות Facets (היבטים).

  3. בוחרים את ההיבט 'סביבה גמישה של App Engine'.

  4. כדי לבחור קובץ app.yaml, לוחצים על סמל האליפסה (…‎) לצד השדה app.yaml כדי לעבור למיקום של קובץ תקין.

  5. אם אתם פורסים לסביבת ריצה בהתאמה אישית, לוחצים על סמל האליפסה (…‎) לצד השדה Dockerfile directory (ספריית Dockerfile) כדי לעבור למיקום של קובץ תקין.

  6. לוחצים על OK.

מחיקת השרת

אם תרצו למחוק את השרת שהגדרתם לפרויקט, תוכלו לעשות זאת כך:

  1. בוחרים באפשרות File (קובץ) > Settings (הגדרות) > Build, Execution, Deployment (בנייה, הפעלה, פריסה) > Clouds (עננים).

    ב-macOS, עוברים אל IntelliJ IDEA > העדפות > Build, Execution, Deployment (בנייה, הפעלה, פריסה) > Clouds (עננים).

  2. בוחרים את השרת (App Engine) ולוחצים על סימן המינוס (-) בחלק העליון של החלון כדי להסיר אותו.

  3. לוחצים על OK.

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

  • אם עדיין לא עשיתם את זה, אתם יכולים להוסיף את הפרויקט ל-Cloud Source Repositories.

פנייה לתמיכה

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