משימות ומאפיינים של App Engine Gradle Plugin

אחרי שמוסיפים את App Engine Gradle plugin לפרויקט, אפשר להשתמש במשימות Gradle ספציפיות ל-App Engine באפליקציית Java 8:

משימה	תיאור
`tasks`	הצגת מידע עזרה על משימות מותקנות.
`appengineStage`	יוצר ספריית אפליקציות לפריסה.
`appengineDeploy`	מבצעת staging ופריסה של אפליקציה ב-App Engine.
`appengineDeployCron`	פריסת קובץ הגדרה `cron.yaml` ב-App Engine.
`appengineDeployDispatch`	פריסת קובץ הגדרות `dispatch.yaml` ב-App Engine.
`appengineDeployDos`	פריסת קובץ הגדרה `dos.yaml` ב-App Engine.
`appengineDeployIndex`	פריסת קובץ הגדרות `index.yaml` ב-App Engine.
`appengineDeployQueue`	פריסת קובץ הגדרה `queue.yaml` ב-App Engine.
`jettyRun`	מפעיל את שרת הפיתוח באמצעות הגדרות ברירת המחדל של Jetty. מידע נוסף על הפלאגין Gretty זמין במאמרים Gretty Configuration ו-Gretty Tasks.

כדי לראות רשימה של כל המשימות:

gradle tasks

מידע נוסף על הגדרה ושימוש ב-Gradle זמין במאמר שימוש ב-App Engine Gradle ובמאגר app-gradle-plugin ב-GitHub.

מאפייני המשימה

התוכן של הקובץ gradle.build הוא קבוצה של כללים לתיאור הבנייה. הוא כתוב בשפה ספציפית לדומיין לתיאור של מבנים, על סמך שפת Groovy.

לכל משימה יש מאפיינים משויכים שמופיעים בהמשך ואפשר להשתמש בהם. אפשר לציין את המאפיינים האלה בקובץ gradle.build באמצעות סגירת הגדרות, משימה ומאפיינים.

בדוגמה הבאה אפשר לראות איך מציינים משימות Gradle ל-Java 8. למידע נוסף על שימוש בגרסאות חדשות יותר, אפשר לעיין במאמר בנושא Java runtime לגרסה 11 ואילך של Java.

בדוגמה הזו:

התאריך שבו ההגדרה של הפלאגין תיסגר הוא appengine.
המשימה היא deploy.
המאפיינים stopPreviousVersion ו-promote מוגדרים כ-true.

appengine {
  deploy {   // deploy configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = true              // default - & make this the current version
  }
}

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

  appengine.deploy.stopPreviousVersion = true

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

appengineStage

task(stage)

יוצר ספריית אפליקציות לפריסה. בשימוש במשימה appengineDeploy ובמשימה jettyRun.

אפשר להשתמש במאפיינים הבאים:

מאפיין (property)	תיאור
`artifact`	ארטיפקט בנוי שמכיל את כל המחלקות, המשאבים והמניפסטים. ברירת המחדל היא `build/libs/[YOUR_SERVLET].war`.
`appEngineDirectory`	המיקום של קובץ `app.yaml`. ברירת המחדל היא `src/main/appengine`.
`dockerDirectory`	המיקום של `Dockerfile`. ברירת המחדל היא `src/main/docker`.
`stagingDirectory`	חובה. הספרייה שאליה האפליקציה תועבר. ברירת המחדל היא `build/staged-app`.

appengineDeploy

task(deploy)

מבצעת staging ופריסה של אפליקציה ב-App Engine.

בדוגמה הבאה:

התאריך שבו הפלאגין יפסיק לפעול הוא appengine.
המשימה היא run.
הנכס port מוגדר כ-8080.

appengine {  // App Engine tasks configuration
  run {      // local (dev_appserver) configuration (standard environments only)
    port = 8080                 // default
  }

  deploy {   // deploy configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = true              // default - & make this the current version
  }
}